Intégrer Amazon Lex V2

Conditions préalables

Pour utiliser les Amazon Lex V2 agents virtuels Une application logicielle qui traite les interactions avec les clients à la place d’un agent humain en direct. avec NiCE CXone, vous devez disposer des éléments suivants :

• Un compte Amazon AWS.
• Un agent virtuel Amazon Lex V2 configuré et formé pour utiliser les réponses qui répondent aux demandes de vos contacts. Dans le contexte de Amazon Lex V2, ces réponses sont appelées des intentions. Cette définition diffère du sens du terme intention La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir. employé ailleurs dans l'aide en ligne de NiCE CXone.

Créer un script

autorisations requises : Studio Script View, Create/Edit

Vous avez besoin d'au moins un script Studio pour acheminer les interactions vers votre agent virtuel. Suivez les directives relatives aux scripts. Votre script doit avoir le type de support Un moyen, tel que la voix, les courriels et les clavardages, à travers lequel un contact se connecte au destinataire voulu. téléphone pour un agent virtuel vocal ou le type de support numérique pour un agent virtuel textuel. Les actions d'agent virtuel prises en charge pour ce fournisseur sont :

• VoiceBot Exchange
• Échange TextBot

Si vous configurez un agent virtuel vocal et que vous utilisez un service NiCE CXoneText-to-Speech (Cloud TTS Hub), incluez l'action CLOUD TTS dans votre script.

Vous pouvez en savoir plus sur les scripts Studio dans les sections Fundamentals et Guide de Référence Technique de l'aide en ligne.

Ajouter une application à Virtual Agent Hub

autorisations requises : Connections Hub > Launch Connections Hub

L'ajout d'une application de configuration à Virtual Agent Hub établit la connexion entre NiCE CXone et votre fournisseur d'agent virtuel.

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Autre > Connection Hub et cliquez ensuite sur Virtual Agent Hub. Vous pouvez également faire un double-clic sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
2. Cliquez sur Ajouter un robot.

3. Entrez un Nom de l'Agent virtuel (bot) et cliquez sur Amazon AWS Lex V2 dans la liste des fournisseurs d'agents virtuels.

4. Cliquez sur Suivant.

5. Remplissez les champs du formulaire de configuration et cliquez sur Suivant. Vous trouverez des détails sur ce formulaire dans la section Détails de la page de configuration de cette page.

6. Cliquez sur Suivant.

7. Si vous configurez un agent virtuel textuel, sélectionnez Texte seulement (aucun Soutien vocal) sur la page Voix. Si vous configurez un agent virtuel vocal, consultez la section Configurer les options d'Intégration vocale de cette page.

8. Sur la page Transcription, sélectionnez l'option indiquant si vous voulez que la transcription de la conversation et les informations sur les intentions soient capturées. Si cet onglet n'est pas disponible, la fonctionnalité n'est pas activée pour votre locataire Regroupement organisationnel de haut niveau utilisé pour gérer le soutien technique, la facturation et les paramètres globaux de votre système NiCE CXone.. Communiquez avec votre représentant de compte NiCE CXone pour plus d'informations sur cette fonctionnalité.

   En savoir plus sur les champs de cette étape

   Option	Détails
   Informations sur l’intention uniquement	Sélectionnez cette option si vous souhaitez capturer uniquement les informations sur l’intention. Par défaut, les données capturées sont stockées uniquement pendant la durée de l’interaction. Cette option nécessite un script personnalisé.
   Aucune	Sélectionnez cette option si vous ne souhaitez pas capturer les informations sur les transcriptions des conversations ou les informations sur les intentions La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir..
   Transcription et informations sur l’intention	Sélectionnez cette option si vous souhaitez capturer à la fois la transcription et les données sur l’intention. Par défaut, les données capturées sont stockées uniquement pendant la durée de l’interaction. Cette option nécessite un script personnalisé.
   Transcription uniquement	Select this option if you want to capture transcript information only. Captured data is stored only for the duration of the interaction by default. Cette option nécessite un script personnalisé.

9. Cliquez sur Suivant.

10. Sur la page Test + Ajouter, vous pouvez tester la connexion de votre bot en envoyant des invites vocales ou textuelles. Si vos messages de test ne fonctionnent pas, cliquez sur Retour pour revenir à la page de configuration et vérifier les paramètres.

11. Cliquez sur Ajouter.

Amazon Lex V2 Détails de la page de configuration

Utilisez les informations du tableau suivant lorsque vous remplissez la Page Configuration. Vous voyez cette page lorsque vous ajoutez une application dans Virtual Agent Hub

