Extrait d'état de session du bot
Les informations sur cette page d’aide concernent à la fois Studio et Desktop Studio.
L'extrait Bot Session State est requis dans votre script lorsque vous utilisez des actions disposant de la propriété botSessionState. Cela inclut des actions telles que Textbot Exchange et Voicebot Exchange (ci-après, les deux actions sont simplement désignées par Exchange). La propriété botSessionState doit être configurée correctement pour que vos agents virtuels
A software application that handles customer interactions in place of a live human agent. fonctionnent comme prévu. Pour ce faire, vous devez créer cet extrait dans votre script et configurer les actions correctement, comme indiqué dans les sections suivantes.
La propriété botSessionState doit être configurée avec la variable qui contient l'identifiant unique de la conversation entre le contact et l'agent virtuel.Configurez avec la variable qui contient l'identifiant Il est automatiquement attribué par le fournisseur de l'agent virtuel. L'identifiant empêche la création d'une nouvelle session à chaque tour de la conversation et aide l'agent virtuel à maintenir le contexte entre les tours.
Le fournisseur crée l'identifiant au début de la conversation et le transmet au script avec la première réponse. Le script stocke l'identifiant dans la variable nommée dans la propriété botSessionStateVarName (out) de l'action ExchangeLe fournisseur crée l'identifiant au début de la conversation et le transmet au script avec la première réponse. Le script stocke l'identifiant dans la variable nommée dans la propriété botSessionStateVarName (out) de cette action. Enfin, le script transmet l'identifiant du tour précédent depuis la propriété botSessionStateVarName (out) vers la propriété botSessionState.
Vos scripts ne doivent jamais écrire dans cette propriété ou sa variable. Votre script doit être
Cet extrait est obligatoire, sauf si vous utilisez Google Dialogflow CX, où vous pouvez définir un ID de conversation personnalisé dans l'extrait Charge utile personnalisée qui remplit la même fonction que l'extrait Bot Session State. Un ID de conversation personnalisé est utilisé lors du transfert de contacts d'une instance CX Dialogflow à une autre. Si vous n'utilisez aucun des deux ID, un nouvel id de session est généré à chaque tour de la conversation et votre agent virtuel ne conservera pas le contexte de la conversation. Si cela se produit, aucune erreur n'est générée, mais le système ne fonctionnera pas comme prévu.
Configuration du script
Lorsque vous utilisez une action Exchange, un minimum de deux instances de l'action est nécessaire dans votre script. La propriété botSessionState de chacune des actions Exchange doit être configurée différemment :
- The first instance of the Exchange action is located right after the Begin action at the start of the script. Configure it as follows:
- botSessionState : Ce champ doit être vide.
- botSessionStateVarName (sortie): configurez avec le nom de la Variable dans laquelle vous souhaitez que le script stocke l'identifiant.
- The second Exchange action is located later in the script. Configure it as follows:
- botSessionState : configurez avec la variable utilisée dans botSessionStateVarName (out) dans la première instance de l'action Exchange. La variable doit contenir l'identifiant d'état de session du bot au format JSON.
- botSessionStateVarName (out) : configurez avec le nom de la Variable dans laquelle vous souhaitez que le script stocke l'identifiant.
- The third and any subsequent instances of the Exchange action are optional. If your script includes these instances, configure them as follows:
- botSessionState : configurez avec la variable utilisée dans botSessionStateVarName (out) dans l'instance précédente de l'action Exchange. La variable doit contenir l'identifiant d'état de session du bot au format JSON. L'identifiant de l'état de la session du bot ne change généralement pas d'un tour à l'autre. Cependant, s'il devait changer, l'action devrait être configurée pour capturer le changement.
- botSessionStateVarName (out) : Configurez avec le nom de la Variable dans laquelle vous souhaitez que le script stocke l'identifiant.
Cette configuration est requise pour tous les agents virtuels.
Vérifier que la propriété botSessionState est configurée correctement
Vous pouvez utiliser un script trace pour confirmer que cette propriété est configurée correctement.
- Exécutez une trace de script sur une interaction entre l'agent virtuel et un contact. Vous pouvez utiliser une trace ou capturer une trace d'un ANI ou DNIS spécifique (uniquement pour les interactions voix).
- Dans la fenêtre de trace, cliquez sur la ligne correspondant à la première action Virtual Agent Hub (Voicebot Exchange ou Textbot Exchange).
- Dans la liste variables, cochez la variable botSessionState. Sa valeur doit être nulle (vide).
- Dans la fenêtre de trace, cliquez sur la ligne suivante dans la trace après la première action Virtual Agent Hub.
- Note la valeur de la variable botSessionState.
- Dans la fenêtre de trace, cliquez sur la ligne de la trace qui correspond à toute action Virtual Agent Hub ultérieure.
- Vérifiez la valeur de la variable botSessionState. Elle doit être identique à celle de l'étape 5.
Convertir l'identifiant d'état de session de bot en JSON
Le contenu de la variable utilisée dans la propriété botSessionStateVarName (out) doit être converti en JSON et transmis à la propriété botSessionState de la seconde action Exchange de votre script. Pour ce faire, vous pouvez inclure du code dans une action Extrait ou configurer directement la propriété. Both approaches are acceptable. However, the benefit of creating a variable in a Snippet to hold the converted object is that it makes it easier to see where the conversion is happening.
Utiliser une action Extrait
- Configurez la propriété botSessionStateVarName (out) de l'action Exchange avec le nom de la variable devant contenir l'identifiant de l'état de la session. Par exemple, botSessionState.
-
Ajoutez la ligne suivante à un Snippet situé avant l'action Exchange dans votre script :
ASSIGN botSessionStateOut = botSessionStateOut.asJSON()Utilisez le nom de la variable que vous employez dans votre script.
- Configurez la propriété botSessionState dans l'action Exchange avec le nom de la variable que vous avez utilisée dans l'instruction ASSIGN. Par exemple, botSessionStateOut.
Convertir dans la propriété
Si vous convertissez la variable dans la propriété botSessionState, utilisez la variable botSessionStateVarName (out) avec la fonction asJSON(). Par exemple :
- botSessionStateVarName (sortant) : botSessionState
- botSessionState : botSessionState.asJSON()
Transférer des contacts d'un Agent virtuel à un autre
Pour configurer le transfert des contacts entre agents virtuels, vous devez configurer correctement les ID d'état de session du bot. Chaque agent virtuel doit avoir son propre ID d'état de session du bot unique. Cela permet à chaque agent virtuel de conserver le contexte de la conversation à laquelle il participe.
-
Agent virtuel 1 : Configurez les variables d'état de session du bot comme décrit précédemment sur cette page.
- Agent virtuel 2 : Configuré de la même manière, en utilisant une variable différente dans botSessionStateVarName (sortant) pour contenir l'ID d'état de session du bot. Assurez-vous que lors du premier appel à cet agent virtuel, la propriété botSessionState est vide. Le premier tour de la conversation renvoie un ID d'état de session de bot unique à la variable dans botSessionStateVarName (sortant).
- Tous les agents virtuels suivants : Configurez-les de la même manière que pour l'agent virtuel 2, en utilisant une Variable unique pour l'id d’état de la session du bot.
Cette méthode fonctionne pour tous les fournisseurs d'agents virtuels pris en charge, sauf si vous effectuez un transfert entre deux agents virtuels Google Dialogflow CX. Dans ce cas, une méthode différente est requise.