Utiliser des actions avec des copilotes personnalisés (version préliminaire)

Vous pouvez étendre les capacités de votre copilote en ajoutant une ou plusieurs actions. Les actions sont utilisées par votre copilote pour répondre automatiquement aux utilisateurs, à l’aide d’actions génératives, ou vous pouvez les appeler explicitement depuis une rubrique.

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

Types d’actions principales

Si vous activez le mode génératif, votre copilote peut sélectionner automatiquement l’action ou la rubrique la plus appropriée pour répondre à un utilisateur au moment de l’exécution.

En mode classique, un copilote ne peut utiliser que des rubriques pour répondre à l’utilisateur. Cependant, vous pouvez toujours concevoir votre copilote pour qu’il appelle explicitement des actions à partir des rubriques.

Les actions sont basées sur l’un des types d’actions principales suivants :

• Action de connecteur prédéfinie
• Action connecteur personnalisé
• Flux de cloud Power Automate
• Invites AI Builder
• Compétence Bot Framework

Chaque action principale contient des informations supplémentaires qui décrivent son objectif, ce qui permet au copilote d’utiliser l’IA générative pour générer des questions. Ces questions sont nécessaires pour remplir les entrées nécessaires à l’exécution de l’action. Ainsi, il n’est pas nécessaire de créer manuellement des nœuds de questions pour rassembler toutes les entrées nécessaires, telles que les entrées d’un flux. Les entrées sont gérées pour vous pendant l’exécution.

Les actions peuvent générer une réponse contextuelle à la requête d’un utilisateur, en utilisant les résultats de l’action. Vous pouvez également créer explicitement une réponse pour l’action.

Ajouter une action

1. Ouvrez votre copilote personnalisé en choisissant Copilotes dans le volet de navigation de gauche et en sélectionnant votre copilote dans la liste.

2. Sélectionnez Actions pour voir les actions pour le copilote.

3. Sélectionnez + Ajouter une action.

4. Dans l’assistant Choisir une action (version préliminaire), recherchez une action que vous souhaitez utiliser et sélectionnez-la.

   La liste par défaut affichée contient les flux et les connecteurs personnalisés Power Automate disponibles dans votre environnement. Cette liste comprend les connecteurs prédéfinis couramment utilisés et les compétences Bot Framework enregistrées auprès de votre copilote.

   

   Important

   Certaines actions créées à partir de plug-ins d’IA, telles que les invites dynamiques et celles basées sur les API Dataverse, nécessitent une authentification.

   

   En fonction de l’action, votre connexion est automatiquement configurée, comme le montre l’exemple. Sinon, vous devez configurer la connexion si les instructions sont fournies dans l’Assistant. Une fois votre connexion configurée avec succès, sélectionnez Suivant.

   

5. Examinez et apportez des modifications à la configuration de vos actions de plug-in, si nécessaire. Sélectionnez Terminer pour ajouter l’action à votre copilote.

   Sélectionnez Suivant.

Appeler une action

Si vous avez activé les actions génératives, votre action est appelée automatiquement en réponse à une requête pertinente de l’utilisateur.

Sinon, vous pouvez appeler une action explicitement depuis une rubrique.

Tester votre action

Appel d’une action

Votre copilote sélectionne et exécute votre action en fonction du nom et de la description. Vous pouvez créer des descriptions de haute qualité, en utilisant le mode de suivi dédié pour voir quelles actions votre copilote a sélectionnées dans la page des actions génératives.

Sinon, si vous avez ajouté une action à une rubrique, vous pouvez la tester en saisissant un message similaire à l’une des phrases déclencheurs pour cette rubrique.

Vous pouvez voir une action météorologique en cours de test dans cette capture d’écran :

Sinon, si vous avez ajouté une action à une rubrique, vous pouvez la tester en déclenchant votre rubrique avec une phrase déclencheur appropriée.

Configuration des entrées et des sorties pour une action

