VoiceBot Exchange

Cette page d'aide concerne Desktop Studio. Ces informations sont également disponibles pour Studio.

Icon of VoiceBot Exchange: robot head above sound waves

Intègre un agent virtuelClosed A software application that handles customer interactions in place of a live human agent. de libre-service avec des scripts vocaux. Cette action est utilisée dans une boucle dans le script. Un script doit contenir au moins deux actions VoiceBot Exchange . Votre agent virtuel doit prendre en charge cette action.

Le Voicebot Exchange action est destiné aux agents virtuels complexes ou lorsque vous devez personnaliser le comportement de l'agent virtuel d'un tour à l'autre. Il surveille la conversation entre le contact et l'agent virtuel, tour par tour. Il envoie chaque énoncéClosed What a contact says or types. transcrit à l'agent virtuel. L’agent virtuel analyse l’énoncé pour identifier l’intentionClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. et le contexte, puis détermine la réponse à donner. L’action transmet la réponse de l’agent virtuel au contact. Lorsque la conversation est terminée, l'action continue le script.

Si vous souhaitez configurer intervention ou aucune saisie, un script supplémentaire est requis.

En double-cliquant sur cette action, vous ouvrez le Virtual Agent Hub, où vous pouvez gérer tous vos agents virtuels.

Dépendances

  • Un script doit contenir au moins deux actions Échange voicebot connectées en boucle.
  • Pour utiliser cette action, votre agent virtuel doit prendre en charge la personnalisation des conversations tour par tour.
  • Un tour de conversation est défini comme suit :

    1. L'énoncé de contact est envoyé à l'agent virtuel.
    2. L'agent virtuel traite l'énoncé et définit toute information de charge utile personnalisée.
    3. La réponse revenant au contact.
    4. Toute action supplémentaire à entreprendre (telle qu'un appel à une base de données ou à une API externe) qui est déterminée dans la propriété nextPromptBehaviors. Vous pouvez également configurer la boucle conversationnelle afin de quitter lorsque l'interaction est terminée ou le si le contact est transféré à un agent humain.
  • Si vous incluez des charges utiles personnalisées au moyen d’agents virtuels Google Dialogflow ES ou Google Dialogflow CX, suivez les meilleures pratiques et les consignes relatives aux charges utiles personnalisées.Les consignes pour CX et ES sont fournies sur cette page.

Types de scripts pris en charge

L'icône du type de script Téléphone - un combiné téléphonique à l'ancienne avec des lignes courbes indiquant que le son en sort.

Téléphone

Comparaison d'actions similaires

Les actions suivantes ont des fonctions similaires, mais présentent quelques différences clé :

  • Textbot Exchange : Ce action est utilisée pour les interactions complexes de l'agent virtuel. Elle vous permet d'inclure des paramètres d'échange et de personnaliser divers aspects de la conversation entre le contact et l’agent virtuel.
  • Voicebot Exchange : Cette action est utilisée pour des interactions agent virtuel complexes. Elle vous permet d'inclure des paramètres d'échange et de personnaliser divers aspects de la conversation entre le contact et l’agent virtuel.
  • VOICEBOT STREAM : Cette action prend en charge la diffusion audio en temps réel entre NiCE CXone et le fournisseur d'agent virtuel. Elle ne prend pas en charge la personnalisation de la conversation entre les tours de parole. Actuellement, le seul agent virtuel pris en charge est Google Dialogflow CX VoiceStream.

Agents virtuels pris en charge

Cette action prend en charge les agents virtuels suivants :

Avant de pouvoir affecter un agent virtuel à cette action, vous devez ajouter et configurer une application pour l'agent virtuel dans Virtual Agent Hub. Vous n'avez besoin que d'une seule application pour chaque agent virtuel que vous utilisez. Vous pouvez affecter la même application à plusieurs actions agent virtuel dans vos Scripts. Reportez-vous à la page d'aide du fournisseur d'agent virtuel que vous utilisez pour obtenir des détails sur la configuration.

D'autres fournisseurs d'agent virtuel peuvent être pris en charge, mais nécessitent des intégrations personnalisées. Celles-ci incluent les intégrations DEVone et points de terminaison personnalisés. Les intégrations personnalisées ne sont pas configurées à l'aide de Virtual Agent Hub.

Propriétés de saisie

Ces propriétés définissent les données que l'action utilise lors de son exécution.

L'une ou plusieurs des propriétés de cette action nécessitent une action Snippet avec du code personnalisé.

Propriété

Description

Légende

Entrez une courte phrase qui identifie cette action dans le script de manière unique. La légende est affichée sur le canevas de script sous l’icône de l’action. La valeur par défaut est le nom de l’action.

virtualAgentID Nom de l'agent virtuel sélectionné dans le Virtual Agent Hub. Lorsque vous attribuez une application d'agent virtuel à une action Studio dans Virtual Agent Hub, cette propriété est automatiquement renseignée. Le nom est la valeur utilisée dans le champ Virtual Agent (Bot) Name de l'application Virtual Agent Hub. Vous pouvez utiliser la substitution de variable dans cette propriété.
customPayload

Ne configurez cette propriété que si vous devez transmettre des données de charge personnalisées à l'agent virtuel. L'objet de charge personnalisé est rempli à partir du script Studio. Vous pouvez l'utiliser pour transmettre des informations telles que le nom du contact, issu d’un CRMClosed Third-party systems that manage such things as contacts, sales information, support details, and case histories. à utiliser dans un message de bienvenue.

Entrez le nom de l'objet JSON qui transmet les données du script à l'agent virtuel. You devez définir l'objet charge utile personnalisée dans une action Extrait.L'objet doit être converti en JSON, soit dans le snippet, soit dans la propriété customPayload.

Exigences pour les fournisseurs d'agents virtuels spécifiques :

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).

