Dépannage

Activer Cloud Logging pour votre agent

Activez Cloud Logging pour votre agent. C'est essentiel pour capturer des données et diagnostiquer des problèmes dans des 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 accorde l'autorisation 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 :

• Vous avez défini 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

Il manque certains champs dans la réponse de l'API.

Solution

Si vous vous attendez à une valeur numérique pour un champ spécifique dans la réponse de l'API, il est possible que le 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 ressources suivantes :

• Protocol buffers (Dialogflow CX)
• Protocol Buffers (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 contient des privilèges, et l'un des privilèges est associé à Dialogflow ES.

Solution

1. Assurez-vous de ne plus avoir 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 qui figure dans 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 :

   • Dans le champ name, indiquez 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épassé

Problème

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

Webhook call failed. Error: DEADLINE_EXCEEDED

Cela peut se produire si l'appel de webhook dépasse la limite de délai d'attente du webhook. Voici quelques raisons possibles pour lesquelles l'appel de webhook peut dépasser la limite de 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, é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 d'inactivité du webhook lorsque vous créez ou modifiez la ressource de webhook, ce qui lui donnera plus de temps 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 à partir de la console. Si vous ne parvenez pas à créer un projet, suivez les recommandations fournies dans le message d'erreur.

Référence des paramètres de session affichée dans la réponse

Problème

Les réponses renvoyées par Dialogflow incluent les références de paramètres au lieu de leurs valeurs. Par 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 actuelle ou s'il n'est pas utilisé en fonction de son type.

Solution

Ce problème peut survenir si le paramètre utilisé n'est pas inclus dans la conversation, s'il contient 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.

Erreur de service reçue lors de la tentative d'accès à la console depuis un compte d'organisation

Problème

Erreur You don't have access to this service reçue lors de la tentative d'accès à la console depuis votre compte d'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 restreint 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 en raison d'un flux manquant

Problème

L'exportation de l'agent en tant qu'octets bruts se termine correctement, mais l'exportation de l'agent au format JSON échoue et un message d'erreur semblable à celui-ci s'affiche :

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, explorez les cas de test inutilisés afin de vérifier si le flux référencé dans le message d'erreur est utilisé dans des cas de test, puis supprimez les cas de test confirmés.

Connectivité de la passerelle de téléphonie

Problème

Lorsque vous utilisez une passerelle téléphonique, vous recevez un signal de ligne occupée ou l'appel est interrompu.

Solution

Il existe des quotas et des limites pour cette fonctionnalité. Si la ligne est occupée ou que l'appel est interrompu, vous avez peut-être dépassé votre quota.

Erreur RESOURCE_EXHAUSTED lors de la 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 s'affiche.

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 la passerelle de téléphonie Dialogflow CX ou la passerelle de téléphonie Dialogflow ES, vous pouvez les supprimer dans la console. Notez que la suppression de l'agent sans suppression du numéro de téléphone n'entraîne pas la suppression du 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) Identifiez 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 d'API projects.conversationProfiles/get. Vous trouverez les ID des profils 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 en utilisant l'option Rechercher sur la page Afficher tous les agents.

Pour Dialogflow ES, un projet ne peut être associé qu'à cinq agents maximum, et un agent Dialogflow ES ne peut être associé qu'à un seul numéro de téléphone. Vous pouvez donc ouvrir l'agent dans la console Dialogflow ES via 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 des numéros 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 est activée pour le projet et que l'API Dialogflow est activée pour le projet. Consultez les instructions de configuration.

Valeur de paramètre correspondante, mais qui n'est pas 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 Rechercher pour vérifier si la valeur correspondante peut être présente dans l'agent en tant qu'entité implicite (Dialogflow CX, Dialogflow ES). Trouvez toutes les intentions qui comportent des annotations avec ce paramètre et cette entité.
2. Corrigez les annotations en vous assurant qu'aucune d'elles n'est appliquée au texte représentant la valeur correspondante indésirable.
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 avancés des entités, puis testez à nouveau l'agent.

