Intégrer Google Dialogflow ES

Avant d’effectuer les tâches indiquées sur cette page, veillez à ce que les conditions préalables à l’intégration soient remplies.

Créer un script

Autorisations requises : Studio Script Voir, Créer/Modifier

Vous avez besoin d’au moins un script Studio pour acheminer les interactions à votre agent virtuel. Appliquez les directives et normes du script. Votre script doit posséder le type de médiaFermé Un moyen, tel que la voix, le courrier électronique et le chat, par lequel un contact se connecte avec un destinataire prévu. téléphone pour un agent virtuel vocal ou le type de média numérique pour un agent virtuel texte. Les actions d’agent virtuel prises en charge pour ce fournisseur sont :

Vous trouverez plus d’informations sur les scripts de Studio dans les sections Principes de base et Guide de référence technique de l’aide en ligne.

Lorsque votre agent virtuel est prêt pour la mise en production, affectez le script à un ou plusieurs points de contact.

Meilleures pratiques de charge utile personnalisée

Suivez ces bonnes pratiques lors de l'intégration de données de charge utile personnalisées Google Dialogflow ES dansCXone:

  • CustomPayload est utilisé pour transférer du contexte à une intentionFermé La signification ou le but derrière ce qu'un contact dit/tape ; ce que le contact veut communiquer ou accomplir. 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éFermé Ce qu'un contact dit ou tape. à une intention.
  • Dans une Snippet action de votre script, créez un objet customPayload qui suive le format défini dans la documentation de Google Dialogflow ES Icône indiquant que le lien va vers un site web externe pour la ressource REST : projects.agent.sessions.context. L’aide en ligne Studiofournit 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 de données dynamique.
  • Les contextes vocaux sont transmis dans la charge utile personnalisée avec 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.
  • Les conseils de contexte vocal peuvent être transmis avec la charge utile dans le paramètre speechContexts. La valeur de speechContexts.phrases doit être un jeton de classe Google Un carré avec une flèche pointant du centre vers le coin supérieur droit. correspondant au conseil à donner. Le jeton doit correspondre à la langue et aux paramètres régionaux de vos contacts. Par exemple :

    DYNAMIC customPayload
    customPayload.speechContexts.phrases="$OOV_CLASS_ALPHANUMERIC_SEQUENCE"
    customPayload.speechContexts.boost=10		

Ajouter une application à Virtual Agent Hub

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

L’ajout d’une application de configuration à Virtual Agent Hub établit la connexion entre CXone et votre fournisseur d’agents virtuels.

  1. Dans CXone, cliquez sur le sélecteur d'application et sélectionnezAutre > Automatisation & IA, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l’action d’agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Cliquez sur Ajouter un robot.
  3. Entrez un Nom d’agent virtuel (robot) et cliquez sur Google Dialogflow ES dans la liste de fournisseurs d’agents virtuels.

  4. Cliquez sur Suivant.

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

  6. Cliquez sur Suivant.

  7. Si vous configurez un agent virtuel de type texte, sélectionnez Texte seulement (pas de prise en charge de la voix) sur la page Voix. Si vous configurez un agent virtuel vocal, consultez la section Configuration des options d’intégration vocale de cette page.

  8. Cliquez sur Prochain.

  9. Sur la page Transcription, sélectionnez l’option permettant de capturer la transcription de la conversation et les informations relatives à l’intention.

  10. Cliquez sur Suivant.

  11. Sur la page Tester + 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 Retourpour revenir à la page de configuration et vérifier les paramètres. Il est parfois nécessaire de vérifier vos configurations dans votre console de gestion de fournisseur d'agent virtuel.

  12. Cliquez surAjouter.

Détails de la page de configuration Google Dialogflow ES

Utilisez les informations présentées dans le tableau suivant lorsque vous remplissez la page Configuration. Vous voyez cette page lorsque vous ajoutez une application dans Virtual Agent Hub.

champs

Détails

Version d'intégration

