In genere, crei ed elimini gli agenti utilizzando la console. Tuttavia, in alcuni scenari avanzati, potresti trovare più semplice utilizzare l'API.
Crea un agente
Gli esempi riportati di seguito mostrano come chiamare il metodo Create
per il tipo Agent
.
Seleziona un protocollo e una versione per il riferimento all'agente:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa agente | Risorsa agente |
RPC | Interfaccia dell'agente | Interfaccia dell'agente |
C++ | AgentsClient | Non disponibile |
C# | AgentsClient | Non disponibile |
Vai | AgentsClient | Non disponibile |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Non disponibile | Non disponibile |
Python | AgentsClient | AgentsClient |
Ruby | Non disponibile | Non disponibile |
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo ID progetto Google Cloud
- REGION_ID: il tuo ID regione
Metodo HTTP e URL:
POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents
Corpo JSON della richiesta:
{ "displayName": "My display name", "defaultLanguageCode": "en", "timeZone": "America/New_York" }
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere una risposta JSON simile alla seguente:
{ "name": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID", "displayName": "My display name", "defaultLanguageCode": "en", "timeZone": "America/New_York", "startFlow": "projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID/flows/00000000-0000-0000-0000-000000000000", "advancedSettings": { "loggingSettings": {} } }
Java
Per autenticarti a Dialogflow, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per autenticarti a Dialogflow, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per autenticarti a Dialogflow, configura le Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Eliminare un agente
Gli esempi riportati di seguito mostrano come chiamare il metodo Delete
per il tipo Agent
.
Seleziona un protocollo e una versione per il riferimento all'agente:
Protocollo | V3 | V3beta1 |
---|---|---|
REST | Risorsa agente | Risorsa agente |
RPC | Interfaccia dell'agente | Interfaccia dell'agente |
C++ | AgentsClient | Non disponibile |
C# | AgentsClient | Non disponibile |
Vai | AgentsClient | Non disponibile |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Non disponibile | Non disponibile |
Python | AgentsClient | AgentsClient |
Ruby | Non disponibile | Non disponibile |
REST
Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:
- PROJECT_ID: il tuo ID progetto Google Cloud
- REGION_ID: il tuo ID regione
- AGENT_ID: il tuo ID agente, disponibile nella risposta alla creazione dell'agente
Metodo HTTP e URL:
DELETE https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID
Per inviare la richiesta, espandi una di queste opzioni:
Dovresti ricevere un codice di stato di operazione riuscita (2xx) e una risposta vuota.