Agents

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) traduisent le texte ou l'audio de l'utilisateur final au cours d'une conversation à des données structurées compréhensibles par vos applis et services. Vous concevez et créez un agent conversationnel (Dialogflow CX) pour gérer les types de conversations nécessaires à votre système.

Un agent Conversational Agents (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

Remarque :Vous pouvez créer plusieurs agents Conversational Agents (Dialogflow CX) pour un seul agent. Projet Google Cloud.

Pour créer un agent, procédez comme suit :

Console

1. Ouvrez la console Dialogflow CX.
2. Créez ou sélectionnez un projet Google Cloud.
3. Cliquez sur Create Agent (Créer un agent).
4. 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.
5. Remplissez le formulaire pour les paramètres de base de l'agent :
   1. Vous pouvez choisir n'importe quel nom à afficher.
   2. Sélectionnez votre lieu préféré. Cliquez sur le bouton Modifier si vous souhaitez modifier les paramètres de localisation avancés.
   3. Sélectionnez le fuseau horaire de votre choix.
   4. 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.
6. 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 à l'aide de l'API.

Pour créer un agent, consultez la méthode create pour le type Agent. Accéder à la documentation de référence de l'API 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

Fermer

Données des agents

Les agents Conversational Agent (Dialogflow CX) servent de conteneurs de premier niveau pour les paramètres et les données des agents virtuels.

Pour accéder aux données d'un agent :

Console

1. Ouvrez la console Dialogflow CX.
2. Choisissez le projet Google Cloud pour l'agent.
3. Recherchez l'agent dans la liste.
4. Cliquez sur le nom à afficher de l'agent.
5. 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 :

• Intents
• Types d'entités
• Webhook
• Flux
• Pages
• Groupes de routes

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, et restaurez un agent avec ce fichier.

Une exportation d'agent inclut toutes les données de l'agent, à l'exception des éléments suivants :

• Versions de Flow: Seuls les brouillons de flux sont exportés dans un fichier.
• Environnements: Les environnements personnalisés ne sont pas exportés dans le fichier.

Une restauration d'agent écrase toutes les données de l'agent cible (y compris toutes les versions de flux), à l'exception des suivantes:

• 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. Cependant, ces versions de flux obsolètes ne sont pas répertoriées ni sélectionnables versions de flux 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 à d'autres agents de data store existants, car l'agent qui en résulte doit également d'une association avec une application d'agents Vertex AI.

• 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 pour restaurer un agent contenant des références de data store. Si vous essayez de le faire, cela donne des résultats dans un message d'erreur. Pour résoudre ce problème, vous pouvez soit créer un agent de data store en partant de zéro. (Vous pouvez également vous pouvez transformer votre agent existant en agent de data store en ajoutant un data store gestionnaire d'état avec lui. Dans ce cas, nous vous guiderons pour ajouter une application associée à votre agent.)
  • Si l'agent cible est associé à une application, l'ensemble du data store les références sont mises à jour lors de la restauration: leur ID de projet Google Cloud et la position sera mise à jour pour correspondre à l'application de l'agent cible. L'ID de la collection et l'ID du datastore ne changent pas. Cela signifie que vous ajouter des data stores pour tous les identifiants ayant des types correspondants 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 l'application de l'agent cible est nommée projects/321/locations/us-east1/collections/default_collections/engines/app123, alors la référence du data store résultante dans l'agent cible se présentera comme suit: projects/321/locations/us-east1/collections/default_collection/dataStores/myDataStore1

Remarque : Dans l'API et dans le contenu des données exportées, une application d'agent Vertex AI est appelée "GenAppBuilder Engine". Pour exemple dans un package JSON exporté, vous pouvez trouver le nom du moteur dans agent.json sous la clé genAppBuilderSettings.engine.

Lors de l'exportation, vous pouvez sélectionner le format de fichier d'exportation. Si vous utilisez la gestion des versions pour vos données d'agent, vous devez Exporter au format JSON. Lorsque vous restaurez un agent, Les agents conversationnels (Dialogflow CX) déterminent automatiquement le format de fichier.

Pour exporter ou restaurer un agent :

Console

1. Ouvrez la console Dialogflow CX.
2. Choisissez le projet Google Cloud pour l'agent.
3. Cliquez sur le menu Option d'un agent dans la liste.
4. Cliquez sur le bouton Exporter ou Restaurer.
5. Suivez les instructions pour terminer.

Remarque : Pour restaurer un agent de magasin de données, assurez-vous que l'agent cible a été créé en tant qu'agent de magasin de données.

API

Consultez les méthodes export et restore pour le type Agent. Accéder à la documentation de référence de l'API 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

Fermer

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 Guide d'exportation/restauration GitHub

Supprimer un agent

Attention : La suppression d'un agent ne peut pas être annulée. Exportez l'agent pour en conserver une sauvegarde si nécessaire.

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

1. Ouvrez la console Dialogflow CX.
2. Choisissez le projet Google Cloud pour l'agent.
3. Cliquez sur le menu Option d'un agent dans la liste.
4. Cliquez sur le bouton Supprimer .
5. Confirmez la suppression dans la boîte de dialogue.

API

Consultez la méthode delete pour le type Agent. Accéder à la documentation de référence de l'API 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

Fermer

Si vous supprimez votre projet, tous les agents conversationnels (Dialogflow CX) et les données associés au projet sont supprimés immédiatement.