nextPromptSequence

La réponse reçue de l'agent virtuel qui sera jouée pour le contact. Vous ne devez configurer cette propriété que si vous utilisez cette action pour permettre à un agent virtuel textuel de gérer des interactions vocales. Configurez cette propriété avec la variable spécifiée dans nextPromptSequenceVarName (out) avec la fonction asJSON(). You pouvez également convertir le contenu de nextPromptSequenceVarName (out) en JSON dans une action Extrait et configurez cette propriété avec la variable qui contient le JSON.

nextPromptBehaviors

Spécifie la configuration et le comportement de la prochaine invite dans une conversation. Définissez les comportements que vous souhaitez voir en utilisant un Snippet action et en suivant le Comportements de Prompt suivant par défaut ou Next Prompt Behaviors.Cet exemple décrit les propriétés que vous pouvez utiliser pour configurer le bruit de confort, la collecte Dtmf et le fait de permettre au contact de parler pendant la lecture de l'audio (intervention).

Configure the nextPromptBehavior property with the name of the object you used in the snippet code. This passes settings to this property and its action. For example, using the Next Prompt Behavior snippet example, you would enter {nextPromptBehaviorsOutjson} for this property. You only need to configure this property if using this action to enable a text virtual agent to handle voice interactions.

botSessionState

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 Configure with the variable that holds the unique pour la conversation entre le contact et l'agent virtuel. 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 configuré correctement pour utiliser l'identifiant d'état de session du bot.

automatedIntent

Entrez une intention spécifique par nom à laquelle l’agent virtuel doit répondre, plutôt que de laisser l’agent virtuel interpréter les entrées utilisateur collectées. Un cas d'usage courant consiste à obtenir le message d'accueil initial de l'agent virtuel. Accueillir est la chaîne standard pour les salutations initiales.

Propriétés de sortie

Ces propriétés contiennent des variables qui stockent les données renvoyées par l'exécution de l'action. Elles sont disponibles à des fins de référence et d’utilisation lorsque l'action est terminée.

Propriété

Description

nextPromptBehaviorsVarName (sortant) /snippets/OutputVars/nextPromptBehaviorsVarName.flsnp
nextPromptSequenceVarName (sortie)

Retient la réponse de l'agent virtuel et la transmet à la propriété nextPromptSequence.

customPayloadVarName (out)

Renvoie les données JSON personnalisées de l'agent virtuel au script. Utilisez cette variable lorsque vous souhaitez que le script traite les données fournies par l’agent virtuel Peut contenir des données d'exécution.

Si vous souhaitez fournir des données à l'agent virtuel, utilisez la propriété customPayload.

errorDetailsVarName (sortie)

Invite la séquence d'intention d'erreur ; peut conduire à un transfert vers un agent en direct.

intentInfoVarName (sortie)

Une variable qui contient les détails de l’agent virtuel indiquant l'intention actuelle de l'utilisateur.

botSessionStateVarName (sortant)

Contient la variable dans laquelle le script stocke l’identifiant d’état de session du robot envoyé par le fournisseur de l'agent virtuel. Le contenu du Variable est transmis à la propriété botSessionState.

Cette propriété doit être configurée correctement pour que votre agent virtuel fonctionne comme prévu. Plus d'informations sur Extrait d'état de session de bot.

Conditions de la branche résultat

Les conditions de branche de résultat vous permettent de créer des branches dans votre script afin de gérer différents résultats lors de l'exécution d'une action.

Condition

Description

Par défaut Path taken unless the script meets a condition that requires it to take one of the other branches. It is also taken if the action's other branches are not defined.
OnPromptAndCollectNextResponse \n

Chemin suivi si l'agent virtuel a déterminé que l'interaction doit continuer et qu'elle est prête pour une saisie humaine supplémentaire du contact. demande le tour suivant de la conversation.

