Dépannage

Activer Cloud Logging pour votre agent

Activez Cloud Logging pour votre agent. C'est essentiel pour capturer des données et diagnostiquer les problèmes dans les conversations réelles.

Collecter les ID de conversation

En cas de comportement inattendu, collectez les ID de conversation Dialogflow. Ces ID, disponibles dans l'historique des conversations, permettent de suivre le chemin d'exécution d'une conversation et d'examiner des interactions spécifiques.

L'appel d'API obtient un refus d'autorisation

Problème

Réponse PERMISSION_DENIED reçue pour l'appel d'API.

Solution

Assurez-vous d'avoir correctement configuré l'authentification et les rôles (Dialogflow CX, Dialogflow ES). Assurez-vous en particulier d'avoir effectué les opérations suivantes :

• Vous avez créé un compte de service et ne l'avez pas accidentellement supprimé.
• Vous avez attribué au compte de service un rôle qui lui permet d'appeler la méthode choisie.
• Vous avez téléchargé le fichier de clé privée du compte de service.
• Définissez la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS sur le fichier de clé privée.

L'appel d'API mentionne un projet inconnu

Problème

Erreur Dialogflow API has not been used in project 32555940559 reçue pour l'appel d'API.

Solution

Assurez-vous d'avoir effectué les opérations suivantes :

• Définissez la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS (voir PERMISSION_DENIED).
• Vous avez fourni l'ID du projet correct à l'appel d'API.

L'appel d'API obtient une erreur d'identifiants d'authentification non valides

Problème

Réponse Request had invalid authentication credentials. Expected OAuth 2 access token, login cookie or other valid authentication credential. reçue pour l'appel d'API.

Solution

Cela peut être dû à la création manuelle d'identifiants avec votre bibliothèque cliente tout en spécifiant une région autre que celle par défaut. Pour obtenir des conseils, consultez l'une des sections suivantes :

• Sélectionner une région avec l'API (Dialogflow CX)
• Sélectionner une région avec l'API (Dialogflow ES)

La réponse à l'appel d'API demande de passer à un autre hôte

Problème

Réponse Please switch to 'REGION-dialogflow.googleapis.com' to access resources located in 'REGION' reçue pour l'appel d'API, où REGION est un identifiant de la région spécifique.

Solution

Cela se produit lorsque vous spécifiez la région dans la requête, mais pas le point de terminaison. Pour obtenir des conseils, consultez l'une des sections suivantes :

• Sélectionner une région avec l'API (Dialogflow CX)
• Sélectionner une région avec l'API (Dialogflow ES)

Champs manquants dans la réponse à l'appel d'API

Problème

Certains champs sont manquants dans la réponse de l'API.

Solution

Si vous attendez une valeur numérique pour un champ spécifique dans la réponse de l'API, il est possible que ce champ soit absent de la réponse si la valeur renvoyée est 0.

Pour en savoir plus sur le comportement des valeurs par défaut (y compris les valeurs non numériques), consultez les pages suivantes :

• Tampons de protocole (Dialogflow CX)
• Tampons de protocole (Dialogflow ES)

Impossible de supprimer le projet en raison du privilège

Problème

Lorsque vous essayez de supprimer un projet Google Cloud , vous recevez une notification indiquant que le projet ne peut pas être supprimé, car il comporte des privilèges, et l'un d'eux est lié à Dialogflow ES.

Solution

1. Assurez-vous que vous n'avez plus besoin de l'agent Dialogflow ES associé au projet. Si vous recevez une notification indiquant que l'agent n'existe pas, cela signifie qu'il a déjà été supprimé.

   Console Dialogflow ES

   Ouvrez https://dialogflow.cloud.google.com/#/agent/project-id/intents.

   Notez que ce lien est différent de celui de la boîte de dialogue de suppression du projet Google Cloud .

   API Dialogflow

   Utilisez la méthode search du type agent.

2. Obtenez le nom du privilège.

   gcloud

   Exécutez la commande gcloud alpha resource-manager liens list, comme décrit dans la documentation Répertorier les privilèges d'un projet.

   API Explorer

   Utilisez le panneau Essayer cette API sur la page Méthode : liens.list :

   • Renseignez le champ parent, comme indiqué dans la description du paramètre.
   • Cliquez sur Exécuter.

