Intégrer Google Dialogflow ES

Conditions préalables

Pour utiliser les Google Dialogflow ES agents virtuelsClosed 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 sur la Plateforme Google Cloud
  • Un agent virtuel Google Dialogflow ES configuré et entraîné pour répondre aux demandes de vos contacts.

Créer un script

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

You need at least one Studio script to route interactions to your virtual agent. Follow the script guidelines. Your script must have the phone media typeClosed Un moyen, tel que la voix, les courriels et les clavardages, à travers lequel un contact se connecte au destinataire voulu. for a voice virtual agent or the digital media type for a text virtual agent. The supported virtual agent actions for this provider are:

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

Vous pouvez en savoir plus sur le scripting Studio dans les sections Principes fondamentaux et Référence Technique Guide de l'aide en ligne.

Bonnes pratiques relatives à la charge utile personnalisée

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

  • CustomPayload est utilisé pour transmettre le contexte d'une intentionClosed 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éClosed Ce qu’un contact dit ou tape. à 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 de 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 .

Ajouter une application à Virtual Agent Hub

Autorisations requises : Connections Hub > Lancer Connections Hub

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

  1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Autre > Connection Hub, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Cliquez sur Ajouter un robot.
  3. Saisissez un nom d'Agent virtuel (Bot) et cliquez sur Google Dialogflow ES dans la liste des fournisseurs d'agents virtuels.

  4. Cliquez sur Prochain.

  5. Remplissez les champs du formulaire de configuration et cliquez sur Prochain. Vous trouverez plus d'informations sur ce formulaire dans la section Détail de la page de configuration de cette page.

  6. Cliquez sur Prochain.

  7. Si vous configurez un agent virtuel texte, sélectionnez Texte uniquement (sans Soutien vocal) sur la Page Voice. Si vous configurez un agent virtuel Voix, consultez la section Configure Voice Integration Options de cette page.

  8. Sur la page Transcript, sélectionnez l'option indiquant si vous souhaitez capturer la transcription de la conversation et les informations d'intention. Si cet onglet n'est pas disponible, la fonctionnalité n'est pas activée pour votre locataireClosed 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.. Contactez votre représentant de compte NiCE CXone pour plus d'informations sur cette fonctionnalité.

  9. Cliquez sur Prochain.

  10. Sur la page Tester + ajouter, vous pouvez tester la connexion de votre bot en envoyant des invites vocales ou textuelles. Si vos messages test ne fonctionnent pas, cliquez sur Retour pour revenir à la page Configuration et vérifier les paramètres. Vous devrez peut-être également vérifier les configurations dans la console de gestion de votre fournisseur d'agent virtuel.

  11. Cliquez sur ajouter.

Google Dialogflow ES Détails de la Page Configuration

Utilisez les informations présentées dans le tableau suivant lorsque vous remplissez la page Configuration. Vous voyez cette page lors de l'ajout d'une application dans Virtual Agent Hub

Champ

Détails

Version d’intégration ```

Sélectionner l'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: This is the first version of Virtual Agent Hub. The custom payload object returns as 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. Cette version a mis à jour les schémas utilisés avec Google Dialogflow CX. 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 NiCE CXone communique avec les fournisseurs d'agent virtuel. Le customPayload objet est renvoyé sous forme de tableau, comme customPayloadscriptPayloads[n].xxxx. Cette version est disponible pour tous les fournisseurs.
```
Compte de service JSON

Le fichier de clé de compte de service que vous avez créé et téléchargé depuis votre Console Google Cloud. Copiez et collez l'intégralité du contenu du fichier de clé dans ce champ. Ce champ est visible uniquement si vous utilisez votre propre compte Google Dialogflow ES.

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

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 souhaitez utiliser le service de synthèse vocale (TTSClosed 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.) Google Dialogflow ES. Configurez les paramètres de sortie TTS.

Si vous ne souhaitez pas utiliser le service Google Dialogflow CX TTS, laissez ce champ défini sur Désactivé. Vous pouvez utiliser un service NiCE CXoneText-to-Speech (Cloud TTS Hub).

S'il s'agit d'un agent virtuel de type texte, laissez cette option désactivée.

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

Saisissez les caractères qui, lorsqu'ils sont enfoncés pendant un appel, entraînent le passage de l'agent virtuel vers 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 JSON Google Protobuf

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.

Nous vous recommandons d'activer cette option. Si vous devez la désactiver pour une raison quelconque, elle doit être réactivée dès que le problème est résolu.

Si vous configurez votre Google Dialogflow ES intégration avant la version printemps 2022 de NiCE 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 à un élément similaire à ceci :

{parameters.fields.myfield.stringValue}

tu le changerais en :

{parameters.myfield}

Analyser les sentiment

Cliquez sur le curseur pour le mettre sur Activé si vous souhaitez recevoir les résultats de l'analyse de sentiment de Google. Cette option nécessite que cette option soit activée dans votre projet Google Cloud. Vous êtes responsable de la configuration de l'utilisation des données d'analyse de sentiment avec votre agent virtuel.

Délai d’attente du fournisseur externe

Entrez le nombre de secondes pendant lequel vous souhaitez que le script attende 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.

Configurer la Sortie TTS Google Dialogflow ES

Autorisations requises : Connections Hub > Lancer Connections Hub