Apporter des modifications à la configuration de votre action

Il existe de nombreuses façons de configurer votre action. À la dernière étape de l’assistant d’action, appelée Réviser et terminer, vous pouvez apporter des modifications à la configuration de votre action en cliquant sur Modifier en regard de la section appropriée.

Détails de l’action

Ici, vous pouvez configurer les détails sur votre action, y compris le Nom complet du modèle et la Description du modèle pour votre action. Habituellement, le nom et la description sont pré-remplis pour vous en fonction de l’action que vous avez sélectionnée.

Les propriétés Nom complet et Description pour chaque entrée aident le copilote à comprendre l’objectif de l’entrée, à générer une question appropriée pour l’utilisateur et à reconnaître la valeur correcte dans la réponse d’un utilisateur. Par exemple, voici le nom par défaut et la description du paramètre d’entrée de l’emplacement pour le connecteur MSN Météo.

• Nom : emplacement
• Description : requête de recherche de l’emplacement. Les entrées valides sont Ville, Région, État, Pays, Repère, Code postal, Latitude et Longitude

Lorsqu’il demande un emplacement à l’utilisateur, le copilote génère une question similaire à, Pour quel emplacement souhaitez-vous consulter la météo ? Vous pouvez saisir une ville, une région, un état, un pays, un repère ou un code postal.

Vous pouvez modifier l’option Identifier comme en un type d’entité spécifique, en fonction de l’entrée collectée, ce qui peut aider le copilote à extraire avec précision une valeur à partir de la réponse d’un utilisateur.

Par défaut, chaque entrée est définie sur Remplir dynamiquement avec la meilleure option. Le copilote essaie de renseigner la valeur à partir du contexte disponible, par exemple en extrayant une valeur du message de l’utilisateur. Si aucune valeur appropriée n’est trouvée, il génère une question pour demander une valeur à l’utilisateur. Vous pouvez remplacer une entrée par une valeur au lieu de demander à l’utilisateur. Pour ce faire, modifiez la liste déroulante Comment le copilote remplira-t-il cette entrée ? en Définir comme une valeur, puis saisissez une valeur. Cette valeur peut être une valeur littérale, une variable existante ou une formule Power Fx.

Pour contrôler le comportement de votre copilote lors de la demande d’une valeur ou de la validation de la réponse d’un utilisateur, vous pouvez configurer des paramètres supplémentaires pour les entrées.

Sorties

Par défaut, votre action est configurée pour générer automatiquement une réponse contextuelle pour un utilisateur, en fonction de sa requête et du résultat de l’action. Par exemple, si un utilisateur demande : « Quelle est la température actuelle à Londres ? », une réponse contextuelle est générée à l’aide de GPT, telle que « La température actuelle à Londres est de 9 degrés Celsius ».

Vous pouvez également choisir de créer une réponse spécifique que votre action doit renvoyer. Comme avec l’éditeur de confirmation, vous pouvez insérer des références aux variables de sortie de l’action à l’aide du sélecteur de variable, comme la variable présentée dans cet exemple.

Appeler une action depuis une rubrique

Vous pouvez appeler une action explicitement à partir d’une rubrique, de la même manière que vous appelez d’autres types d’actions comme des flux Power Automate. En fonction de votre cas d’utilisation, vous pouvez utiliser votre flux dans le cadre d’une rubrique plus large, qui utilise plus de nœuds. Ou bien, comme dans l’exemple météorologique, l’ajout d’un nœud d’action unique à une rubrique peut être tout ce dont vous avez besoin.

Pour appeler une action depuis une rubrique :

1. Dans Copilot Studio, accédez à la page Rubriques pour le copilote que vous souhaitez modifier.

2. Créez un nouveau sujet et nommez-la Obtenir la météo.

3. Ajoutez les phrases déclencheurs suivantes :

   • va-t-il pleuvoir ?
   • prévisions d’aujourd’hui
   • obtenir la météo
   • quel temps fait-il ?

   

