En temps normal, vous créez et supprimez des agents à l'aide de la console. Toutefois, dans certains scénarios avancés, il peut s'avérer plus simple d'utiliser l'API.
Créer un agent
Les exemples suivants montrent comment appeler la méthode Create
pour le type Agent
.
Sélectionnez un protocole et une version pour la référence de l'agent :
Protocole | V3 | V3beta1 |
---|---|---|
REST | Ressource de l'agent | Ressource de l'agent |
RPC | Interface de l'agent | Interface de l'agent |
C++ | AgentsClient | Non disponible |
C# | AgentsClient | Non disponible |
Go | AgentsClient | Non disponible |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Non disponible | Non disponible |
Python | AgentsClient | AgentsClient |
Ruby | Non disponible | Non disponible |
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- REGION_ID : votre ID de région
Méthode HTTP et URL :
POST https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents
Corps JSON de la requête :
{ "displayName": "My display name", "defaultLanguageCode": "en", "timeZone": "America/New_York" }
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir une réponse JSON de ce type :
{ "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
Pour vous authentifier auprès de Dialogflow, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour vous authentifier auprès de Dialogflow, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour vous authentifier auprès de Dialogflow, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Supprimer un agent
Les exemples suivants montrent comment appeler la méthode Delete
pour le type Agent
.
Sélectionnez un protocole et une version pour la référence de l'agent :
Protocole | V3 | V3beta1 |
---|---|---|
REST | Ressource de l'agent | Ressource de l'agent |
RPC | Interface de l'agent | Interface de l'agent |
C++ | AgentsClient | Non disponible |
C# | AgentsClient | Non disponible |
Go | AgentsClient | Non disponible |
Java | AgentsClient | AgentsClient |
Node.js | AgentsClient | AgentsClient |
PHP | Non disponible | Non disponible |
Python | AgentsClient | AgentsClient |
Ruby | Non disponible | Non disponible |
REST
Avant d'utiliser les données de requête ci-dessous, effectuez les remplacements suivants :
- PROJECT_ID : ID de votre projet Google Cloud
- REGION_ID : votre ID de région
- AGENT_ID: votre ID d'agent, indiqué dans la réponse de création de l'agent
Méthode HTTP et URL :
DELETE https://REGION_ID-dialogflow.googleapis.com/v3/projects/PROJECT_ID/locations/REGION_ID/agents/AGENT_ID
Pour envoyer votre requête, développez l'une des options suivantes :
Vous devriez recevoir un code d'état indiquant le succès de l'opération (2xx), ainsi qu'une réponse vide.