3. Supprimez le privilège.

   gcloud

   Utilisez la commande gcloud alpha resource-manager liens delete LIEN_NAME, comme décrit dans la documentationSupprimer les privilèges d'un projet.

   API Explorer

   Utilisez le panneau Essayer cette API sur la page Méthode : liens.delete :

   • Renseignez le champ name avec le nom du privilège que vous avez obtenu à l'étape 2.
   • Cliquez sur Exécuter.

4. Arrêtez le projet.

Échec du webhook Dialogflow CX avec une erreur de délai d'expiration dépassé

Problème

Un webhook appelé depuis Dialogflow CX peut échouer avec le message d'erreur suivant :

Webhook call failed. Error: DEADLINE_EXCEEDED

Cela peut se produire lorsque l'appel de webhook dépasse le délai avant expiration du webhook. Voici les raisons possibles pour lesquelles l'appel de webhook dépasse le délai avant expiration :

• Tentative de déclenchement d'un intent inexistant.
• Un problème de démarrage à froid avec le backend du webhook (par exemple, Cloud Functions).
• Le webhook appelle d'autres services, ce qui augmente le temps de réponse.
• Aucune connexion entre l'agent et le backend du webhook (par exemple, un équilibreur de charge mal configuré).
• Règle d'administration empêchant l'exécution du trafic entrant ou des méthodes Dialogflow.

Solution

Par défaut, un webhook a un délai avant expiration de cinq secondes. Vous pouvez augmenter la limite de délai avant expiration du webhook lorsque vous créez ou modifiez la ressource de webhook, ce qui laisse plus de temps au webhook pour répondre.

La console ne parvient pas à configurer le projet

Problème

Erreur Failed to set up GCP project reçue lors de la création d'un agent avec la console.

Solution

Vous ne disposez peut-être pas des autorisations nécessaires pour créer des projets Google Cloud . Vérifiez si vous pouvez créer un projet Google Cloud directement depuis la console. Si vous ne parvenez pas à créer un projet, suivez les recommandations fournies dans le message d'erreur.

Référence du paramètre de session affichée dans la réponse

Problème

Les réponses renvoyées par Dialogflow incluent les références des paramètres au lieu de leurs valeurs. Exemple :
Hello, $session.params.customer_name

Les paramètres ne seront pas résolus et la référence du paramètre s'affichera si le paramètre est introuvable dans la session en cours ou s'il n'est pas utilisé conformément à son type.

Solution

Ce problème peut se produire si le paramètre utilisé n'est pas inclus dans la conversation, s'il comporte une faute de frappe ou s'il est d'un type différent de celui utilisé.

La console ne parvient pas à créer un agent lorsque l'API n'a pas été activée

Problème

Erreur Dialogflow API has not been enabled for the project. Code: FAILED_PRECONDITION reçue lors de la création d'un agent avec la console.

Solution

Suivez les étapes de configuration pour activer l'API Dialogflow.

Lors de la tentative d'accès à la console depuis un compte d'organisation, une erreur de service s'est produite

Problème

Vous avez reçu une erreur You don't have access to this service lorsque vous avez tenté d'accéder à la console depuis le compte de votre organisation.

Solution

Contactez l'administrateur système de votre organisation et vérifiez que les paramètres de votre organisation permettent d'accéder à la console. Sinon, vérifiez si votre compte migré depuis une autre organisation a été signalé comme limité par Google. C'est probablement le problème si d'autres utilisateurs de votre organisation peuvent accéder à la console, mais pas vous.

Vous pouvez également contacter l'assistance pour obtenir de l'aide.

Impossible d'exporter l'agent au format JSON, car il manque un flux

Problème

L'exportation de l'agent en tant qu'octets bruts aboutit, mais l'exportation de l'agent au format JSON échoue avec un message d'erreur semblable à celui-ci :

Flow 'projects/PROJECT_ID/locations/LOCATION_ID/agents/AGENT_ID/flows/FLOW_ID' does not exist
in the agent

Ce problème peut être dû à un scénario de test faisant référence à un flux qui a été supprimé.

Solution

Pour résoudre ce problème, examinez les scénarios de test inutilisés afin de vérifier si le flux référencé dans le message d'erreur est utilisé dans l'un d'eux, puis supprimez les scénarios de test confirmés.

Connectivité de la passerelle de téléphonie

Problème

Lorsque vous utilisez une passerelle téléphonique, vous obtenez un signal d'occupation ou l'appel est interrompu.