Champ	Détails
Version d'intégration	Sélectionnez la version de Virtual Agent Hub que vous voulez utiliser. Cette option vous permet d'utiliser une version précédente de Virtual Agent Hub jusqu'à ce que vous soyez prêt à basculer vers une version nouvellement publiée. Les versions disponibles sont : Version 1.0.0 : Ceci est la première version de Virtual Agent Hub. L'objet charge utile personnalisée est retourné comme customPayload.payload.xxxx. Version 2.0.0 : Cette version n'est pas disponible pour ce fournisseur. Version 3.0.0 : Cette version a introduit StandardBot, qui normalise la façon dont NiCE CXone communique avec les fournisseurs d'agent virtuel. L'objet customPayload est retourné comme un tableau, comme customPayloadscriptPayloads[n].xxxx. Cette version est disponible pour tous les fournisseurs.
Clé d’accès	Entrée de l'ID de la clé d'accès pour cet agent virtuel Amazon Lex V2. Vous pouvez trouver ou créer des clés d'accès dans votre AWS Gestion Console. Ce champ est obligatoire.
Clé secrète	Entrée de la clé secrète correspondant à l'ID de la clé d'accès que vous avez fournie. Si vous n'avez pas copié votre clé secrète lors de sa création, vous devez créer une nouvelle clé secrète. Ce champ est obligatoire.
Région	Sélectionnez dans la liste déroulante la région où votre agent virtuel Amazon Lex V2 est hébergé. Ce champ est obligatoire.
ID de bot	Entrée de l'ID de l'agent virtuel Amazon Lex V2. Pour trouver cette information, cherchez le champ ID dans la console Amazon Lex sous Bot Details. Ce champ est obligatoire.
ID de l'alias bot	Entrée de l'ID de l'alias que vous souhaitez que cet agent virtuel utilise. Les alias vous permettent de préciser quelle version d'un agent virtuel Amazon Lex V2 vous souhaitez utiliser. Pour trouver cette information, cherchez le champ ID dans la console Amazon Lex sous Détails après avoir sélectionné l'Alias approprié. Ce champ est obligatoire.
Lieu	Sélectionnez dans la liste déroulante la langue et la locale que cet agent virtuel est configuré pour utiliser. Les options de la liste sont au format language_locale (Langue (Locale)). Ce champ est obligatoire.
Utiliser la synthèse texte-parole du compte Lex	Si c'est un agent virtuel vocal et que vous voulez utiliser le service Amazonsynthèse vocale Permet aux utilisateurs d’entrer des invites enregistrées sous forme de texte et d’utiliser une voix générée par ordinateur pour prononcer le contenu. (TTS), cliquez pour activer. Si vous utilisez cette option, le TTS est facturé à votre compte Amazon Lex V2. Si vous ne voulez pas utiliser le service TTS Amazon, laissez ce champ réglé sur Désactivé. Vous pouvez utiliser un service NiCE CXone Text-to-Speech (Cloud TTS Hub). S’il s’agit d’un agent virtuel textuel, laissez cette option désactivée.
Intention de bienvenue	Le nom de l'intention que vous voulez que cet agent virtuel utilise pour le message d'accueil initial au début d'une conversation. Dans le contexte de Amazon Lex V2, une intention est une action qui répond à la demande du contact. Cette définition diffère du sens de intention La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir. ailleurs dans l'NiCE CXone aide en ligne. Vous définissez ces intentions dans la console Amazon Lex V2. Ce champ est sensible à la casse.
Intention de délai d'attente	Le nom de l'intention que vous voulez que cet agent virtuel utilise lorsque le contact atteint le délai d'attente pendant une conversation. Dans le contexte de Amazon Lex V2, une intention est une action qui répond à la demande du contact. Cette définition diffère du sens de intention La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir. ailleurs dans l'NiCE CXone aide en ligne. Vous définissez ces intentions dans la console Amazon Lex V2. Ce champ est sensible à la casse.
Modèle de rupture DTMF	Entrez les caractères qui, lorsqu'ils sont pressés pendant un appel, amènent l'agent virtuel à sauter à la branche DTMFBreakout du script Studio. Ne remplissez ce champ que s’il s’agit d’un agent virtuel vocal.
Dépassement de délai de fournisseur externe	Entrée le nombre de secondes pendant lequel vous voulez que le script attende une réponse de Amazon Lex V2. Lorsque le dépassement de délai est atteint, le contrôle revient au script, qui prend la branche d'erreur.

Configurer les options d’Intégration Voix

autorisations requises : Connections Hub > Launch Connections Hub

Si vous configurez un agent virtuel textuel, vous pouvez ignorer cette section.

