Appelez l’action Dialogflow Bot

Conditions préalables 

Intégrations > Intégrations > Vue autorisation attribuée à tout rôle utilisateur

Utilisez l’action Call Dialogflow Bot pour exécuter des applications en libre-service dans un flux avant ou au lieu d’acheminer un client vers un agent. Utilisez cette action dans les flux d’appels entrants et sortants, ainsi que dans les flux de discussion et de messages.

Remarques:
  • Cette action est disponible dans les types de chat entrant et de flux messages.
  • Les bots Google Dialogflow qui utilisent l'intégration Google CCAI dans Genesys Cloud ne sont pas conformes aux normes PCI. Les bonnes pratiques recommandent de ne pas les utiliser dans les flux d'appels sécurisés de l'architecte.
  • Pour activer l’action Call Dialogflow Bot dans Architect, vous devez d’abord obtenir l’intégration Google Dialogflow à partir du Genesys AppFoundry. Ensuite, configurez-le dans PureCloud et créez un bot Google Dialogflow dans la console Google.
  • Vous devez avoir activé au moins une intégration Google Dialogflow active. Pour plus d’informations, voir À propos de l’intégration de Google Dialogflow.
  • Les modifications que vous apportez à un robot Google Dialogflow dans la console Google peuvent prendre quelques minutes pour apparaître dans Architect.
  • Pour activer la fonctionnalité d'intervention pour un bot Google Dialogflow, consultez Activer l'intervention pour les robots Google Dialogflow.
  • Les administrateurs peuvent utiliser n'importe quel fournisseur de synthèse vocale disponible dans les flux Architect pour une utilisation avec leurs intégrations de bots installées. Pour plus d’informations, voir A propos des moteurs text-to-speech (TTS).
  • Pour obtenir de l’aide sur la configuration de Google Dialogflow, voir À propos de l’intégration de Google Dialogflow et FAQ de Google Dialogflow.
Nom Description
Champ Nom Tapez un nom distinctif pour l’action. L’étiquette que vous entrez ici devient le nom de l’action affiché dans la séquence tâche.
Entrer le texte (agent)

Texte de la variable de chaîne à envoyer à l’agent Dialogflow. En règle générale, vous n’utilisez ce champ que lorsque vous enchaînez les actions de bot.

Note: Bot Input Text n'est valable que pour le numérique. Vous pouvez contrôler le routage initial en utilisant les variables du bot dans Architect avec des conditions dans le bot Nuance Mix. Lorsque vous mettez en œuvre ce scénario, définissez le texte d'entrée du robot comme étant "".

Délai de la réponse de suivi

Le robot Google Dialogflow peut récupérer des informations de suivi auprès de l'utilisateur. Saisissez ici le temps d’attente du bot pour la réponse de l’utilisateur.

La durée de validité est 12 heures et la valeur minimale autorisée est de 0 seconde. Le système considère un ou durée négative comme immédiate.

Remarque :   Remarque: Le suivi réponse délai s’applique à chaque client réponse. Chaque fois que le client répond et reçoit une autre invite du bot, l’délai est réinitialisé.

Par exemple, si le bot demande « Quelle est votre date préférée», il attend jusqu’à 12 heures pour une réponse client. Si le client répond avec une date dans le délai de 12 heures et que le bot répond : « Merci, avez-vous un choix alternatif», alors le flux redémarre le délai. Le flux attend encore 12 heures pour la réponse au sujet d’une autre date.

Agent Dialogflow

Le bot Dialogflow spécifique, également appelé agent, que vous souhaitez utiliser. Cette version est le bot de l’agent que vous avez créé dans la console Google.

Environnement

Sélectionnez l’environnement Google Dialogflow que vous souhaitez que le flux utilise au moment de l’exécution.

Remarque :  Un projet d’environnement est toujours disponible pour un agent Dialogflow. Si vous n’avez créé aucun environnement pour l’agent Dialogflow sélectionné, le seul environnement disponible est Draft. Sinon, une liste d’environnements publiés, en plus de Brouillon, apparaît.

Les environnements permettent à un flux de sélectionner la version d'un agent Google Dialogflow que l'architecte appelle lors de l'exécution du flux. Pour plus d'informations sur l'utilisation des environnements Google Dialogflow dans Architect, consultez Utiliser les environnements Google Dialogflow dans Architect. Pour plus d’informations sur les environnements Google Dialogflow, consultez Versions et environnements de Google Cloud.

Nom de l'événement initial

