Poser une question avec des cartes adaptatives

Les Cartes adaptatives permettent d’ajouter des extraits de contenu aux assistants Copilot Studio, qui peuvent également être partagés librement avec d’autres applications et services cloud. Pour fournir une fonctionnalité de conversation enrichie à votre assistant, vous pouvez inclure du texte, des graphiques et des boutons. Parce qu’elles sont indépendantes de la plateforme, vous pouvez facilement personnaliser les cartes adaptatives selon vos besoins.

Avec un nœud Carte adaptative, votre assistant peut afficher une carte adaptative contenant un ou plusieurs boutons d’envoi et, éventuellement, un ou plusieurs champs de saisie de formulaire. Votre assistant stocke les entrées utilisateur dans des variables en vue d’une utilisation ultérieure dans la conversation.

Copilot Studio comprend un concepteur de cartes adaptatives intégré, qui offre les fonctionnalités les plus utiles sous la forme du Concepteur de cartes adaptatives.

Sinon, vous pouvez :

• Utilisez une représentation JSON pour la carte que vous souhaitez afficher à l’utilisateur.
• Utilisez une formule Power Fx pour inclure des informations dynamiques sur la carte.

Vous pouvez également contrôler le comportement de la carte, par exemple ce qu’il faut faire lorsque l’utilisateur saisit une réponse non valide ou si le nœud peut être interrompu.

Le nœud Carte adaptative est destiné aux cartes interactives, lorsque l’utilisateur doit envoyer une réponse. Les nœuds Message et Question peuvent être utilisés pour présenter à l’utilisateur une carte non interactive pour afficher des informations à l’utilisateur.

Ajouter un nœud Carte adaptative

1. Sélectionnez l’icône Ajouter un nœud sous le nœud après lequel vous souhaitez ajouter un nœud Carte adaptative, puis sélectionnez Demander avec une carte adaptative.

2. Sélectionnez les trois points (...) du nœud, puis sélectionnez Propriétés.

3. Dans le volet Propriétés du nœud Carte adaptative, sélectionnez Modifier la carte adaptative. Le volet Concepteur de cartes adaptatives s’ouvre.

4. Ajoutez les éléments souhaités pour votre carte et configurez leurs propriétés. Sinon, dans le volet Éditeur de charge utile de carte, remplacez la charge utile par défaut par le littéral JSON de votre carte.

   Conseil

   Votre carte doit contenir au moins un bouton d’envoi, car il doit s’agir d’une carte interactive qui permet à un utilisateur de soumettre des informations à l’assistant. Si ce n’est pas le cas et qu’elle est uniquement destinée à afficher des informations, vous devez ajouter votre carte adaptative à un nœud Message.

5. Lorsque vous avez terminé la conception initiale, sélectionnez Enregistrer et fermez le volet du concepteur. Un aperçu de votre carte s’affiche sur le nœud. Copilot Studio crée automatiquement des variables de sortie en fonction des entrées spécifiées dans le code.

   

   Conseil

   Si les variables de sortie générées pour votre carte sont incorrectes, vous pouvez mettre à jour manuellement la liste des variables et leurs types en sélectionnant Modifier le schéma dans le volet Propriétés du nœud Carte adaptative.

   Votre carte adaptative interactive est maintenant prête. Lorsqu’un utilisateur de votre assistant sélectionne un bouton d’envoi sur une carte, les variables de sortie sont renseignées avec les informations fournies par l’utilisateur durant son interaction avec la carte.

Autres propriétés

D’autres propriétés vous permettent de contrôler le comportement du nœud Carte adaptative, telles que :

• Comment l’assistant répond à une réponse non valide
• S’il peut être interrompu

Si l’assistant attend un envoi d’une carte adaptative et que l’utilisateur envoie un message texte à la place, cette réponse est considérée comme non valide, à moins que le message déclenche une interruption. Dans ce cas, les propriétés suivantes déterminent le comportement.

• Nombre de nouvelles invites : le nombre de tentatives que votre assistant effectue pour obtenir une soumission valide à partir de la carte. Répéter jusqu’à 2 fois est la valeur par défaut. Vous pouvez également sélectionner Répéter une fois ou Ne pas répéter. À chaque nouvelle tentative, la carte est renvoyée à l’utilisateur.

• Nouvelle tentative d’invite : utilisez cette propriété pour définir un message à envoyer quand une nouvelle tentative se produit, ainsi qu’une répétition de la carte. Pour définir un message de nouvelle tentative, sélectionnez Personnaliser, puis saisissez la nouvelle invite.