4. Sélectionnez Ajouter un nœud (+), puis sélectionnez Appeler une action. Accédez à l’onglet Actions du plug-in (version préliminaire), puis sélectionnez l’action que vous avez créée précédemment, Obtenir les prévisions météorologiques.

   

5. Votre nœud Action du plug-in (version préliminaire) est maintenant ajouté à votre rubrique.

   

6. Sélectionnez Enregistrer.

Remplacer les entrées lors de l’appel d’une action depuis une rubrique

Par défaut, lorsque votre action s’exécute, votre copilote génère des questions permettant à l’utilisateur de renseigner les entrées requises. Cependant, vous souhaiterez peut-être remplacer une ou plusieurs entrées et fournir une valeur explicite au lieu de demander à l’utilisateur. Vous pouvez le faire dans la configuration de l’action du plug-in dans la section Entrées. Ou bien, vous pouvez remplacer les valeurs uniquement lorsque votre action est utilisée à partir d’une rubrique spécifique :

1. Sélectionnez Définir la valeur sur le nœud et choisissez l’entrée que vous souhaitez remplacer.

   

2. Saisissez la valeur de l’entrée en saisissant une valeur, en sélectionnant une variable ou en utilisant une formule.

   

Maintenant que cette entrée est remplacée, le copilote ne demande plus de valeur à l’utilisateur.

Activer l’authentification pour les actions d’IA

Certaines actions, lorsqu’elles sont créées sur la base d’actions d’IA, nécessitent une authentification pour fonctionner correctement, comme l’invite dynamique ou d’autres qui appellent une API Dataverse.

Les actions sont toujours exécutées dans le runtime Microsoft Copilot dans le contexte de l’utilisateur final et ne peuvent être exécutées que si l’authentification est activée. Deux types de méthodes d’authentification sont pris en charge :

1. Accédez aux propriétés de l’action du connecteur.

2. Sous Authentification de l’utilisateur final, sélectionnez Authentification de l’auteur du copilote.

3. Publiez et testez l’expérience dans le volet de test du copilote ou dans le canal souhaité.

   

Utiliser les actions de flux avec les informations d’identification de l’utilisateur final

Les actions de flux peuvent être configurées pour utiliser les informations d’identification de l’utilisateur final. Si vous utilisez le flux dans un canal pris en charge, cela ne nécessite aucune configuration spéciale dans la boîte de dialogue de votre copilote, et les utilisateurs finaux peuvent gérer leurs connexions pour un flux donné dans une expérience fournie.

Authentification pour les actions basées sur des plug-ins dans votre bibliothèque

Lorsqu’elles sont créées sur la base de plug-ins d’IA, les actions nécessitent une authentification pour fonctionner correctement. Ce comportement est le plus souvent observé avec les actions basées sur des invites ou d’autres qui appellent des API Dataverse. Les actions basées sur des plug-ins sont toujours exécutées dans le contexte de l’utilisateur final et ne peuvent être exécutées que si l’authentification est activée. Deux types de méthodes d’authentification sont pris en charge :

• Authentification intégrée (Teams et Power Apps) : vous pouvez utiliser cette méthode d’authentification si vous souhaitez publier votre copilote sur un canal Teams. Cette méthode fonctionne également pour les copilotes incorporés dans toute application Power Platform qui utilise des jetons créés avec la norme PPAPI.

• Authentification manuelle (copilotes tiers) : cette méthode d’authentification implique la configuration d’une connexion Microsoft Entra ID.

Pour créer une connexion avec authentification manuelle :

1. Configurez une application Microsoft Entra ID.

2. Configurez l’authentification manuelle pour votre copilote Copilot Studio.

3. Autorisez votre application à utiliser la délégation pour récupérer un jeton au nom de l’utilisateur. Assurez-vous d’ajouter toutes les portées nécessaires.