Le nom de l’événement d’agent Dialogflow à déclencher lorsque l’interaction commence.

Variables de session

Informations que vous pouvez transmettre et récupérer à partir du bot. Entrez le nom de la variable et une valeur à affecter. Vous pouvez ajouter plusieurs variables et les réorganiser.

Entrées

Dans les flux numériques, un agent Dialogflow n’utilise les variables de session d’entrée que lorsque le flux fournit un nom d’événement initial non vide. Utilisez des entrées pour transmettre des données à un agent Dialogflow. Pour chaque valeur que vous envoyez, donnez à l’entrée un nom et une expression qui se résout en une chaîne pour sa valeur. Ensuite, lorsque l’action s’exécute, toutes les expressions sont évaluées pour produire une chaîne qui passe à Dialogflow en tant que paramètres d’événement. Vous pouvez préremplir des emplacements en choisissant le nom de ce qui passe comme nom de votre emplacement, ou transmettre plus de données que vous traitez dans le webhook d’un agent webhook.

  • Nom de la clé
  • Valeur à attribuer

Sorties

Utilisez les sorties pour extraire les données de Dialogflow. Créer un contexte de sortie Dialogflow nommé "genesys-output" avec des paramètres nom-valeur. Ensuite, dans la section Sortie de l'architecte, répertoriez les noms des paramètres souhaités ainsi que les variables de l'architecte dans lesquelles stocker les valeurs correspondantes.

Remarque :  Les noms de clé sont sensibles à la casse.

  • Nom de la clé
  • Variable à attribuer
Intentions

Les options qui apparaissent dans cette section reflètent la logique configurée dans le bot Dialogflow. Chaque intention représente une action à effectuer. Par exemple, commandez une pizza ou des fleurs. Chaque chemin d’intention correspond à un chemin de sortie pour l’action Call Dialogflow Bot dans l’éditeur de tâche.

En dessous de chaque intention, Architect affiche les emplacements de bot Dialogflow configurés, ou toutes les données que l’utilisateur doit fournir pour réaliser l’intention. En prenant comme exemple l’intention de la commande de pizza, les fentes peuvent inclure le type de croûte, les ingrédients, la quantité de fromage et le style de coupe. Si l’utilisateur choisit le chemin Order Pizza, le bot Dialogflow fournit les emplacements associés à ce chemin. Quel que soit l'environnement que vous sélectionnez, l'action Appeler le bot Dialogflow affiche toujours les intentions et les emplacements du brouillon du bot Dialogflow.

Remarque :  Pour vous assurer que l’intention apparaît comme une sortie dans Architect, lorsque vous créez une intention dans Google Dialogflow, assurez-vous de la désigner comme une fin d’intention de conversation. Sinon, l’intention n’apparaît pas ici.

Probabilité d'intentions

La confiance de l’événement de fin de conversation Dialogflow détecté. Si le flux détecte l’intention, la valeur est comprise entre 0,0 et 1,0. Si le flux ne détecte pas d’intention, la valeur de la variable qui se lie à ce paramètre reste inchangée.

Sorties échouées

Sélectionnez les variables que vous souhaitez affecter aux valeurs de données d’échec renvoyées par le bot Dialogflow.

Valeur des données Variable
erreurType
  • FeatureNotEnabledError: L’action Appel de bot Dialogflow n’est pas disponible pour l’organisation.
  • Erreur Interne du Serveur: Une erreur inattendue s’est produite lors de l’action Call Dialogflow Bot. Le format de réponse reçu est généralement incorrect. Contact Service client Genesys Cloud.
  • NoInputError: L’opération Call Dialogflow Bot a expiré sans aucune entrée utilisateur.
Message d’erreur: Un message non localisé. Cette variable chaîne peut être vide ou NOT_SET.

Remarque :  Pour développer ou réduire la liste des variables, cliquez sur la flèche en regard de Échec des sorties.

Configurer les trajectoires d’intention et d’échec

Nom Description
Chemins d’intention

Le bot Google Dialgflow dicte ces chemins.

Chemin de sortie d’échec

Ce chemin indique qu’une erreur s’est produite lors de l’exécution de l’action ou qu’un problème est survenu lors du traitement des résultats.  

Remarque :  Si le réseau rencontre des problèmes de connectivité, l’action prend automatiquement cette trajectoire d’échec.

Faites glisser l’action appropriée sous le chemin d’échec et indiquez l’itinéraire que vous souhaitez que l’interaction prenne. Par exemple, une action de transfert pour envoyer l’appelant à un agent pour obtenir de l’aide.