Le robot 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 output audio text est définie pour un tour de conversation spécifique, assurez-vous que l'option output audio text est toujours présente dans les réponses de traitement 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 traitement de l'agent, mais le robot vocal lit le texte synthétisé sans les 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 "zéro" comme la lettre "o"

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. Remplacez L'agent dit par l'option de dialogue "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 écrits en toutes lettres :

   <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 et les acronymes) ne correspond pas aux attentes.

Solution

Pour garantir une prononciation spécifique pour les mots peu connus, utilisez les balises SSML say-as ou phoneme dans les réponses de l'agent.

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

Problème

Le message d'erreur suivant s'affiche dans la console Dialogflow CX ou dans les journaux lorsque vous envoyez des 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 la 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, qui crée une boucle infinie.

Pour résoudre ce problème :

1. Copiez le tableau JSON à partir du message d'erreur.
2. (Facultatif) Mettez en forme le tableau copié en tant que 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 de tableau avant de valider et de mettre en forme le JSON.
3. Examinez les valeurs "TriggeredTransitionRouteId" et "TargetPage" pour chaque étape. En cas de boucle infinie, les champs "TriggeredTransitionRouteId" et "TargetPage" contiennent des valeurs répétées pour la plupart des étapes.
4. Modifiez la conception de votre agent pour supprimer les transitions en 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

Erreur Regular expression match is too broad reçue 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ètre requises pour demander à l'utilisateur final de fournir uniquement 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 le système de reconnaissance vocale, ce qui empêche l'entité d'être mise en correspondance.

Solution

1. Si vous utilisez des entités système pour faire correspondre des nombres, envisagez d'utiliser plutôt des entités d'expression régulière (Dialogflow CX, Dialogflow ES).
2. Suivez toutes les recommandations de la section Reconnaissance vocale alphanumérique inexacte par les entités d'expression régulière.
3. Pour faire correspondre 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 saisies vocales

Problème

Les réponses Dialogflow pour les entrées vocales renvoient des transcriptions vides. Les requêtes sont traitées comme des absences d'entrée ou de correspondance.

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 non destinée à la 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 la documentation Langues acceptées par Speech-to-Text pour trouver les modèles vocaux compatibles.

La façon de spécifier un modèle vocal 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 vocal 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 modifier, 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 la passerelle de téléphonie Dialogflow ES, le nom à afficher du profil de conversation correspond au nom de l'agent dans lequel l'intégration a été activée.

     Si plusieurs profils de conversation portent le même nom à afficher, vérifiez l'ID de l'agent dans le champ automatedAgentConfig de la réponse à 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 vocal pour l'intégration ou pour les demandes individuelles.

Comprendre les erreurs de boucle de playbook

Problème

Vous rencontrez l'erreur Playbook <playbookID> caused loop in playbook routes lorsque vous associez des playbooks.

Solution

Une boucle peut se produire si vous tentez de rediriger vers un playbook "ancêtre", c'est-à-dire un playbook qui a appelé directement ou indirectement celui en cours. 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 chemin 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û à la taille d'un des fichiers, qui 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 inexacte des caractères alphanumériques par les entités d'expression régulière

Problème

Transcriptions inexactes reçues pour les entrées vocales 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 concernant les entrées d'expressions régulières (Dialogflow CX, Dialogflow ES).
3. Pour des modèles spécifiques, utilisez les expressions régulières les plus spécifiques. Par exemple, pour un code alphanumérique qui commence 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 les caractères non alphanumériques (espaces, tirets, etc.) qui peuvent être insérés par le système de reconnaissance vocale. Pour répondre à l'exigence 2 de cette liste, créez plusieurs entrées d'entité : une pour répondre à l'exigence 2 de cette liste et une autre pour tenir compte des 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 concernant l'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 le système de reconnaissance vocale, utilisez les éléments suivants :
   • 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 chemins de conversation clairement définis. Assurez-vous que l'agent peut demander les informations nécessaires pour répondre aux exigences des utilisateurs. Évitez un champ de conversation trop large, car cela peut entraîner un comportement imprévisible.

Analyser des journaux

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

Tester les requêtes

Si un ensemble d'instructions spécifiques ne fonctionne pas comme prévu, essayez de le reformuler. Vous pouvez également utiliser Gemini pour générer des requêtes (méta-requêtes). 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 enquête. Ces informations sont essentielles pour résoudre efficacement les problèmes.