Solution

Il existe des quotas et des limites pour cette fonctionnalité. Si vous entendez un signal d'occupation ou si l'appel est interrompu, vous avez peut-être dépassé votre quota.

Erreur RESOURCE_EXHAUSTED lors de la tentative de création d'un numéro de téléphone

Problème

Lorsque vous essayez de créer un numéro de téléphone dans Dialogflow CX, Dialogflow ES ou Agent Assist, une erreur RESOURCE_EXHAUSTED est renvoyée.

Solution

Cette erreur signifie que vous avez dépassé la limite de numéros de téléphone par projet. Pour créer un numéro de téléphone, supprimez les numéros de téléphone inutilisés associés à votre projet jusqu'à ce que vous soyez en dessous de la limite.

Si vous avez créé des numéros de téléphone dans Dialogflow CX Phone Gateway ou Dialogflow ES Phone Gateway, vous pouvez les supprimer dans la console. Notez que la suppression de l'agent sans suppression du numéro de téléphone ne supprime pas le numéro de téléphone qui lui est associé.

Vous pouvez également utiliser l'API en procédant comme suit.

Étape 1 : Identifiez tous les numéros de téléphone associés à votre projet.

Pour identifier les numéros de téléphone associés à votre projet, utilisez la méthode d'API projects.phoneNumbers/list ou projects.locations.phoneNumbers.list pour toutes les régions dans lesquelles vous avez peut-être créé des numéros de téléphone.

• Pour la région global, utilisez la commande suivante :

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/phoneNumbers
  

• Pour les autres régions, vous devez spécifier la région à deux endroits :

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/phoneNumbers
  

Étape 2 : (Facultatif) Identifier les agents associés aux profils de conversation

Obtenir l'ID de l'agent Dialogflow CX associé au numéro de téléphone via le profil de conversation peut vous aider à déterminer si l'agent est toujours utilisé et si le numéro de téléphone est toujours nécessaire. Pour ce faire, utilisez la méthode API projects.conversationProfiles/get. Vous trouverez les ID de profil de conversation dans les réponses aux commandes que vous avez exécutées à l'étape 1.

• Pour la région global, utilisez la commande suivante :

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/global/conversationProfiles/CONVERSATION_PROFILE_ID
  

• Pour les autres régions, spécifiez la région à deux endroits :

  curl -X GET \
  -H "Authorization: Bearer "$(gcloud auth print-access-token) \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json; charset=utf-8" \
  https://REGION_ID-dialogflow.googleapis.com/v2beta1/projects/PROJECT_ID/locations/REGION_ID/conversationProfiles/CONVERSATION_PROFILE_ID
  

Vous pouvez trouver l'agent par son ID dans la console Dialogflow CX à l'aide de l'option Rechercher sur la page Afficher tous les agents.

Pour Dialogflow ES, un projet ne peut être associé qu'à cinq agents au maximum, et un agent Dialogflow ES peut être associé à un numéro de téléphone. Vous pouvez donc ouvrir l'agent dans la console Dialogflow ES à l'adresse https://dialogflow.cloud.google.com/#/editAgent/PROJECT_ID/intents.

Si aucun agent n'est trouvé, vous pouvez toujours supprimer le numéro de téléphone si vous êtes sûr qu'il n'est plus nécessaire.

Étape 3 : Supprimer les numéros de téléphone inutilisés

Pour supprimer les numéros de téléphone dont vous n'avez plus besoin, utilisez la méthode d'API projects.phoneNumbers/delete ou projects.locations.phoneNumbers.delete. Vous trouverez les ID de numéro de téléphone dans la réponse aux commandes que vous avez exécutées à l'étape 1.

• Pour la région global, utilisez la commande suivante :

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

• Pour les autres régions, spécifiez la région :

  curl -X DELETE \
      -H "Authorization: Bearer "$(gcloud auth print-access-token) \
      -H "X-Goog-User-Project: PROJECT_ID" \
      -H "Content-Type: application/json; charset=utf-8" \
      https://REGION_ID-dialogflow.googleapis.com/v2beta1/PHONE_NUMBER_ID
  

Dialogflow CX Messenger sans réponse

Problème

Aucune réponse d'agent pour les interactions Dialogflow CX Messenger.

Solution