Sélectionnez la version de Virtual Agent Hub que vous souhaitez utiliser. Cette option vous permet d’utiliser une version précédente de Virtual Agent Hub jusqu’à ce que vous soyez prêt à passer à une nouvelle version. Les versions disponibles sont :

  • Version 1.0.0 : il s’agit de la première version de Virtual Agent Hub. L'objet de charge utile personnalisée est renvoyé en tant que customPayload.payload.xxxx.
  • Version 2.0.0 : cette version a mis à jour les schémas utilisés avec Google Dialogflow ES. Cela a un impact sur la structure de l’objet customPayload.
  • Version 3.0.0 : cette version a introduit StandardBot, qui standardise la façon dont CXone communique avec les fournisseurs d'agents virtuels. L’objet customPayload est renvoyé sous forme de tableau, comme customPayloadscriptPayloads[n].xxxx. Cette version est disponible pour tous les fournisseurs.
ID de projet GCP du client

ID de projet Google Cloud de votre organisation. Il s'agit de l'identifiant de votre agent virtuel. Vous pouvez le trouver dans les Google Dialogflow ES paramètres de la console.

Ce champ est visible uniquement si vous utilisez un compte de service OEM.

Compte de service JSON

Le fichier de clé de compte de service que vous avez créé et téléchargé depuis votre Google Cloud Console. Copiez et collez tout le contenu du fichier clé dans ce champ. Ce champ n'est visible que si vous utilisez le vôtre Google Dialogflow ES Compte.

La clé de compte de service est un objet JSON similaire à l'exemple suivant.

{

"type": "service_account",
"project_id": "ic-demo2-aai-gcp",
"private_key_id": "sdv80sdf08ssd9sdf0sdf8sdfsdf90sdf8",
"private_key": "-----BEGIN PRIVATE KEY-----
nMIIEvgIBADANBgkqhkiG9w0BAQEFAASCBKgwggSkAgEAAoIBAQCzgrS8vp
<private key has been truncated for this example>
----END PRIVATE KEY-----\n",
"client_email": "your@client_email-gcp.iam.gserviceaccount.com",
"client_id": "123456789",
"auth_uri": "https://accounts.google.com/o/oauth2/auth",
"token_uri": "https://oauth2.googleapis.com/token",
"auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
"client_x509_cert_url": "https://www.googleapis.com/robot/v1/metadata/x509/dialogflow-dthjop%40ic-demo2-aai-gcp.iam.gserviceaccount.com"
}

Langue

La langue que vous souhaitez que cet agent virtuel utilise. C'est le langage que comprend l'agent virtuel. Ce champ est obligatoire.

Région La région où votre Google Dialogflow ES agent virtuel est localisé.
Environnement Le nom de l'environnement personnalisé dans lequel votre agent virtuel est publié. Si vous laissez ce champ vide, l'environnement brouillon est utilisé.
Effectuer la sortie TTS

