Dépannage

Filtrez le contenu de ce document en fonction du tag de type d'agent :

Tous Agents de conversation (Dialogflow CX) Dialogflow ES

Filtrez le contenu de ce document en fonction du tag de catégorie :

Tous API Console Auth Projet Intégration NLU Expression régulière Conversion vocale Conversion texte-voix Exécution IA générative

Activer Cloud Logging pour votre agent

Activez Cloud Logging pour votre agent. Cela est essentiel pour collecter 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, qui se trouvent 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

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: API, Auth

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 (Agents de conversation (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 souhaitée.
• Vous avez téléchargé le fichier de clé privée du compte de service.
• Vous avez défini la variable d'environnement GOOGLE_APPLICATION_CREDENTIALS sur le fichier de clé privée.

L'appel d'API mentionne un projet inconnu

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: API, Projet

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 de projet correct à l'appel d'API.

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

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: API, Auth

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 (agents conversationnels (Dialogflow CX))
• Sélectionner une région avec l'API (Dialogflow ES)

La réponse à l'appel d'API demande un changement d'hôte

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: API, Auth

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 ID de 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 (agents conversationnels (Dialogflow CX))
• Sélectionner une région avec l'API (Dialogflow ES)

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

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: 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, le champ peut être 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 (agents de conversation (Dialogflow CX))
• Protocol Buffers (Dialogflow ES)

Impossible de supprimer le projet en raison du privilège

Tags de type d'agent: Dialogflow ES
Tags de catégorie: Projet

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 diffère 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 :

   • 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 erreur "Délai dépassé"

Tags de type d'agent: Agents de conversation (Dialogflow CX)
Tags de catégorie: Runtime

Problème

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

Webhook call failed. Error: DEADLINE_EXCEEDED

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

1. Tentative de déclenchement d'un intent inexistant.

2. Problème de démarrage à froid avec le backend du webhook (par exemple, Cloud Functions).

3. Le webhook appelle d'autres services, ce qui augmente le temps de réponse.

4. Aucune connexion entre l'agent et le backend du webhook (par exemple, un équilibreur de charge mal configuré).

5. Règle d'administration empêchant l'exécution du trafic entrant ou des méthodes Dialogflow.

Solution

Par défaut, un webhook est soumis à 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 laisse plus de temps pour répondre.

La console ne parvient pas à configurer le projet

Tags de type d'agent: Dialogflow ES
Tags de catégorie: Console, 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 n'êtes peut-être pas autorisé à créer des projets Google Cloud. Vérifiez si vous pouvez créer un projet Google Cloud directement à partir de la console Google Cloud. 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

Tags de type d'agent: Agents de conversation (Dialogflow CX)
Tags de catégorie: Console

Problème

Les réponses renvoyées par Dialogflow incluent les références de paramètre au lieu des valeurs des paramètres. 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 n'est pas trouvé 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'a pas été 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

Tags de type d'agent: Agents de conversation (Dialogflow CX)
Tags de catégorie: Console

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 lorsque vous essayez d'accéder à la console à partir du compte de l'organisation

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: Console

Problème

Erreur You don't have access to this service reçue lors de la tentative d'accès à la console à partir de votre compte d'organisation.

Solution

Contactez l'administrateur système de votre organisation et vérifiez que les paramètres de votre organisation vous permettent d'accéder à la console.

Si les paramètres de votre organisation devraient autoriser l'accès et que vous avez migré votre compte depuis une autre organisation, il est possible que Google l'ait signalé comme étant limité. C'est probablement le problème si d'autres utilisateurs de votre organisation peuvent accéder à la console, mais pas vous. Contactez l'assistance pour obtenir de l'aide.

Impossible d'exporter l'agent au format JSON en raison d'un flux manquant

Tags de type d'agent: Agents de conversation (Dialogflow CX)
Tags de catégorie: Console

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 causé par un cas de test qui fait référence à un flux qui a été supprimé.

Solution

Pour résoudre ce problème, explorez les cas de test inutilisés pour vérifier si le flux référencé dans le message d'erreur est utilisé dans un cas de test. Supprimez ensuite les scénarios de test confirmés.

Connectivité de la passerelle de téléphonie

Tags de type d'agent: Dialogflow ES
Tags de catégorie: Intégration

Problème

Lorsque vous utilisez la passerelle du téléphone, 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

Tags de type d'agent: Agents conversationnels (Dialogflow CX), Dialogflow ES
Tags de catégorie: Intégration

Problème

Lorsque vous essayez de créer un numéro de téléphone dans Conversational Agents (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 la passerelle de téléphonie des agents conversationnels (Dialogflow CX) ou la passerelle de téléphonie Dialogflow ES, vous pouvez les supprimer dans la console. Notez que supprimer l'agent sans supprimer le numéro de téléphone ne le supprime pas.

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 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 Conversational Agents (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 des agents de conversation (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 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 des numéros de téléphone qui ne sont plus nécessaires, utilisez la méthode 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

Tags de type d'agent: Agents conversationnels (Dialogflow CX)
Tags de catégorie: Intégration

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.

La valeur du paramètre correspond, mais n'est pas un synonyme d'entité

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: NLU

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 la réinitialisation 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 (Agents de conversation (Dialogflow CX), Dialogflow ES). Recherchez tous les intents 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 floue ne sont pas cochées dans les paramètres avancés des entités, puis testez à nouveau l'agent.

Le bot vocal ignore certaines réponses

Tags de type d'agent: Agents de conversation (Dialogflow CX)
Tags de catégorie: Conversion texte-parole

Problème

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

Solution

Si au moins une réponse texte audio de sortie est définie pour un tour de conversation particulier, assurez-vous que l'option de texte audio de sortie est présente de manière cohérente dans toutes 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

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: Conversion texte-parole

Problème

Les balises SSML sont définies dans l'exécution 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 carte de réponse dans la console Dialogflow ou par objet de message de réponse si les réponses sont fournies via l'API ou le webhook.

L'agent vocal prononce le chiffre 0 comme la lettre O

Tags de type d'agent: Agents de conversation (Dialogflow CX)
Tags de catégorie: Conversion texte-parole

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 Agent says (L'agent dit) par Output audio text dialogue option (Option de sortie de la boîte de dialogue de texte audio).
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 orthographiés.

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

Prononciation synthétisée inattendue

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: Conversion texte-parole

Problème

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

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.

Vous avez atteint le nombre maximal d'étapes d'exécution de la machine à états autorisé.

Tags de type d'agent: Agents de conversation (Dialogflow CX)
Tags de catégorie: Runtime

Problème

Vous avez reçu le message d'erreur suivant dans la console des agents de conversation (Dialogflow CX) ou dans les journaux lorsque vous avez envoyé 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 une liste des étapes d'exécution de la requête. La liste peut être incomplète si le nombre d'étapes est trop important.

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 à partir du message d'erreur.
2. (Facultatif) Formatez le tableau copié au format JSON pour améliorer la lisibilité. Si le message d'erreur est tronqué, recherchez le dernier objet "Étape", supprimez l'objet d'étape incomplet et la virgule précédente, puis ajoutez une parenthèse de fermeture de tableau avant de valider et d'embellir le fichier JSON.
3. Examinez les valeurs "TriggeredTransitionRouteId" et "TargetPage" pour chaque étape. En cas de boucle infinie, les champs "TriggeredTransitionRouteId" et "TargetPage" ont des valeurs répétitives 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

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: Expression régulière

Problème

Erreur Regular expression match is too broad reçue lors de la création d'une entité regexp (Agents conversationnels (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é regexp avec un paramètre obligatoire (Agents conversationnels (Dialogflow CX), Dialogflow ES).
• Définissez les invites de paramètre requises pour demander à l'utilisateur final de ne fournir que la valeur de l'entité, sans les mots environnants.

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

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: Conversion 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 entraîne une non-correspondance de l'entité.

Solution

1. Si vous utilisez des entités système pour faire correspondre des numéros, envisagez d'utiliser des entités regexp (Agents conversationnels (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 les numéros correspondants via les intégrations de téléphonie, envisagez une option DTMF en plus de la reconnaissance vocale.

Transcriptions vides pour les entrées vocales

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: Conversion vocale

Problème

Les réponses Dialogflow pour les entrées vocales renvoient des transcriptions vides. Les requêtes sont traitées comme des entrées ou des correspondances manquantes.

Solution

Écoutez l'enregistrement audio pour vous assurer qu'il contient des conversations.

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

Si l'activation de l'adaptation vocale ne résout pas le problème, testez les modèles vocaux suivants dans une configuration hors production et utilisez celui qui génère les meilleurs résultats:

• latest_short
• phone_call
• command_and_search

Pour les langues autres que l'anglais, consultez les modèles vocaux compatibles dans la documentation sur les langues acceptées avec Speech-to-Text.

La manière de spécifier un modèle de synthèse 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 (Agents conversationnels (Dialogflow CX), Dialogflow ES).

• Si vous utilisez la passerelle de téléphonie (Agents conversationnels (Dialogflow CX), Dialogflow ES), vous pouvez mettre à jour le modèle de synthèse 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 modifier, puis copiez la valeur du champ name.

     Pour la passerelle de téléphonie Dialogflow CX, 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 vous disposez de plusieurs profils de conversation portant 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 de Contact Center AI, demandez à votre intégrateur de téléphonie comment mettre à jour le modèle de synthèse vocale pour l'intégration ou pour des demandes individuelles.

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

Tags de type d'agent: Agents de conversation (Dialogflow CX)
Tags de catégorie: Console

Problème

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

File size exceeds 2MB

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

Solution

Pour comparer les versions d'agent lorsque l'un des fichiers dépasse 2 Mo, nous vous recommandons d'utiliser la méthode d'API compareVersion.

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

Tags de type d'agent: Agents de conversation (Dialogflow CX), Dialogflow ES
Tags de catégorie: Reconnaissance vocale, Expression régulière

Problème

Transcriptions inexactes reçues pour les entrées vocales alphanumériques conçues pour être mises en correspondance avec une entité regexp (Agents conversationnels (Dialogflow CX), Dialogflow ES).

Solution

1. Assurez-vous que l'adaptation de la parole est activée dans les paramètres de l'agent (Agents de conversation (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 (Agents conversationnels (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 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 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és : une 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 (Agents de conversation (Dialogflow CX), Dialogflow ES).

   Exemple pour les agents de conversation (Dialogflow CX)

   

   Exemple pour Dialogflow ES

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

   Exemple pour Dialogflow ES

   
7. Assurez-vous que vos tests respectent les consignes de test (Agents conversationnels (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 la commande suivante :
   • Pour les agents de conversation (Dialogflow CX): fonction système SUBSTITUTE ou webhook
   • Pour Dialogflow ES: webhook
9. Vérifiez les limites de l'adaptation de la parole (Agents conversationnels (Dialogflow CX), Dialogflow ES).

Concevoir pour 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 d'application de la conversation trop large, car cela peut entraîner un comportement imprévisible.

Analyser les journaux

Les entrées et les 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 le point d'échec de l'exécution.

Tester les requêtes

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 requêtes (méto-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 déboguer efficacement les problèmes.