Complétez les étapes de cette section si vous souhaitez utiliser le service TTS Google. Les champs figurant dans l'image suivante apparaissent lorsque vous activez l'option Perform Output TTS sur la page Dialogflow ES Configuration dans Virtual Agent Hub.

  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 de cette Page.
  2. ActivezEffectuer la Sortie TTS.
  3. Pour utiliser un modèle vocal personnalisé, activez Utiliser voix personnalisée et entrez le nom du modèle AutoML que vous souhaitez 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 d'apprentissage automatique et la Variante DE modèle que vous souhaitez que les Google Services TTS utilisent lors de la synthèse de la parole.

  6. Pour ajouter un silence au début de la réponse audio de l'agent virtuel, entrez le nombre de millisecondes de silence à ajouter dans le champ Add Leading Silence. La durée de silence recommandé est de 500 millisecondes.

  7. Saisissez le Débit DE LA parole, le Ton et le Gain DE volume pour configurer le son que vous souhaitez pour la Voix TTS.

  8. Revenez à la section ajouter une appli à Virtual Agent Hub sur cette page pour terminer l'ajout de l'appli de configuration.

Configurer les options d’Intégration Voix

Autorisations requises : Connections Hub > Lancer Connections Hub

Si vous configurez un agent virtuel textuel, vous pouvez sauter 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 de cette page.
  2. Cliquez sur Suivant sur la page de 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 du service de transcription que vous souhaitez utiliser.

  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 Turn by Turn Transcription Profil pour créer un nouveau profil.
  6. Cliquez sur Prochain.
  7. Retournez à la section Ajout d'une application à Virtual Agent Hub sur cette page pour terminer l'ajout de l'application de configuration.

Attribuer l'application Google Dialogflow ES à une Action

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

Lorsque l'application agent virtuelClosed 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 agent virtuel 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 vous ne l'avez pas encore fait, cliquez sur l'onglet Tools , développez la catégorie Automation and AI, puis ajoutez l'action agent virtuel que vous souhaitez utiliser. Veillez à la placer au bon endroit au sein de votre script. Si vous ne voyez pas l'action que vous attendez, vérifiez que votre type DE support de script est correct.Par exemple, si vous créez un script pour un agent virtuel vocal, le script doit être un script téléphone.

  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 Icône de cercle avec une marque à l’intérieur. à côté de celui-ci.

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

  5. Cliquez sur Fermer.

Modifier le Profil Transcription

Autorisations requises : Connections Hub > Lancer Connections Hub

Un profil de transcription vous permet d'utiliser un service de transcription différent de celui proposé 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 modifier le profil de transcription.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Autre > Connection Hub, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Dans la liste des applications de configuration des agents virtuels, 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 agent virtuel, cliquez sur l'onglet Voix.
  4. Sous l'option Transcription, sélectionnez Utiliser le Profil Turn-by-Turn Transcription si cette option n'est pas déjà sélectionnée.

  5. Sélectionnez le Profil TranscriptionTurn by Turn que vous souhaitez que cette intégration d'agent virtuel utilise. Si l'Option que vous souhaitez utiliser n'y figure pas, vous pouvez l'ajouter.

  6. Cliquez sur enregistrer.
  7. Testez votre service de transcription à l'aide de l'option microphone, dans la Section Test de la page des propriétés de l'application agent virtuel.

Test votre Agent virtuel

Autorisations requises : Connections Hub > Lancer Connections Hub

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 des propriétés de l'application agent virtuel dans Virtual Agent Hub. Lors des tests, vous pouvez : 

  • Vérifier que l'application agent virtuel est correctement configurée pour communiquer avec le fournisseur d'agent virtuel.
  • 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 DTMFClosed 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 Page des propriétés pour une application agent virtuel dans Virtual Agent Hub (pas Dialogflow ES). Elle illustre les onglets Configuration et Voix, ainsi que le volet Test.

  1. Dans NiCE CXone, cliquez sur le sélecteur d'application et sélectionnez Autre > Connection Hub, puis cliquez sur Virtual Agent Hub. Vous pouvez également double-cliquer sur l'Action agent virtuel dans votre script Studio pour lancer Virtual Agent Hub.
  2. Dans la liste située sur la gauche, cliquez pour sélectionner l'application de configuration de l'agent virtuel que vous souhaitez tester.
  3. Dans le panneau Test, saisissez un message test dans le champ Type a message et appuyez sur entrée pour l'envoyer. Vous pouvez également cliquer sur MicrophoneIcône en forme de microphone. et parler dans le microphone 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’optionsIcône avec trois points empilés. pour le test d’autres aspects de votre agent virtuel.

  6. Cliquez sur Réinitialiser pour recommencer le test.
  7. Si vous devez apporter des modifications en fonction des résultats de vos tests, vous pouvez :

    • modifier les scripts Studio de l'agent virtuel ;
    • Modifiez les paramètres de configuration dans l'application de l'agent virtuel dans Virtual Agent Hub.
    • Modifiez les paramètres de configuration de l'agent virtuel dans la console du fournisseur. Cliquez sur le bouton carré Large sur la page des propriétés de l'application dans Virtual Agent Hub. L'exemple au début de cette Section présente l'application Google Dialogflow CX avec le bouton du fournisseur. Elle comporte l'icône An icon that has a square with an arrow overlaid on top of it. The arrow points from the center of the square to the top right corner of the square. pour indiquer que le lien ouvre un site externe.
  8. Testez minutieusement l'agent virtuel après chaque modification apportée à vos scripts ou aux paramètres de configuration.
  9. Lorsque vous avez terminé les tests, cliquez sur Fermer.