Si vous ne voyez aucune réponse de Dialogflow CX Messenger, assurez-vous que la facturation et l'API Dialogflow sont activées sur le projet. Consultez les instructions de configuration.

Valeur de paramètre mise en correspondance sans être un synonyme d'entité

Problème

• Cas général : une valeur de paramètre est extraite au moment de l'exécution, même si l'entité correspondant au paramètre ne contient pas la valeur correspondante en tant que synonyme.
• Cas plus spécifique : après la suppression d'un synonyme d'une entité et le réentraînement de l'agent, ce synonyme est toujours extrait en tant que valeur de paramètre pour cette entité.

Solution

1. Utilisez l'option de recherche pour vérifier si la valeur correspondante peut être présente dans l'agent en tant qu'entité implicite (Dialogflow CX, Dialogflow ES). Recherchez tous les intents comportant des annotations avec ce paramètre et cette entité.
2. Corrigez les annotations en vous assurant qu'aucune d'entre elles n'est appliquée au texte représentant la valeur correspondante non souhaitée.
3. Testez l'agent au moment de l'exécution pour vérifier si le problème est résolu.
4. Si le problème persiste, assurez-vous que les options Expansion automatique et Correspondance approximative sont décochées dans les paramètres d'entité avancés, puis testez à nouveau l'agent.

Le bot vocal ignore certaines réponses

Problème

Pour un agent conçu à la fois pour le texte et la voix, le bot vocal ne lit pas certaines réponses.

Solution

Si au moins une réponse de texte audio de sortie est définie pour un tour de conversation particulier, assurez-vous que l'option de texte audio de sortie est systématiquement présente dans l'ensemble des réponses de fulfillment et de webhook de l'agent à toutes les étapes de ce tour de conversation.

Les balises SSML ne prennent pas effet

Problème

Les balises SSML sont définies dans le fulfillment de l'agent, mais le bot vocal lit le texte synthétisé sans effets SSML.

Solution

Assurez-vous qu'une seule paire <speak></speak> est présente par fiche de réponse dans la console Dialogflow, ou par objet de message de réponse si les réponses sont fournies par l'API ou le webhook.

L'agent vocal prononce "zero" comme la lettre "o" en anglais

Problème

Pour un agent conçu pour la voix, l'agent vocal lit les zéros comme la lettre O au lieu de zéro.

Solution

1. Modifiez Réponse de l'agent pour utiliser l'option de dialogue de texte audio de sortie.
2. Cochez la case "SSML".
3. Entourez votre texte d'une balise SSML :

     <speak>
       <say-as interpret-as='verbatim'>YOUR_TEXT</say-as>
     </speak>

4. Enregistrer.

Par exemple, les zéros des numéros de carte de crédit seront épelés comme des zéros :

   <speak>
      <say-as interpret-as='verbatim'>5177 7702 8500 4578</say-as>
   </speak>

Prononciation synthétisée inattendue

Problème

La prononciation synthétisée des réponses de l'agent (par exemple, les noms propres, les acronymes) n'est pas celle attendue.

Solution

Pour garantir des prononciations particulières pour des mots peu connus, utilisez la balise SSML say-as ou phoneme dans les réponses de l'agent.

Nombre maximal d'étapes d'exécution de la machine d'état atteint

Problème

Vous avez reçu le message d'erreur suivant dans la console Dialogflow CX ou dans les journaux lors de l'envoi de requêtes d'exécution à l'agent :

You have reached the maximum allowed state machine execution steps. You may consider simplifying your agent/flow design. Current execution steps are: [<array_of_objects>]

Le tableau du message d'erreur contient une liste des étapes d'exécution de la requête. La liste peut être incomplète si le nombre d'étapes est trop élevé.

Solution

Ce message d'erreur indique généralement que le nombre de transitions pour un seul tour de conversation est trop élevé. Un exemple courant est la transition vers la même page, ce qui crée une boucle infinie.

Pour résoudre ce problème :

1. Copiez le tableau JSON qui figure dans le message d'erreur.
2. (Facultatif) Mettez en forme le tableau copié au format JSON pour une meilleure lisibilité. Si le message d'erreur est tronqué, recherchez le dernier objet "Step", supprimez l'objet d'étape incomplet et la virgule précédente, puis ajoutez un crochet de fermeture avant de valider et d'embellir le JSON.
3. Examinez les valeurs "TriggeredTransitionRouteId" et "TargetPage" pour chaque étape. Dans le cas d'une boucle infinie, les champs "TriggeredTransitionRouteId" et "TargetPage" ont des valeurs répétées pour la plupart des étapes.
4. Modifiez la conception de votre agent pour supprimer les transitions de boucle infinie ou réduire le nombre de transitions pour un seul tour de conversation.