• Autoriser le passage à une autre rubrique : si cette option est sélectionnée (par défaut), tout message entrant d’un utilisateur alors que l’assistant attend la soumission d’une carte déclenche une interruption et entraîne le basculement vers un autre sujet. Si un changement de sujet se produit, la carte est renvoyée à l’utilisateur une fois que le sujet ayant provoqué l’interruption est terminé.

Comportement du bouton d’envoi pour les assistants avec des cartes consécutives

Par conception, les cartes adaptatives permettent de sélectionner plusieurs fois leurs boutons d’envoi. Si un assistant comporte des cartes adaptatives consécutives et que l’utilisateur sélectionne un bouton sur une carte précédente, un comportement inattendu peut se produire.

Afin d’empêcher l’action d’envoi d’une carte d’interférer avec une autre :

• Isoler les actions de soumission : assurez-vous que chaque carte adaptative possède son propre identificateur unique et ses propres gestionnaires d’actions.

• Utilisez des actions d’envoi avec des données uniques : lors de la définition des actions d’envoi pour vos cartes, incluez des identifiants uniques ou des charges utiles de données afin de pouvoir différencier les cartes lorsque l’utilisateur clique sur un bouton d’envoi.

• Ajoutez une logique robuste de gestion des événements à votre assistant : définissez des conditions basées sur les identifiants distinctifs ou les éléments de charge utile associés à vos boutons d’envoi.

• Déboguer et consigner dans les journaux : ajoutez une journalisation détaillée au code de gestion des événements de votre assistant afin de capturer la séquence des actions et d’identifier les points où des soumissions involontaires se produisent.

Utiliser Power Fx pour rendre votre carte dynamique

Vous pouvez utiliser une formule Power Fx pour inclure des informations dynamiques sur votre carte en référençant des variables de votre rubrique ou de votre assistant.

1. Sélectionnez les trois points (...) du nœud, puis sélectionnez Propriétés.

2. Dans le panneau des propriétés du nœud Carte adaptative, basculez sur Formule. La sélection de Formule convertit automatiquement la représentation JSON de votre carte en une formule Power Fx.

   

   Par exemple, commencez par le littéral JSON suivant pour une carte :

   {
     "$schema": "http://adaptivecards.io/schemas/adaptive-card.json",
     "type": "AdaptiveCard",
     "version": "1.5",
     "body": [{
         "type": "ColumnSet",
         "columns": [{
             "type": "Column",
             "width": 2,
             "items": [{
                 "type": "TextBlock",
                 "text": "Tell us about yourself",
                 "weight": "Bolder",
                 "size": "Medium",
                 "wrap": true,
                 "style": "heading"
               }, {
                 "type": "TextBlock",
                 "text": "We just need a few more details to get you booked for the trip of a lifetime!",
                 "isSubtle": true,
                 "wrap": true
               }, {
                 "type": "Input.Text",
                 "id": "myName",
                 "label": "Your name (Last, First)",
                 "isRequired": true,
                 "regex": "^[A-Z][a-z]+, [A-Z][a-z]+$",
                 "errorMessage": "Please enter your name in the specified format"
               }
             ]
           }
         ]
       }
     ],
     "actions": [{
         "type": "Action.Submit",
         "title": "Submit"
       }
     ]
   }
   

   Voici la formule Power Fx résultante, en utilisant deux variables Topic.Title et Topic.Subtitle au lieu du texte codé en dur à partir du littéral JSON. (Cet exemple suppose que les variables sont définies dans votre rubrique.)

   {
     '$schema': "http://adaptivecards.io/schemas/adaptive-card.json",
     type: "AdaptiveCard",
     version: "1.5",
     body: [
       {
         type: "ColumnSet",
         columns: [
           {
             type: "Column",
             width: "2",
             items: [
               {
                 type: "TextBlock",
                 text: Topic.Title,
                 weight: "Bolder",
                 size: "Medium",
                 wrap: true,
                 style: "heading"
               },
               {
                 type: "TextBlock",
                 text: Topic.Subtitle,
                 isSubtle: true,
                 wrap: true
               },
               {
                 type: "Input.Text",
                 id: "myName",
                 label: "Your name (Last, First)",
                 isRequired: true,
                 regex: "^[A-Z][a-z]+, [A-Z][a-z]+$",
                 errorMessage: "Please enter your name in the specified format"
               }
             ]
           }
         ]
       }
     ],
     actions: [
       {
         type: "Action.Submit",
         title: "Submit"
       }
     ]
   }