1. Dans Virtual Agent Hub, ajoutez une nouvelle application de configuration et configurez-la selon les étapes de la section Ajouter une application à Virtual Agent Hub sur cette page.

2. Cliquez sur Suivant sur la page Configuration.

3. Sur la page Voix, sous Options d’Intégration Voix, sélectionnez Turn by Turn Control (CXone Voicebot Gateway).

4. Sous Transcription Options, sélectionnez l’option correspondant au service de transcription que vous souhaitez utiliser.

   Apprenez-en davantage sur les champs dans cette étape

   Field

   Détails

   Options de transcription

   Sélectionnez le service que vous souhaitez utiliser pour la transcription : Utilisez la transcription du compte du robot : Sélectionnez cette option si vous voulez utiliser le service de transcription du fournisseur de votre agent virtuel. L’audio des énoncés du contact est envoyé au fournisseur avant d’être transcrit. Utilisez le profil Turn-by-Turn Transcription : Sélectionnez cette option si vous voulez utiliser un profil de transcription NiCE CXone. Vous pouvez en savoir plus sur cette option sur la page d’aide NiCE CXone Turn-by-Turn Transcription.

5. Si vous choisissez d’utiliser un profil Turn-by-Turn Transcription, cliquez sur Turn-by-Turn Transcription Profil pour sélectionner celui que vous souhaitez utiliser. Cliquez sur Ajouter un nouveau Profil Turn by Turn Transcription pour créer un nouveau profil.
6. Cliquez sur Suivant.
7. Retournez à la section Ajouter une application à Virtual Agent Hub sur cette page pour terminer l’ajout de l’application de configuration.

Assigner l’application Amazon Lex V2 à une action

autorisations requises : Studio Script View, Create/Edit

Lorsque l’application d’agent virtuel La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir. est configurée dans Virtual Agent Hub, vous devez l’assigner à l’action d’agent virtuel dans votre script. Cela relie l’action et le script à votre fournisseur d’agent virtuel.

1. Dans Studio, ouvrez le script que vous souhaitez modifier.

2. Si vous ne l’avez pas déjà fait, cliquez sur l’onglet Outils , développez la catégorie Automatisation et AI, puis ajoutez l’action d’agent virtuel que vous souhaitez utiliser. Assurez-vous de la placer au bon endroit dans votre script. Si vous ne voyez pas l’action attendue, vérifiez que le type de support du script est correct. Par exemple, si vous créez un script pour un agent virtuel voix, le script doit être un script téléphonique.

3. Cliquez sur Ouvrir l’éditeur sur l’action pour ouvrir Virtual Agent Hub.

4. Dans la colonne de gauche, repérez le profil d’agent virtuel que vous souhaitez assigner à l’action, puis cliquez sur la coche à côté de celui-ci.

   Une autre solution à l’utilisation de la coche consiste à créer une variable dans votre script Studio. Utilisez la variable pour transmettre le nom de l’application d’agent virtuel à la propriété Virtual Agent ID de l’action Virtual Agent Hub que vous utilisez.

5. Cliquez sur Fermer.

Modifier le Profil Transcription

autorisations requises : Connections Hub > Launch Connections Hub

Un profil de transcription vous permet d'utiliser un service de transcription différent de celui offert par le fournisseur de l'agent virtuel. Chaque agent virtuel peut avoir un profil de transcription. Vous devez uniquement suivre les étapes de cette section si vous travaillez avec un agent virtuel voix et devez changer le profil de transcription.

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Autre > Connection Hub et cliquez ensuite sur Virtual Agent Hub. Vous pouvez également faire un double-clic sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
2. Dans la liste des applications de configuration de l'agent virtuel sur le côté gauche de la page Virtual Agent Hub, cliquez sur celle que vous voulez modifier.
3. Au centre de la page des propriétés de l'application de l'agent virtuel, cliquez sur l'onglet Voix.

4. Sous Transcription Options, sélectionnez Utiliser le Profil Turn-by-Turn Transcription si elle n'est pas déjà sélectionnée.

5. Sélectionnez le Turn by Turn Transcription Profil que vous voulez que cette intégration de l'agent virtuel utilise. Si l'option que vous voulez utiliser n'est pas là, vous pouvez l'ajouter.

6. Cliquez sur Enregistrer.
7. Testez votre service de transcription en utilisant l'option microphone dans la section Test de la page des propriétés de l'application de l'agent virtuel.

Testez votre Agent virtuel

autorisations requises : Connections Hub > Launch Connections Hub

Vous pouvez tester de nombreux aspects de votre agent virtuel pour vous assurer que tout fonctionne comme prévu. Vous pouvez exécuter des tests depuis la page des propriétés de l’application d’agent virtuel dans Virtual Agent Hub. Lors des tests, vous pouvez :