\n
En cas d'erreur Path taken when there is an unexpected problem (for example, poor connectivity, syntax errors, and so forth). The _ERR variable should be populated with a condensed explanation of the problem.
OnReturnControlToScript Chemin emprunté si l’agent virtuel a indiqué que la conversation était terminée et redonne le contrôle au script Studio afin de transférer ou terminer l'appel. Il peut y avoir des données d'exécution à traiter dans lecustomPayload résultat.
OnDTMFBreakout

Chemin emprunté lorsqu'une règle DTMFClosed Signaling tones that are generated when a contact presses a key on the telephone keypad. dans le script a été respectée.

OnUserInputTimeout

Chemin suivi lorsqu'il n'y a pas de réponse de l'utilisateur dans le délai spécifié dans l'extrait Comportement de Prompt Default ou Next.

Pour Google Dialogflow, vous pouvez configurer l'événement que vous souhaitez voir se produire dans l'application Virtual Agent Hub Dialogflow. Pour Dialogflow ES, configurez le champ Événement DE délai d’attente. Pour DialogflowCX, configurez le Gestionnaire d'événements de délai d'attente. Si aucun Événement n'est configuré, la valeur par défaut consiste à utiliser l'intention de secours par défaut telle que configurée dans la console Dialogflow.

Si vous le souhaitez, vous pouvez configurer cette branche pour utiliser différents événements à différents moments de votre script.

OnUserInputNotUnderstood

Chemin emprunté lorsque l’agent virtuel ne comprend pas la réponse du contact ou lorsque le délai d’attente du contact expire.

Code Action Extrait requis

Une ou plusieurs propriétés de cette Action nécessitent une action Snippet avec le code personnalisé suivant :

Meilleures pratiques pour la Charge utile personnalisée avec Google Dialogflow CX

Lorsque vous utilisez cette action avec Google Dialogflow CX suivez ces bonnes pratiques pour intégrer des charges utiles personnalisées :

  • Dialogflow CX n'utilise pas de contextes pour transmettre des données auxDialogflow intentionsClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish. Dialogflow comme le fait Dialogflow ES.
  • Vous pouvez transmettre des données personnalisées à Dialogflow CX à l'aide de paires clé-valeur JSON. Dans un Snippet Action dans votre script, créez un objet customPayload dynamique et ajoutez-y les paires clé-valeur. Par exemple :

    DYNAMIC customPayload
    customPayload.ani = ani
    customPayload.contactID = contactId
    customPayload.masterContactId = masterId
    customPayloadJSON = "{customPayload.asJSON()}"	
  • Dans l'action Exchange de votre script, configurez la propriété customPayload avec une variable qui a la fonction asJSON() dans sa valeur. Vous trouverez cette variable dans l’objet customPayload.
  • In the VoiceBOT STREAM action in your script, configure the customPayload property with variable that has the asJSON() function in its value. You can find this variable in the customPayload object.
  • Transmettez la JSON customPayload à l'agent virtuel à l'aide de la propriété Payload de QueryParameters. Consultez la documentation Google sur QueryParameters A square with an arrow pointing from the center out from the top right corner. pour Google Dialogflow CX.
  • Les données transmises par QueryParameters sont reçues par un webhook dans Dialogflow CX.Vous pouvez écrire du code dans la Dialogflow Console CX pour gérer les données transmises.
  • Ne imbriquez pas un objet dans l'objet customPayload. Les objets imbriqués sont envoyés sous forme de chaînes littérales.
  • Pour transmettre des données personnalisées depuis votre agent virtuel Dialogflow CX au script, utilisez le champ Charge utile personnalisée dans la console Dialogflow CX.Vérifiez que vous vous trouvez dans la console de l’agent virtuel que vous utilisez avec NiCE CXone. Mappez ceci sur votre script à l'aide de la variable customPayloadVarName (out) dans l'action VOICEBOT EXCHANGE ou TEXTBOT EXCHANGE Studio de votre script. Par exemple, vous pouvez l'utiliser pour définir le comportements du Prompt suivant.
  • Pour transmettre des données personnalisées de votre agent virtuel Dialogflow CX vers le script, utilisez le champ Charge utile personnalisée dans la console Dialogflow CX.Vérifiez que vous vous trouvez dans la console de l’agent virtuel que vous utilisez avec NiCE CXone. Mappez-le à votre script à l'aide de la variable customPayloadVarName (out) dans l'action VOICEBOT STREAM de votre script.
  • Pour transmettre des données personnalisées à Dialogflow CX à partir du script, utilisez session_params dans l'objet customPayload au sein d'une action Snippet. Par exemple :

    DYNAMIC customPayload
    customPayload.session_params.name = "Winnie le Pooh" 
    customPayload.session_params.job = "Food critic" 
    customPayload.session_params.location = "Hundred Acre Wood"	

    Accédez aux paramètres de session dans l’intention de l’agent Dialogflow CX à l’aide de la syntaxe suivante :

    $session.params.name = Winnie Le Pooh
    $session.params.job = Food critic
    $session.params.location = 100 Acre Wood 

    Les paramètres de session sont uniquement utilisés avec les agents virtuels Dialogflow CX. Pour obtenir un résultat similaire avec Dialogflow ES, utilisez les contextes.

  • Configurer les indices de contexte de parole et un ID de conversation personnalisé pour transférer la conversation vers un autre agent virtuel CX Dialogflow dans l'extrait Charge utile personnalisée .

  • Pour configurer la durée d'attente de l'agent virtuel lorsque le contact fait une pause pendant qu'il parle, ajoutez paramètre maxPostEnergySilenceMS à l'action Next Prompt Behaviorsou Default Next Prompt Behaviors Extrait.

