Ajouter Adaptive Cards dans AI Agents (Cognigy) pour Virtual Agent Hub et NiCE CXone DX Chat

Adaptive Cards vous permettent de présenter du contenu enrichi et structuré — comme du texte, des images et des boutons d'action — dans une conversation plutôt qu'en texte brut. AI Agents (Cognigy) prend en charge nativement les Adaptive Cards grâce au nœud Say, ce qui vous permet de concevoir une seule définition de carte et de l'afficher dans n'importe quel canal connecté par l'entremise du Virtual Agent Hub, y compris les canaux de clavardage DX de NiCE CXone pris en charge.

Ce sujet explique comment ajouter un Adaptive Card natif à un nœud Say, faire référence à une variable de contexte dans la carte, prévisualiser la carte dans AI Agents (Cognigy) et la tester dans une interaction de clavardage DX de NiCE CXone.

Avant de commencer :

Veillez à ce que :

• Un projet AI Agents (Cognigy) avec un Flux que vous pouvez modifier.

• Virtual Agent Hub configuré et connecté à votre projet AI Agents (Cognigy). Consultez Setup AI Agents (Cognigy) Text Bot in Virtual Agent Hub pour plus de détails.

• Un canal de clavardage DX NiCE CXone créé et lié dans Virtual Agent Hub.

Ajouter un Adaptive Card natif à un Nœud Say

1. Dans AI Agents (Cognigy), sélectionnez Créer > Flux.

2. Sélectionnez le Flux que vous souhaitez modifier, ou sélectionnez l'icône plus (+) à l'endroit où le nœud Say doit être ajouté.

3. Cliquez sur le nœud Say pour ouvrir le panneau Modifier le Nœud.

   Sous Canaux, assurez-vous que le Canal AI utilisé par Virtual Agent Hub est sélectionné. Ne sélectionnez pas le canal CXone lors de la création d'un Adaptive Card natif

4. Dans la liste déroulante Type de Sortie, sélectionnez Adaptive Card.

5. Dans le champ de définition JSON, collez le code JSON Adaptive Card de votre carte. Un lien au-dessus de ce champ ouvre le Microsoft Adaptive Card Designer, un outil visuel permettant de créer et de prévisualiser des cartes.

6. Dans Adaptive Card Designer, construisez ou collez votre disposition de carte, puis sélectionnez Copier la charge utile de la carte pour copier le JSON de la carte.

7. Retournez au nœud Say dans AI Agents (Cognigy) et collez le JSON copié dans le champ de définition JSON.

8. AI Agents (Cognigy) affiche un aperçu en direct de la carte directement sous le champ JSON afin que vous puissiez confirmer qu'elle est correcte.

9. Cliquez sur Enregistrer le Nœud pour enregistrer le nœud.

Utilisez une Variable de Contexte dans un Adaptive Card

Vous pouvez référencer une Variable de contexte dans une définition Adaptive Card afin que la carte affiche des données dynamiques telles que le nom du client ou le numéro de commande.

1. Assurez-vous que la Variable de contexte est renseignée avant l'exécution du nœud Say. La valeur peut être définie par un nœud Set Context ou par un autre processus dans le Flux qui renseigne le Contexte.

2. Ouvrez le nœud Say où le Adaptive Card est configuré.

3. Dans la définition JSON de la carte, référencez la Variable de contexte à l'aide de la syntaxe Variable de AI Agents (Cognigy) au point de la carte où la valeur doit apparaître.

   Syntaxe :

   {"type": "TextBlock",

   "text": "{{context.dynamicVariable}}"}

   Exemple :

   {"type": "TextBlock",

   "text": "{{context.account_number}}"}

4. Enregistrez le nœud et utilisez le Interaction Panel pour tester que la valeur de la Variable s'affiche correctement dans la carte.

   Pendant l'aperçu dans AI Agents (Cognigy), les Variables de contexte sont affichées comme des espaces réservés, car aucune valeur d'exécution n'a été fournie. La valeur réelle est substituée uniquement lorsque le Flux s'exécute et que la Variable de contexte est renseignée.

Testez le Adaptive Card dans NiCE CXone DX Chat

Une fois le nœud Say configuré et sauvegardé, vérifiez que la carte s'affiche correctement pour les utilisateurs finaux dans le canal de clavardage DX NiCE CXone.

1. Confirmez que AI Agents (Cognigy), le Virtual Agent Hub et le canal DX NiCE CXone sont entièrement configurés et liés.

2. Confirmez que le Flow est configuré pour déclencher le nœud Say contenant le Adaptive Card (par exemple, lorsqu'un utilisateur saisit un mot-clé précis).

3. Ouvrez le canal de clavardage DX NiCE CXone en tant qu'utilisateur final et envoyez le message ou le mot-clé qui déclenche la carte.

4. Confirmer que le Adaptive Card s'affiche comme prévu dans la fenêtre de clavardage.

Adaptive Card natif par rapport au JSON personnalisé sur le Canal NiCE CXone

Les options de Output Type disponibles dans un nœud Say dépendent du canal sélectionné. Cela peut porter à confusion lorsqu'un Flow utilise à la fois le canal natif AI (Virtual Agent Hub/canal de clavardage DX NiCE CXone) et un canal CXone.

• canal AI (natif, utilisé par Virtual Agent Hub et le clavardage DX NiCE CXone) : le nœud Say offre Adaptive Card comme Output Type dédié. Collez le JSON brut de la Adaptive Card directement, et AI Agents (Cognigy) affiche un aperçu en direct.

• canal CXone : le nœud Say n'offre pas d'option Adaptive Card. Sélectionnez plutôt Custom Json comme Output Type et enveloppez la définition de la carte dans la structure propre à NiCE CXone, avec les champs uiComponent, data et action.