Activez cette option si vous voulez utiliser le service de synthèse vocal (TTSFermé Permet aux utilisateurs de saisir des invites enregistrées sous forme de texte et d'utiliser une voix générée par ordinateur pour lire le contenu.) de Google Dialogflow ES. Configurez les paramètres de sortie de la synthèse vocale.

Si vous ne souhaitez pas utiliser le service de synthèse vocale Google, vous pouvez utiliser CXoneCloud TTS Hub. Vous pouvez configurer cette option sur la page Voix de l’assistant de configuration.

Événement d'expiration du délai Nom du Google Dialogflow ES événement que vous souhaitez déclencher à l'expiration du délai.
Modèle de sortie DTMF

Entrez les caractères qui, lorsqu’ils sont enfoncés pendant un appel, font passer l'agent virtuel à la branche DTMFBreakout du script Studio.

Ne complétez ce champ que s'il s'agit d'un agent virtuel vocal.

Utiliser le sérialiseur Google Protobuf JSON

Activez cette option pour utiliser le sérialiseur Google Protobuf. Les réponses sérialisées améliorent les performances en réduisant la taille des réponses et la mémoire requise pour les traiter. Avec la réduction de taille, il est moins probable que les réponses dépassent 32 Ko, c’est-à-dire la limite de taille générale pour les variables de script.

NICE CXone vous recommande d'activer cette option. Si vous devez le désactiver pour une raison quelconque, il doit être réactivé dès que le problème est résolu.

Si vous configurez votre Google Dialogflow ES intégration avant la version printemps 2022 de CXone , il est important que vous vérifiiez l'analyse de la charge utile dans vos scripts. Partout où vous le trouvez, vous devez le remplacer par l'analyse du nouveau schéma avant d'activer cette option dans votre intégration. Par exemple, si votre script fait actuellement référence à quelque chose comme ceci : 

{parameters.fields.myfield.stringValue}

tu le changerais en :

{parameters.myfield}

Dépassement de délai pour les fournisseurs externes

Entrez le nombre de secondes pendant lesquelles le script doit attendre une réponse de Dialogflow ES . Lorsque le délai d'attente est atteint, le contrôle revient au script, qui suit la branche d'erreur.

Configuration de la sortie de synthèse vocale Google Dialogflow ES

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

Complétez les étapes de cette section si vous souhaitez utiliser le service TTS Google. Les champs de l’image suivante s’affichent lorsque vous activez l’option Effectuer la sortie TTS sur la page Configuration de Dialogflow ES dans Virtual Agent Hub.

  1. Dans Virtual Agent Hub, ajoutez une nouvelle application de configuration et configurez-la en suivant les étapes de la section Ajout d’une application à Virtual Agent Hub de cette page.
  2. Activez Activer synthèse vocale.
  3. Pour utiliser un modèle vocal personnalisé, cliquez sur Utiliser voix personnalisée pour sélectionner Activer, puis saisissez le nom du modèle AutoML à utiliser dans le champ Modèle de voix personnalisé.

  4. Si vous souhaitez utiliser le modèle vocal Google, sélectionnez Nom de la voix TTS (synthèse vocale) dans la liste déroulante.

  5. Sélectionnez le modèle de machine learning et sa variante que les services de synthèse vocale de Google doivent utiliser.

  6. Pour ajouter un silence au début de la réponse audio de l’agent virtuel, saisissez la durée de silence en millisecondes à ajouter dans le champ Ajouter silence initial. La durée de silence recommandé est de 500 millisecondes.

  7. Saisissez la Vitesse d’élocution, le Ton et le Gain du volume pour configurer le rendu de la synthèse vocale.

  8. Revenez à la section Ajout d’une application à Virtual Agent Hub sur cette page pour terminer l’ajout de l’application de configuration.

Configuration des options d'intégration vocale

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

Si vous définissez un agent texte virtuel, vous pouvez ignorer cette section.

  1. Dans Virtual Agent Hub, ajoutez une nouvelle application de configuration et configurez-la en suivant les étapes de la section Ajout d’une application à Virtual Agent Hub de cette page.
  2. Cliquez sur Suivant sur la page de configuration.

  3. Sur la page Voix dans la section Options d’intégration vocale, sélectionnez Contrôle tour par tour (CXone Voice Bot Gateway).
  4. Si le formulaire ne vous permet pas de sélectionner Utiliser la synthèse vocale Cloud de CXone, cliquez sur Retour pour revenir à la page Configuration. Cliquez sur le curseur de Effectuer la sortie TTS pour le placer sur Désactivé. Vous pouvez désormais activer Cloud TTS Hub sur la page Voix.

  5. Sélectionnez un Fournisseur de synthèse vocale, si vous utilisez Cloud TTS Hub. Si vous utilisez le service de synthèse vocale de votre fournisseur d'agents virtuels, ce champ n’est pas visible et vous pouvez ignorer cette étape.
  6. Dans la section Options de transcription, sélectionnez l’option du service de transcription à utiliser.

  7. Si vous choisissez d’utiliser un profil de transcription CXone, cliquez sur Profil de transcription pour sélectionner celui qu’il vous faut. Cliquez sur Ajouter un nouveau profil de transcription tour par tour pour créer un profil.
  8. Cliquez sur Suivant.
  9. Revenez à la section Ajout d’une application à Virtual Agent Hub sur cette page pour terminer l’ajout de l’application de configuration.

Assignation de l’application Google Dialogflow ES à une action

Autorisations requises : Studio Script Voir, Créer/Modifier

Quand l’application d’agent virtuelFermé 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’affecter aux actions d’agents virtuels dans votre script. Cela permet de connecter l'action et le script à votre fournisseur d'agent virtuel.

  1. Dans Studio, ouvrez le script que vous souhaitez modifier.
  2. Si ce n’est déjà fait, cliquez sur l’onglet Instrument, développez la catégorie Automatisation et IA, et ajoutez l’action de l’agent virtuel que vous souhaitez utiliser. Veillez à la placer au bon endroit au sein de 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 vocal, votre script doit être un script de type téléphone.

  3. Double-cliquez sur l’action pour ouvrir Virtual Agent Hub.

  4. Dans la colonne de gauche, localisez l’agent virtuel que vous souhaitez affecter à l’action et cliquez sur la coche Icône de cercle avec une marque à l’intérieur. correspondante.
  5. Cliquez sur Fermer.

Modifier le profil de transcription

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

Un profil de transcription vous permet d'utiliser un service de transcription différent de celui proposé par le fournisseur d’agents virtuels. Chaque agent virtuel peut avoir un profil de transcription. Les étapes de cette section ne vous concernent que si vous utilisez un agent virtuel vocal et devez modifier le profil de transcription.

  1. Dans CXone, cliquez sur le sélecteur d'application et sélectionnezAutre > Automatisation & IA, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l’action d’agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Dans la liste déroulante des applications de configuration des agents virtuels située dans la partie gauche de la page Virtual Agent Hub, cliquez sur celle que vous souhaitez modifier.
  3. Dans le volet central de la page des propriétés de l’application d’agents virtuels, cliquez sur l'onglet Voix.
  4. Dans la section Options de transcription, sélectionnez Utiliser le profil de transcription CXone s’il ne l’est pas déjà.

  5. Sélectionnez le Profil de transcription tour par tour que vous voulez que cette intégration d’agents virtuels utilise. Si l'option que vous souhaitez utiliser n'existe pas, 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 de propriétés de votre application d'agent virtuel.

Test de votre agent virtuel

Autorisations requises : Automatisation & IA > Lancer Automatisation & IA

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

  • vérifier que l'application de l'agent virtuel est configurée correctement pour communiquer avec le fournisseur d'agents virtuels ;
  • ajouter un JSON de charge utile personnalisée pour tester la manière dont l'agent virtuel traite les données de charge utile personnalisée ;
  • déclencher un événement d’intention de bienvenue pour tester la manière dont l'agent virtuel commence une conversation ;
  • déclencher un événement d’intention personnalisée afin de tester les événements personnalisés que vous avez pu créer pour votre agent virtuel ;
  • déclencher un événement de dépassement de délai pour tester la manière dont l'agent virtuel réagit lorsque le contact dépasse le délai imparti ;
  • tester la manière dont le robot traite les entrées DTMFFermé Tonalités de signalisation générées lorsqu'un utilisateur appuie ou appuie sur une touche de son clavier téléphonique..

L'image suivante donne un exemple de page de propriétés d'une application d'agent virtuel dans Virtual Agent Hub. Elle illustre les onglets Configuration et Voix, ainsi que le volet Test.

  1. Dans CXone, cliquez sur le sélecteur d'application et sélectionnezAutre > Automatisation & IA, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l’action d’agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Dans la liste située sur la gauche, cliquez sur l'application de configuration pour l'agent virtuel que vous voulez tester pour la sélectionner.
  3. Dans le volet Test, saisissez un message de test dans le champ Saisissez un message, puis appuyez sur la touche Entrée pour l’envoyer. Vous pouvez aussi cliquer sur Microphone Icône en forme de microphone. pour utiliser le micro de votre ordinateur.

  4. Cliquez sur Commencez avec une intention de bienvenue pour démarrer une conversation test depuis le début. L'agent virtuel répond en utilisant son message de bienvenue par défaut. Vous pouvez entrer des messages de test.
  5. Cliquez sur Plus d’options Icône avec trois points empilés. pour tester d’autres aspects de votre agent virtuel.

  6. Cliquez sur Réinitialiser pour recommencer le test.
  7. Si vous devez effectuer des changements en fonction des résultats du test, vous pouvez :

    • modifier les scripts Studio de l'agent virtuel ;
    • modifier les paramètres de configuration dans l'application de l’agent virtuel dans Virtual Agent Hub ;
    • modifier les paramètres de configuration de l'agent virtuel dans la console du fournisseur. Cliquez sur le grand bouton carré de la page des propriétés d’application dans Virtual Agent Hub. L’exemple au début de cette section montre l’application Google Dialogflow CX avec le bouton fournisseur. Il comporte l’icône Une icône présentant un carré superposé d’une flèche. La flèche part du centre du carré et pointe vers l’angle supérieur droit. pour indiquer que le lien mène à un site externe.
  8. Testez soigneusement l'agent virtuel après chaque modification des scripts ou des paramètres de configuration.
  9. Une fois le test terminé, cliquez sur Fermer.