Meilleures pratiques pour la Charge utile personnalisée avec Google Dialogflow ES

Lorsque vous utilisez cette action avec Google Dialogflow ES, suivez ces bonnes pratiques pour intégrer des charges utiles personnalisées :

  • CustomPayload est utilisé pour transmettre le contexte d'une intentionClosed The meaning or purpose behind what a contact says/types; what the contact wants to communicate or accomplish.. Le Contexte aide l'agent virtuel à comprendre l'intention de l'utilisateur. Les Contextes ne sont pas obligatoires, mais ils aident l'agent virtuel à faire correspondre un énoncéClosed What a contact says or types. à une intention.
  • Dans une action Extrait de votre script, créez un objet customPayload qui respecte le format décrit dans la documentation Google Dialogflow ES Icône indiquant que le lien va vers un site web externe pour REST Resource :  projects.agent.sessions.context. L'aide en ligne Studio fournit des informations supplémentaires sur les objets de données dynamiques.
  • Vous pouvez également transmettre des données personnalisées avec customPayload sans contexte. Pour ce faire, incluez des paires clé-valeur JSON standard dans un objet données dynamiques.
  • Les contextes parole sont transmis dans la charge utile personnalisée dans le paramètre speech_contact. Vous pouvez afficher le contenu de ce paramètre dans les traces Studio et les journaux d’application.
  • L’objet dynamique customPayload est transféré en tant que paramètre d'agent virtuel au format JSON, comme indiqué dans l’exemple de script.
  • Configurez les indices de contexte de parole dans l'extrait Charge utile personnalisée .

Trucs et astuces

Si aucun son de voix n’est entendu entre Virtual Agent Hub et l’agent virtuel, vérifiez la trace du script pour voir s’il existe une transcription. S’il y a bien une transcription, l’agent virtuel Google Dialogflow doit être ajusté.

Exemple de script

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s'agit pas d'un script complet. Des scripts supplémentaires peuvent être nécessaires.

Les actions VoiceBot Exchange doivent être utilisées dans une boucle.Cela signifie que vous devez en utiliser au moins deux dans un script. La première action déclenche l'appel à l'API de l'agent virtuel et doit être précédée par le Comportement Prompt suivant par défaut action Extrait. La première action est la valeur par défaut de bienvenue, qui commence la première boucle scriptée, ou un «tour» de conversation.

Un exemple de script qui utilise l'action VoicebotExchange.

Télécharger ce script.

Exemple de script pour CustomPayload avec Google Dialogflow ES

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s'agit pas d'un script complet. Des scripts supplémentaires peuvent être nécessaires.

Ce script illustre comment intégrer des charges utiles personnalisées dans des agents virtuels Google Dialogflow ES. Ce script utilise l'action Voicebot Exchange, mais il fonctionnera également si vous utilisez TEXTBOT EXCHaNGE à la place.

Exemple de script montrant comment traiter une charge utile personnalisée avec Google Dialogflow CX.

Télécharger ce script.

Exemple de script pour les Événements de Dépassement DE délai alternatifs

Cet exemple montre comment cette action peut être utilisée dans les scripts. Il ne s'agit pas d'un script complet. Des scripts supplémentaires peuvent être nécessaires.

Vous pouvez utiliser différents événements de délai d'attente à différents points de votre script. Par exemple, vous souhaiterez peut-être utiliser des événements de délai d'attente différents la première et la deuxième fois que la propriété UserInputTimeout est déclenchée. Cet exemple de script montre une manière possible d'y parvenir.

Dans ce sccript, les actions Snippet sont utilisées pour créer et incrémenter un compteur de temporisation. Après le deuxième temps mort, une actionSnippet est utilisée pour définir un événement de temporisation différent. L'événement DE délai d’attente alternatif est transmis de l'action Snippet à l'action voicebot via la propriété automatedIntent .

Example script handling a voicebot action on user input timeout

Télécharger ce script.