La correspondance d'expression régulière est trop large

Problème

Vous avez reçu une erreur Regular expression match is too broad lors de la création d'une entité d'expression régulière (Dialogflow CX, Dialogflow ES).

Solution

Envisagez l'approche suivante :

• Utilisez ^ et $ dans l'expression régulière pour indiquer respectivement le début et la fin du texte.
• Utilisez l'entité d'expression régulière avec un paramètre obligatoire (Dialogflow CX, Dialogflow ES).
• Définissez les invites de paramètres requises pour demander à l'utilisateur final de ne fournir que la valeur de l'entité, sans aucun mot environnant.

Caractères non alphanumériques indésirables insérés par la reconnaissance vocale

Problème

Lorsque vous essayez de faire correspondre des caractères alphanumériques, des caractères non alphanumériques indésirables (espaces, tirets, etc.) sont insérés par l'outil de reconnaissance vocale, ce qui empêche la correspondance de l'entité.

Solution

1. Si vous utilisez des entités système pour la mise en correspondance des nombres, envisagez d'utiliser des entités d'expression régulière (Dialogflow CX, Dialogflow ES) à la place.
2. Suivez toutes les recommandations de la section Reconnaissance vocale alphanumérique inexacte par les entités d'expression régulière.
3. Pour la mise en correspondance des numéros à l'aide d'intégrations de téléphonie, envisagez une option DTMF, en plus de la reconnaissance vocale.

Transcriptions vides pour les entrées vocales

Problème

Les réponses Dialogflow aux entrées vocales renvoient des transcriptions vides. Les requêtes sont traitées comme des événements "no-input" ou "no-match".

Solution

Écoutez l'enregistrement audio pour vérifier qu'il contient des paroles.

Assurez-vous que l'adaptation vocale est activée dans les paramètres de l'agent (Dialogflow CX, Dialogflow ES).

Si l'activation de l'adaptation vocale ne vous aide pas, testez les modèles vocaux suivants dans une configuration hors production et utilisez celui qui donne les meilleurs résultats :

• latest_short
• phone_call
• command_and_search

Pour les langues autres que l'anglais, consultez les modèles de reconnaissance vocale compatibles dans la documentation sur les langues compatibles avec Speech-to-Text.

La méthode de spécification d'un modèle de reconnaissance vocale dépend de la façon dont vous configurez les interactions avec Dialogflow.

• Pour les requêtes API, indiquez le nom du modèle dans le champ model de InputAudioConfig (Dialogflow CX, Dialogflow ES).

• Si vous utilisez Phone Gateway (Dialogflow CX, Dialogflow ES), vous pouvez mettre à jour le modèle de reconnaissance vocale dans le profil de conversation créé par Dialogflow lorsque vous avez activé l'intégration :

  1. Récupérez l'ID du profil de conversation :

     • Utilisez la méthode conversationProfiles.list pour récupérer tous les profils de conversation associés à votre projet.
     • Recherchez le profil de conversation que vous souhaitez mettre à jour, puis copiez la valeur du champ name.

     Pour Dialogflow CX Phone Gateway, le nom à afficher du profil de conversation se trouve dans les paramètres d'intégration. Pour Dialogflow ES Phone Gateway, le nom à afficher du profil de conversation correspond au nom de l'agent dans lequel l'intégration a été activée.

     Si vous avez plusieurs profils de conversation avec le même nom à afficher, vérifiez l'ID de l'agent dans le champ automatedAgentConfig de la réponse de la méthode conversationProfiles.list.

  2. Utilisez la méthode d'API conversationProfiles.patch pour mettre à jour le champ model dans SpeechToTextConfig.

• Pour les intégrations Contact Center AI, contactez votre intégrateur de téléphonie pour savoir comment mettre à jour le modèle de reconnaissance vocale pour l'intégration ou pour des requêtes individuelles.

Comprendre les erreurs de boucle de playbook

Problème

Lors de l'association de playbooks, vous rencontrez l'erreur Playbook <playbookID> caused loop in playbook routes.

