Agents

Un agent 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. Dialogflow CX traduit les contenus texte ou audio produits par l'utilisateur final au cours d'une conversation en données structurées assimilables par vos applications et vos services. Vous pouvez créer un agent Dialogflow CX conçu pour gérer les types de conversations requis pour votre système.

Un agent 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

  1. Ouvrez la console Dialogflow CX.
  2. Créez ou choisissez un projet.
  3. Cliquez sur Create agent (Créer un agent).
  4. Sélectionnez Générer automatiquement pour créer un agent de datastore ou sélectionnez Créer votre propre agent 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é. Si vous souhaitez modifier les paramètres de localisation avancés, cliquez sur le bouton Modifier.
    3. Sélectionnez le fuseau horaire de votre choix.
    4. Sélectionnez la langue par défaut de votre agent. Vous ne pouvez pas modifier la langue par défaut d'un agent une fois qu'il a été créé.
  6. Cliquez sur Enregistrer.

API

Si vous n'avez pas encore configuré les paramètres de localisation de votre projet, vous devez les configurer avec la console avant de créer des agents avec l'API. 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 d'agent Ressource d'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 Dialogflow CX servent de conteneurs de premier niveau pour les paramètres et les données des agents virtuels. Les données suivantes sont associées aux agents :

Pour en savoir plus sur la façon dont les données sont appliquées à différents niveaux, consultez Niveaux d'application des données.

Détection intelligente des points de terminaison

Speech-to-Text (STT) est une API qui convertit l'audio en texte à l'aide du machine learning, ce qui vous permet d'intégrer la reconnaissance vocale à vos applications. Les modèles STT compatibles incluent tous les modèles de format long (par exemple, phone_call). Seule la langue en-US est acceptée.

Si la détection intelligente de fin de phrase est activée pour l'agent, vous pouvez personnaliser son comportement pour un paramètre numérique en définissant le délai d'attente pour spécifier le temps supplémentaire. Dialogflow CX attendra ensuite que l'utilisateur fournisse une entrée supplémentaire.

Le délai d'attente est un délai de grâce qui vous permet d'ajouter un élément à la transcription STT avant que le délai d'expiration de la parole ne soit déclenché. Dialogflow CX utilise des heuristiques pour spécifier le délai avant expiration à choisir en fonction de la transcription. Par exemple, il peut choisir un délai avant expiration très court si l'intent a été mis en correspondance avec succès. Si l'intent n'a pas été mis en correspondance, il peut augmenter le délai avant expiration pour vous permettre de dire autre chose, puis réessayer de mettre en correspondance l'intent.

Voici d'autres fonctionnalités de STT :

  • Détection plus rapide des points de terminaison : l'analyse en temps réel utilise le streaming de transcription audio pour distinguer une pause naturelle de la fin d'un énoncé, tandis que le flux STT reste ouvert. Si l'utilisateur a fini de parler, Dialogflow CX met fin au flux plus tôt pour fournir une réponse plus rapide.
  • Feedback conversationnel naturel : si l'utilisateur fait une pause au milieu d'une phrase, Dialogflow CX peut prolonger de manière dynamique le délai avant expiration de la reconnaissance vocale pour éviter les interruptions prématurées ou injecter des signaux de confirmation naturels (par exemple, "mm hmm", "uh huh") pour confirmer que l'agent virtuel est toujours à l'écoute.

Exporter et restaurer un agent

Vous pouvez exporter un agent vers un fichier et restaurer un agent avec ce fichier.

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

  • Versions de flux : seules les versions de flux utilisées dans l'environnement sélectionné sont exportées vers un fichier.
  • Environnements : les environnements autres que celui sélectionné 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 listées ni sélectionnables pour l'agent.
  • Applications Agents Vertex AI : l'association à une application Agents Vertex AI reste inchangée dans l'agent cible (c'est-à-dire 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 obtenu doit également être associé à une application Vertex AI Agents.
  • Datastores des agents IA Vertex AI : toutes les références aux datastores seront écrasées dans l'agent cible, conformément aux règles suivantes :

    • Si l'agent cible n'est pas associé à une application, il n'est pas possible d'y restaurer un agent avec des références de data store. Si vous essayez de le faire, un message d'erreur s'affiche. Pour résoudre ce problème, vous pouvez créer un data store datastore à partir de zéro. (Vous pouvez également transformer votre agent existant en agent de data store en lui 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 seront mises à jour lors de la restauration : l'ID de projet et l'emplacement Google Cloud seront mis à jour pour correspondre à l'application de l'agent cible. L'ID de la collection et l'ID du data store resteront inchangés. Cela signifie que vous devez ajouter des datastores pour tous les ID avec 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 que l'application de l'agent cible est nommée projects/321/locations/us-east1/collections/default_collections/engines/app123, la référence au data store obtenue 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 la gestion des versions du code source pour les données de votre agent, vous devez exporter au format JSON. Lorsque vous restaurez un agent, Dialogflow CX détermine automatiquement le format de fichier.

Pour exporter ou restaurer un agent :

Console

  1. Ouvrez la console Dialogflow CX.
  2. Choisissez le projet pour l'agent.
  3. Sélectionnez l'option de menu pour un agent de la liste.
  4. Cliquez sur le bouton Exporter ou Restaurer.
  5. 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 d'agent Ressource d'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/de restauration GitHub.

Supprimer un agent

Pour supprimer un agent, vous devez disposer d'un rôle qui fournit un accès complet ou 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 pour l'agent.
  3. Sélectionnez l'option de menu pour un agent de la liste.
  4. Cliquez sur le bouton .
  5. 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 d'agent Ressource d'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 Dialogflow CX et les données associées au projet sont immédiatement supprimés.