• Vérifier que l’application d’agent virtuel est correctement configurée pour communiquer avec le fournisseur d’agent virtuel.
• Ajouter des données JSON personnalisées pour tester la gestion des données personnalisées par l’agent virtuel.
• Déclencher un événement de bienvenue pour tester la façon dont l’agent virtuel entame une conversation.
• Déclencher un événement d’intention personnalisé pour tester les événements personnalisés que vous avez créés pour votre agent virtuel.
• Déclenchez un événement de délai d’attente pour tester comment l’agent virtuel répond lorsque le contact expire.
• Tester la façon dont l’agent virtuel gère l’entrée DTMF Tonalités de signalisation générées lorsqu’un contact appuie sur une touche du clavier téléphonique..

L’image suivante est un exemple de la page des propriétés d’une application d’agent virtuel dans Virtual Agent Hub (pas Amazon Lex V2). Elle montre les onglets Configuration et Voix ainsi que le volet Test.

1. Dans NiCE CXone, cliquez sur le sélecteur d'applications et sélectionnez Autre > Connection Hub et cliquez ensuite sur Virtual Agent Hub. Vous pouvez également faire un double-clic sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
2. Cliquez pour sélectionner l’application de configuration de l’agent virtuel que vous souhaitez tester dans la liste de gauche.

3. Dans le volet Test, entrez un message test dans le champ Tapez un message et appuyez sur entrée pour l’envoyer. Vous pouvez également cliquer sur Microphone et parler dans le microphone de votre ordinateur.

4. Cliquez sur Démarrer avec l’intention de bienvenue pour démarrer une conversation test depuis le début. L’agent virtuel répond avec son message de bienvenue par défaut. Vous pouvez entrer des messages test.

5. Cliquez sur Plus d’options pour tester d’autres aspects de votre agent virtuel.

   Apprenez-en davantage sur les champs dans cette étape

   Field	Détails
   Ajouter une Charge utile personnalisée JSON	Sélectionnez pour tester l’envoi de charge utile personnalisée JSON à votre agent virtuel. Entrez la charge utile personnalisée dans la zone de texte Ajouter une Charge utile personnalisée JSON qui apparaît sur la page Test + Add. Appuyez sur entrée après chaque ligne. Envoyez un message test lorsque vous êtes prêt à tester la charge utile personnalisée. Lorsque vous avez terminé de tester la charge utile personnalisée, cliquez sur Fermer dans le volet Ajouter une Charge utile personnalisée JSON.
   Déclenchez un Événement d’Intention de bienvenue	Sélectionnez pour tester l’intention La signification ou le but derrière ce qu’un contact dit/tape ; ce que le contact veut communiquer ou accomplir. de bienvenue par défaut. L’agent virtuel envoie le message de bienvenue. Entrez un message pour répondre.
   Déclenchez un Événement d’Intention personnalisé	Sélectionnez cette option pour tester un événement d’intention personnalisé. Entrez le Nom de l’Événement dans la fenêtre contextuelle qui s’affiche, puis cliquez sur Déclencher. L’agent virtuel envoie le message pour l’intention que vous avez saisie. Envoyez une réponse pour tester l’intention.
   Déclencher l’Événement de délai d’attente	Sélectionnez cette option pour afficher l’intention de délai d’attente par défaut. L’agent virtuel envoie le message de réponse au dépassement de délai configuré.
   Entrée DTMF	Sélectionnez cette option pour tester la réponse de votre agent virtuel vocal aux tonalités DTMF Tonalités de signalisation générées lorsqu’un contact appuie sur une touche du clavier téléphonique.. Entrez les Caractères dtmf, puis cliquez sur Saisie pour voir la réponse de l’agent virtuel à ces caractères.

6. Cliquez sur Réinitialiser pour recommencer votre test.

7. Si vous devez apporter des modifications en fonction des résultats de vos tests, vous pouvez :

   • Modifier les scripts Studio pour l’agent virtuel.
   • Modifiez les paramètres de configuration dans l’application d’agent virtuel dans Virtual Agent Hub.
   • Modifiez les paramètres de configuration de l’agent virtuel dans la console du fournisseur. Cliquez sur le grand bouton carré sur la page des propriétés de l’application dans Virtual Agent Hub. L’exemple au début de cette section montre l’application Google Dialogflow CX avec le bouton du fournisseur. Elle comporte l’Icône pour indiquer que le lien ouvre un site externe.
8. Testez soigneusement l’agent virtuel après chaque modification de vos scripts ou de vos paramètres de configuration.
9. Une fois les tests terminés, cliquez sur Fermer.