Solution

Une boucle peut se produire si vous tentez d'effectuer un routage vers un playbook "ancêtre", c'est-à-dire un playbook qui a appelé directement ou indirectement le playbook actuel. Pour résoudre ce problème, vérifiez que le routage de votre playbook est unidirectionnel et ne revient pas à un playbook parent dans le même parcours de conversation.

Erreur d'écran vide "La taille du fichier dépasse 2 Mo" lors de la comparaison des versions d'agent

Problème

Lorsque vous essayez de comparer deux versions d'agent différentes, l'écran devient vide et le message d'erreur suivant s'affiche :

File size exceeds 2MB

Ce problème est dû au fait que l'un des fichiers dépasse 2 Mo.

Solution

Pour comparer des versions d'agent dont l'un des fichiers dépasse 2 Mo, il est recommandé d'utiliser la méthode d'API compareVersion.

Reconnaissance vocale alphanumérique inexacte par les entités d'expression régulière

Problème

Réception de transcriptions inexactes pour les entrées vocales de caractères alphanumériques conçues pour correspondre à une entité d'expression régulière (Dialogflow CX, Dialogflow ES).

Solution

1. Assurez-vous que l'adaptation vocale est activée dans les paramètres de l'agent (Dialogflow CX, Dialogflow ES).
2. Assurez-vous qu'au moins une entrée d'entité respecte toutes les exigences d'entrée d'expression régulière (Dialogflow CX, Dialogflow ES).
3. Pour des modèles spécifiques, utilisez les expressions régulières les plus spécifiques. Par exemple, pour une valeur alphanumérique commençant par deux lettres suivies de cinq chiffres, utilisez [a-zA-Z]{2}\d{5} au lieu de [a-zA-Z0-9]{7}.
4. Assurez-vous que votre entité d'expression régulière permet de faire correspondre des caractères non alphanumériques (espaces, tirets, etc.) qui peuvent être insérés par l'outil de reconnaissance vocale. Pour répondre à l'exigence 2 de cette liste, créez plusieurs entrées d'entité : une entrée pour répondre à l'exigence 2 de cette liste et une autre pour prendre en compte les caractères non alphanumériques. Par exemple, pour faire correspondre cinq chiffres et autoriser les caractères non alphanumériques :

    \d{5}
    (\d[^a-zA-Z0-9]*){5}
   

5. Assurez-vous que votre agent respecte les exigences de définition des paramètres (Dialogflow CX, Dialogflow ES).

   Exemple pour Dialogflow CX

   

   Exemple pour Dialogflow ES

   
6. Assurez-vous que votre agent respecte les exigences d'annotation des expressions d'entraînement (Dialogflow CX, Dialogflow ES).

   Exemple pour Dialogflow ES

   
7. Assurez-vous que vos tests respectent les consignes de test (Dialogflow CX, Dialogflow ES).
8. Pour supprimer les caractères non alphanumériques qui ont pu être insérés par l'outil de reconnaissance vocale, utilisez la commande suivante :
   • Pour Dialogflow CX : fonction système SUBSTITUTE ou webhook
   • Pour Dialogflow ES : webhook
9. Vérifiez les limites de l'adaptation vocale (Dialogflow CX, Dialogflow ES).

Concevoir des conversations contrôlées

Créez votre agent avec des parcours de conversation clairement définis. Assurez-vous que l'agent peut demander les informations nécessaires pour répondre aux exigences de l'utilisateur. Évitez les champs d'application conversationnels trop larges, qui peuvent entraîner un comportement imprévisible.

Analyser des journaux

Les entrées et sorties des playbooks, des outils et des datastores sont capturées dans les journaux. Utilisez les ID de conversation collectés pour suivre la chaîne d'appels et identifier l'endroit où l'exécution a échoué.

Tester le prompting

Si un ensemble d'instructions spécifique ne fonctionne pas comme prévu, essayez de le reformuler. Vous pouvez également utiliser Gemini pour générer des prompts (meta-prompting). Cette approche itérative peut vous aider à trouver la formulation optimale pour votre cas d'utilisation.

Fournir des informations complètes à l'assistance

Lorsque vous ouvrez une demande d'assistance auprès de l'assistance Cloud, incluez les ID de conversation et les journaux pertinents collectés lors de votre investigation. Ces informations sont essentielles pour déboguer efficacement les problèmes.