Ajouter la réponse de l’agent avec le concepteur de formulaires (version préliminaire)

[Cet article fait partie de la documentation en version préliminaire et peut faire l’objet de modifications.]

Ajoutez le composant de réponse de l’agent à un formulaire d’application pilotée par modèle, qui peut appeler directement une rubrique Microsoft Copilot Studio et afficher la réponse à l’utilisateur. Ce composant s’appuie sur l’API d’assistant executeEvent et simplifie l’utilisation en ne nécessitant pas de nouveau composant personnalisé. Le contexte implicite de l’application, de la page et de l’enregistrement est disponible dans Copilot Studio.

Ce composant prend en charge les réponses suivantes de Copilot Studio :

  • Markdown
  • Carte adaptative
  • Image
  • Video

Important

  • Cette fonctionnalité est en version préliminaire.
  • Les fonctionnalités en version préliminaire ne sont pas destinées à une utilisation en production et peuvent être restreintes. Ces fonctionnalités sont soumises à des conditions d’utilisation supplémentaires, et sont disponibles avant une version officielle de telle sorte que les clients puissent tirer parti d’un accès anticipé et fournir leurs commentaires.

Prérequis

Nécessite que le paramètre d’environnement Autoriser les utilisateurs à analyser des données à l’aide d’une expérience de conversation instantanée optimisée par l’IA dans les applications canevas et pilotées par modèle soit activé pour les applications pilotées par modèle. Pour plus d’informations, voir Paramètres de l’environnement Copilot

Ajouter un composant de réponse de l’agent à un formulaire

  1. Ouvrez le concepteur de formulaires pour créer ou modifier un formulaire. Pour plus d'informations : Créer un formulaire ou Modifier un formulaire

  2. Dans le concepteur de formulaires, sélectionnez Composant sur la barre de commandes.

  3. Dans le volet Composants, développez Intelligence artificielle

  4. Faites glisser Réponse de l’agent sur le canevas du formulaire.

    Réponse de l’agent dans le volet Composants.

  5. Dans la boîte de dialogue Ajouter la réponse de l’agent, entrez le Nom de l’événement à partir de la rubrique dans Copilot Studio dans la zone Valeur statique. Pour plus d’informations, voir Rechercher le nom de l’événement pour une rubrique dans Copilot StudioConfigurer le nom de l’événement de réponse de l’agent

    Nonte

    L’option Lier à la colonne de la table n’est pas prise en charge pour ce composant.

  6. Sélectionnez Enregistrer et publier sur la barre de commandes.

  7. Ouvrez le formulaire dans une application pilotée par modèle pour tester le composant.

    Nonte

    L’aperçu du concepteur de formulaires affiche le message d’avertissement « La réponse de l’agent n’est disponible que lorsque vous lancez l’application », car l’aperçu en direct n’est pas encore pris en charge.

Rechercher le nom de l’événement pour une rubrique dans Copilot Studio

  1. Ouvrez la rubrique dans Copilot Studio et recherchez le nœud Déclencheur.

  2. Vérifiez que le type de déclencheur est Un événement client personnalisé se produit ou Événement reçu.

  3. Dans le nœud Déclencheur, sélectionnez Modifier.

    Déclencher un événement client personnalisé de Copilot Studio.

  4. Dans le volet Propriétés de l’activité de l’événement, copiez la valeur de la chaîne de la propriété Nom de l’événement à transmettre à partir du composant de réponse de l’agent. Pour plus d’informations, voir Modifier le déclencheur d’une rubrique

    Volet des propriétés Déclencher en cas d’événement de Copilot Studio

Accès au contexte de l’application

Lorsque le composant de réponse de l’agent appelle la rubrique Copilot Studio, il transmet le contexte de l’application via un ensemble de variables. Voici les variables de contexte disponibles en tant que variables globales Copilot Studio.

Variable Description
Global.PA__Copilot_Model_PageContext.pageContext.id.guid ID de l’enregistrement de table dans le formulaire principal
Global.PA__Copilot_Model_PageContext.pageContext.entityTypeName Nom logique de la table dans la page principale
Global.PA__Copilot_Model_PageContext.pageContext.pageName Nom de la page principale
Global.PA__Copilot_Model_PageContext.pageContext.pageType Type de la page principale
Global.PA__Copilot_Model_AppUniqueNameContext.appUniqueNameContext.appUniqueName Nom unique de l’application pilotée par modèle

Accessibilité

Lorsque la réponse de Copilot Studio est une carte adaptative, assurez-vous que les pratiques recommandées suivantes sont suivies pour offrir une expérience accessible.

Limites

  • Les propriétés du composant de réponse de l’agent ne sont actuellement pas prises en charge :

    • Label
    • Masquer l’étiquette
    • Masquer sur téléphone
    • Verrouiller
    • Read-only
    • Largeur du composant
    • Hauteur du composant
    • Lier à la colonne de table

  • Le composant de réponse de l’assistant ne prend pas en charge la transmission de contexte supplémentaire vers Copilot Studio. Créez un composant personnalisé à l’aide de l’API d’assistant executeEvent pour prendre en charge la transmission de plus de contexte.

  • Le composant de réponse de l’agent ne prend en charge que la carte adaptative en lecture seule. Créez un composant personnalisé à l’aide de l’API d’assistant executeEvent pour prendre en charge la logique côté client.

  • Le composant de réponse de l’agent n’est pas pris en charge pour les appareils mobiles ou les tablettes.

FAQ sur les API d’agent et le composant de réponse de l’assistant

API d’agent executeEvent

Présentation du concepteur de formulaires pilotés par modèle
Ajouter, configurer, déplacer ou supprimer des composants sur un formulaire

  • Last updated on