Configurer l'Action TextBotExchange

L'action TextBotExchange envoie les messages du contact à AI Agents (Cognigy) et reçoit les réponses du bot. Elle fournit également des variables de sortie et des conditions de branchement que votre script utilise pour déterminer la suite des opérations. Configurez les propriétés de l'action comme décrit dans cette tâche.

Autorisations requises : Studio script, Affichage, Création/Modification

  1. Dans le script Studio, cliquez sur Actions Icon of a square, triangle, and circle together. dans le panneau de droite.

  2. Développer la catégorie Web Editor URL.

  3. Faire glisser l'Action TextBotExchange sur le canevas du script. Placez-la après l'Action qui collecte la saisie du contact.

  4. Si votre script nécessite plus qu'un tour, ajoutez une seconde TextBotExchange action et connectez-la à la boucle de conversation. Un minimum de deux TextBotExchange action est requis pour la plupart des implémentations.

  5. Avant la première TextBotExchange action, ajoutez une Snippet action et configurez-la avec le Bot Session State code d'Extrait. Cet extrait initialise la variable botSessionState qui conserve le contexte de la conversation d'un tour à l'autre.

Propriétés de saisie

Sélectionnez l'action TextBotExchange et configurez les propriétés de saisie suivantes dans le panneau Propriétés. Utilisez le tableau ci-dessous pour comprendre chaque propriété :

Propriété

Valeur ou FORMAT acceptable

Description

Légende Étiquette courte et descriptive. Exemple : TextBotExchange_CognigyStart Identifie cette action spécifique sur le canevas Studio. La valeur par défaut est « TEXTBOT EXCHANGE ». Entrez une légende unique lorsque votre script contient plus d'une TextBotExchange action.
Id de l’agent virtuel Renseigné automatiquement après avoir attribué le bot dans le Virtual Agent Hub. La valeur correspond au nom de l'Agent virtuel (bot) issu de Virtual Agent Hub.

Identifie la configuration Virtual Agent Hub à utiliser. Ce champ est renseigné automatiquement lorsque vous attribuez le bot à l'action dans Virtual Agent Hub. Vous pouvez remplacer cette valeur en utilisant une variable Studio, par exemple {virtualAgentId}, si vous avez besoin de sélectionner dynamiquement la configuration du bot au moment de l'exécution. Cette approche est couramment utilisée lors de la commutation entre plusieurs configurations de bot.

Intention automatisée Chaîne Standard : Bienvenue. Utilisée uniquement lors du premier tour.

Déclenche une intention spécifique dans AI Agents (Cognigy) au lieu d'envoyer la saisie tapée par le contact. Ce champ peut être utilisé pour appeler des intentions prédéfinies telles que Welcome ou toute autre intention prise en charge par le bot. Bien qu'il soit couramment utilisé lors du premier tour pour déclencher un message de bienvenue, il peut également être utilisé lors des tours suivants pour appeler d'autres intentions de manière dynamique. Laissez ce champ vide lorsque vous souhaitez transmettre le message réel du contact à la place.

Saisie utilisateur Studio variable qui contient le message saisi par le contact. Exemple : {customerMessage} Le message texte saisi par le contact, transmis à AI Agents (Cognigy) pour la reconnaissance d'intention et la génération de réponse. Au premier tour, ce champ peut être vide si AutomatedIntent est défini sur Welcome. À chaque tour suivant, ce champ doit contenir le dernier énoncé du contact.
Charge utile personnalisée Objet JSON converti en chaîne. Exemple : {customPayload.asJSON()}. En option. Transmet les données contextuelles personnalisées du script Studio à AI Agents (Cognigy). Les exemples incluent le nom du contact, l'ID du compte ou les données CRM. Vous devez définir la charge utile personnalisée dans une action Extrait. N'utilisez pas cette propriété si vous devez traiter des données que l’agent virtuel renvoie au script. Utilisez plutôt la variable customPayloadVarName (sortie).
État de session du robot Variable renseignée par botSessionStateVarName (out) du tour précédent. Exemple : {botState} Conserve le contexte de la conversation au fil des tours en renvoyant un identifiant de session à AI Agents (Cognigy) à chaque demande. AI Agents (Cognigy) crée cet identifiant au premier tour. À chaque tour suivant, le script doit transmettre la valeur stockée dans N'utilisez pas cette propriété si vous devez traiter des données que l'agent virtuel renvoie au script. Utilisez plutôt la variable customPayloadVarName (sortant) dans ce champ. Si vous ne configurez pas cela correctement, AI Agents (Cognigy) crée une nouvelle session à chaque tour et perd le contexte.

Propriétés de sortie

Les propriétés de sortie suivantes sont disponibles après l'exécution de l'action TextBotExchange. Référencez ces variables dans les actions suivantes de votre script.

Propriété

Valeur ou FORMAT acceptable

Nom DE variable d'invite suivante (sortie) Contient les paramètres de comportement qui contrôlent la manière dont NiCE CXone invite le contact au prochain tour conversationnel. Cette variable peut être modifiée dans une action Snippet avant le prochain appel TextBotExchange pour personnaliser le comportement par tour.
Nom de la variable de charge utile personnalisée (sortie)

Renvoie des données JSON personnalisées de AI Agents (Cognigy) vers le script Studio. Utilisez cette propriété pour traiter les données d'exécution ou les instructions de routage envoyées par AI Agents (Cognigy). Les valeurs courantes incluent :

  • escalat ou tout intention commençant par escalat, telle que « escalate » ou « escalation » — Achemine le contact vers un Agent en direct. Le script Studio détecte ce préfixe afin de gérer l'escalade de manière fiable, quels que soient les noms d'intention de bot différents.

  • end — L'interaction se termine. Le script Studio utilise cette valeur pour terminer proprement la session de contact.

Ne confondez pas cela avec la propriété de saisie charge utile personnalisée.

Nom DE variable des Détails de l'erreur (sortie) Contient des informations sur l'erreur lorsque la branche En cas d'erreur est empruntée. Inspectez cette variable dans la branche En cas d'erreur pour consigner ou gérer l'erreur. La variable système _ERR est également renseignée avec une description condensée de l'erreur.
Nom DE variable des informations d'intention (sortie) Contient des détails sur l'intention identifiée par AI Agents (Cognigy) pour le tour actuel. Utilisez cette variable dans votre script pour consigner les données d'intention ou prendre des décisions de routage en fonction de l'intention identifiée.
Nom de la variable d'état de session du bot (sortie) Contient l'identifiant d'état de session renvoyé par AI Agents (Cognigy) après chaque tour. Vous devez transmettre la valeur de cette variable dans la propriété de saisie botSessionState du tour suivant pour conserver le contexte de la conversation. Cette propriété est requise pour le bon fonctionnement de l'opération.