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 d'action — dans une conversation, à la place du texte brut. AI Agents (Cognigy) prend en charge nativement Adaptive Cards via le nœud Say, de sorte que vous puissiez concevoir une seule définition de carte et l'afficher dans n'importe quel canal connecté via le Virtual Agent Hub, y compris les canaux de chat DX NiCE CXone pris en charge.

Tous les canaux de chat DX ne prennent pas en charge Adaptive Cards. Par exemple, certains canaux de messagerie tels que WhatsApp peuvent ne pas prendre en charge les Cartes adaptatives.

Ce sujet explique comment ajouter une Adaptive Card native à un nœud Say, référencer une variable de contexte à l'intérieur de 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). Consultez Setup AI Agents (Cognigy) Text Bot in 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 IA 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 Adaptive Card JSON de votre carte. Un lien au-dessus de ce champ ouvre 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 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 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 Adaptive Card afin que la carte affiche des données dynamiques, telles que le nom du client ou un numéro de commande.

  1. Veillez à ce que la variable de contexte soit 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 en utilisant la syntaxe AI Agents (Cognigy) Variable 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 vérifier 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 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 Adaptive Card dans DX Chat NiCE CXone

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 DX NiCE CXone en tant qu'utilisateur final et envoyez le message ou le mot-clé qui déclenche la carte.

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

JSON 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 IA natif (Virtual Agent Hub/ NiCE CXone DX chat) et un canal CXone.

  • Canal IA (natif, utilisé par Virtual Agent Hub et NiCE CXone DX chat) : 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.

  • Choisissez le Type de Sortie qui correspond au canal sélectionné sur le nœud Say. Une carte créée pour le type de sortie du canal IA Adaptive Card ne s'affichera pas correctement si elle est collée dans le champ Custom Json d'un canal CXone sans l'adapter à la structure uiComponent/data/action, et vice versa.

  • Les implémentations CXone Custom Json existantes continuent de fonctionner et ne sont pas supprimées. Toutefois, les nouvelles implémentations doivent utiliser la sortie Adaptive Card native dans la mesure du possible, car elle est plus simple à configurer, ne nécessite pas le wrapper/en-tête spécifique à CXone, et fournit un aperçu en direct dans le nœud Say.