Un agent Conversational Agents (Dialogflow CX) est un agent virtuel qui gère les conversations simultanées avec vos utilisateurs finaux. Il s'agit d'un module de compréhension du langage naturel qui saisit les nuances du langage humain. Les agents conversationnels (Dialogflow CX) convertissent le contenu texte ou audio de l'utilisateur final pendant une conversation en données structurées compréhensibles par vos applications et services. Vous pouvez créer un agent Conversational Agents (Dialogflow CX) conçu pour gérer les types de conversations requis pour votre système.
Un agent de conversation (Dialogflow CX) est comparable à un agent humain de centre d'appels. L'un comme l'autre doivent apprendre à gérer les scénarios de conversation attendus, sans qu'il soit nécessaire de leur dispenser un entraînement/une formation trop explicite.
Créer un agent
Pour créer un agent, procédez comme suit :
Console
- Ouvrez la console Dialogflow CX.
- Créez ou sélectionnez un projet Google Cloud.
- Cliquez sur Create Agent (Créer un agent).
- Sélectionnez Générer automatiquement pour créer un agent de data store ou Créer le vôtre pour créer d'autres types d'agents.
- Remplissez le formulaire pour les paramètres de base de l'agent :
- Vous pouvez choisir n'importe quel nom à afficher.
- Sélectionnez votre lieu préféré. Cliquez sur le bouton Modifier si vous souhaitez modifier les paramètres de localisation avancés.
- Sélectionnez le fuseau horaire de votre choix.
- Sélectionnez la langue par défaut de votre agent. Une fois l'agent créé, vous ne pouvez plus modifier la langue par défaut.
- Cliquez sur Enregistrer.
API
Si vous n'avez pas encore configuré les paramètres de localisation pour votre projet, vous devez les configurer avec la console avant de créer des agents avec l'API. Actuellement, vous ne pouvez pas configurer les paramètres de localisation avec l'API.
Pour créer un agent, consultez 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 |
Données des agents
Les agents de conversation (Dialogflow CX) servent de conteneurs de niveau supérieur pour les paramètres et les données des agents virtuels.
Pour accéder aux données d'un agent :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez le projet Google Cloud pour l'agent.
- Recherchez l'agent dans la liste.
- Cliquez sur le nom à afficher de l'agent.
- Mettez à jour les flux, les pages, et plus, comme décrit dans d'autres guides.
API
Consultez les guides relatifs aux données que vous souhaitez mettre à jour.
Les données suivantes sont associées aux agents :
Pour en savoir plus sur l'application des données à différents niveaux, consultez les niveaux d'application des données.
Exporter et restaurer un agent
Vous pouvez exporter un agent vers un fichier, puis le restaurer à l'aide de ce fichier.
Une exportation d'agent inclut toutes les données de l'agent, à l'exception des éléments suivants:
- Versions de flux : seuls les flux brouillons sont exportés vers un fichier.
- Environnements : les environnements personnalisés ne sont pas exportés vers un fichier.
La restauration d'un agent écrase toutes les données de l'agent cible (y compris toutes les versions de flux), à l'exception des éléments suivants:
- Environnements : tous les environnements personnalisés restent inchangés dans l'agent cible. Les versions de flux référencées par des environnements personnalisés dans l'agent cible continueront d'exister tant que les environnements associés existeront. Toutefois, ces versions de flux obsolètes ne sont pas répertoriées ni sélectionnables pour l'agent.
- Applications Vertex AI Agents : l'association à une application Vertex AI Agents reste inchangée dans l'agent cible. (en d'autres termes, la valeur de
engine
dans GenAppBuilderSettings). Cela signifie que les agents de data store ne peuvent être restaurés que dans d'autres agents de data store existants, car l'agent généré doit également être associé à une application Vertex AI Agents. Data stores des agents Vertex AI : toutes les références aux data stores seront écrasées dans l'agent cible conformément aux règles suivantes:
- Si l'agent cible n'est pas associé à une application, il est impossible de restaurer un agent contenant des références de data store. Toute tentative de désactivation entraîne un message d'erreur. Pour résoudre ce problème, vous pouvez créer un agent de data store à partir de zéro. Vous pouvez également transformer votre agent existant en agent de data store en y ajoutant un gestionnaire d'état de data store. Dans ce cas, vous serez guidé pour ajouter une application associée à votre agent.)
- Si l'agent cible est associé à une application, toutes les références de data store sont mises à jour lors de la restauration: leur ID de projet Google Cloud et leur emplacement sont mis à jour pour correspondre à l'application de l'agent cible. L'ID de la collection et l'ID du data store ne changent pas. Cela signifie que vous devez ajouter des magasins de données pour tous les ID dont les types correspondent dans l'application de l'agent cible avant l'opération de restauration.
Exemple: si l'agent source fait référence à un data store nommé
projects/123/locations/eu-west2/collections/default_collection/dataStores/myDataStore1
et que l'application de l'agent cible est nomméeprojects/321/locations/us-east1/collections/default_collections/engines/app123
, la référence de l'data store résultante dans l'agent cible devient :projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1
Lors de l'exportation, vous pouvez sélectionner le format de fichier d'exportation. Si vous utilisez le contrôle des versions pour vos données d'agent, vous devez exporter au format JSON. Lorsque vous restaurez un agent, les agents de conversation (Dialogflow CX) déterminent automatiquement le format de fichier.
Pour exporter ou restaurer un agent :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez le projet Google Cloud pour l'agent.
- Cliquez sur le menu Option more_vert d'un agent dans la liste.
- Cliquez sur le bouton Exporter ou Restaurer.
- Suivez les instructions pour terminer.
API
Consultez les méthodes export
et restore
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 |
Si la taille de l'agent dépasse la limite maximale, utilisez l'option Cloud Storage pour l'exportation et la restauration de l'agent.
Si vous utilisez GitHub, consultez également le guide d'exportation/restauration GitHub.
Supprimer un agent
Pour supprimer un agent, vous devez disposer d'un rôle doté d'un accès complet ou d'un accès en modification. Pour en savoir plus, consultez le guide du contrôle des accès.
Pour supprimer un agent, procédez comme suit :
Console
- Ouvrez la console Dialogflow CX.
- Choisissez le projet Google Cloud pour l'agent.
- Cliquez sur le menu Option more_vert d'un agent dans la liste.
- Cliquez sur le bouton Supprimer delete.
- Confirmez la suppression dans la boîte de dialogue.
API
Consultez 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 |
Si vous supprimez votre projet, tous les agents conversationnels (Dialogflow CX) et les données associés au projet sont supprimés immédiatement.