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

Adaptive Cards vous permettent de présenter du contenu riche et structuré — comme du texte, des Images et des boutons Action — dans une conversation au lieu de texte brut. AI Agents (Cognigy) prend nativement en charge les Adaptive Cards via le nœud Say, afin que vous puissiez concevoir une définition de carte unique et l'afficher dans n'importe quel canal connecté via le Virtual Agent Hub, y compris les canaux de chat NiCE CXone DX pris en charge.

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

Avant de commencer

Assurez-vous que :

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

• Virtual Agent Hub configuré et connecté à votre projet AI Agents (Cognigy). Voir Configuration du bot de texte AI Agents (Cognigy) dans Virtual Agent Hub pour plus de détails.

• Un canal de chat 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 Build > 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'une Adaptive Card native

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

5. Dans le champ de définition JSON, collez le Adaptive Card JSON 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 le Adaptive Card Designer, créez ou collez la disposition de votre carte, puis sélectionnez Copier la charge utile de la carte pour copier le JSON de la carte.

7. Revenez 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 vérifier qu'elle s'affiche correctement.

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

Utiliser une Variable de Contexte dans un Adaptive Card

Vous pouvez référencer une Variable de contexte dans une définition de 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 du 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 AI Agents (Cognigy) à l'endroit 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 Panneau Interaction pour vérifier que la valeur de la variable s'affiche correctement dans la carte.

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

Test 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 chat NiCE CXone DX.

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 Flux est configuré pour déclencher le nœud Say contenant le Adaptive Card (par exemple, lorsqu'un utilisateur saisit un mot-clé spécifique).

3. Ouvrez le canal de chat NiCE CXone DX 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 chat.

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

Les options Sortie Type disponibles dans un nœud Say dépendent du canal que vous sélectionnez. Cela peut être une source de confusion lorsqu'un Flux utilise à la fois le canal natif AI (Virtual Agent Hub/ NiCE CXone DX chat) et un canal CXone.

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

• Canal CXone : le nœud Say ne propose pas d'Option Adaptive Card. Sélectionnez plutôt Custom Json comme type de Sortie et intégrez la définition de la carte dans la structure spécifique à NiCE CXone, avec les champs uiComponent, data et action.