Ajouter des outils aux assistants personnalisés

Les outils sont les blocs élémentaires qui permettent à votre agent d’interagir avec des systèmes externes. Les outils étendent les fonctionnalités de votre assistant, ce qui lui permet d’effectuer différentes actions en réponse aux demandes utilisateur ou aux déclencheurs autonomes. Chaque outil représente une fonctionnalité spécifique que votre assistant peut effectuer. Par exemple, vous pouvez équiper votre assistant avec des outils tels que :

• Envoyer des courriers électroniques à l’aide du connecteur Office 365 Outlook
• Consulter les conditions météorologiques actuelles et les prévisions
• Lire et écrire des données à partir de Dataverse
• Lire et publier des messages dans Teams

Mécanismes d’ajout d’outils

Vous pouvez étendre les capacités de votre assistant personnalisé en ajoutant un ou plusieurs outils. Votre assistant peut utiliser des outils pour répondre automatiquement aux utilisateurs, grâce à l’orchestration générative. Vous pouvez également appeler des outils de manière explicite depuis une rubrique.

Grâce à l’orchestration (active par défaut), votre assistant peut sélectionner automatiquement l’outil ou la rubrique qui convient le mieux, ou effectuer une recherche dans les articles de la base de connaissances, pour répondre à un utilisateur. Ce mode d’orchestration crée une expérience de conversation plus dynamique et intelligente.

En mode classique (orchestration générative désactivée), un assistant peut uniquement utiliser des rubriques pour répondre à l’utilisateur. Toutefois, vous pouvez toujours concevoir votre assistant pour qu’il appelle explicitement les outils à partir des rubriques.

Vous disposez de plusieurs mécanismes pour ajouter des outils à votre assistant :

• Connecteur : connectez-vous à des API et services propriétaires à l’aide de Connecteurs Power Platform pour extraire des données ou effectuer des actions.
  • Connecteur prédéfini : choisissez parmi une sélection de connexions prédéfinies à des milliers d’API populaires provenant de services Microsoft et non Microsoft.
  • Connecteur personnalisé : définissez une connexion à un service ou un système personnalisé pour activer les options d’outils personnalisés à l’aide des connecteurs Power Platform. Le connecteur a besoin d’autorisations d’affichage et de partage pour l’organisation pour que l’assistant utilise le connecteur.
• Flux d’assistant : définissez un flux d’assistant, incluant une ou plusieurs actions à réaliser.
• Invite : invite basée sur un modèle à tour unique qui peut référencer les connaissances que vous fournissez et générer du code pour analyser les données.
• API REST : définissez une connexion à une API REST et sélectionnez un ou plusieurs points de terminaison et méthodes d’API à ajouter en tant qu’outils.
• Protocole de contexte de modèle (MCP) : connectez-vous à un serveur MCP pour accéder aux outils et aux ressources.
• Utilisation de l’ordinateur : permet à votre assistant d’interagir avec n’importe quel système doté d’une interface utilisateur graphique, pour les sites web et les applications de bureau, en sélectionnant des boutons, en choisissant des menus et en saisissant du texte dans les champs à l’écran.

Il existe deux autres mécanismes que vous pouvez utiliser pour ajouter un comportement de type outil à votre assistant :

• Compétences : conteneur pour un ensemble d’outils connexes.
• Outil client : envoyer une activité d’événement au client afin que celui-ci effectue une action et renvoie une réponse.

Pour plus d’informations sur les compétences et les outils client, consultez les liens dans la section Contenu connexe.

Créer et ajouter un nouvel outil au niveau de l’assistant

La création d’outils directement dans Copilot Studio simplifie le processus de développement et garantit une intégration appropriée à votre assistant. Les outils ajoutés à un assistant sont disponibles pour l’orchestration automatique tout au long des conversations de votre assistant.

1. Ouvrez votre agent en choisissant Agents dans le volet de navigation de gauche et en sélectionnant votre agent dans la liste.

2. Accédez à la page Outils pour votre assistant.

3. Sélectionnez Ajouter un outil.

4. Dans le volet Ajouter un outil, sélectionnez Nouvel outil.

5. Sélectionnez le type d’outil que vous souhaitez ajouter dans la liste qui s’affiche :

   • Invite
   • Flux d’assistant
   • Utilisation de l’ordinateur
   • Connecteur personnalisé
   • Protocole de contexte de modèle
   • API REST

   

6. Effectuez les étapes de configuration spécifiques au type d’outil que vous avez sélectionné. Par exemple, si vous sélectionnez Invite, vous devez effectuer les étapes suivantes :

   • Définir le modèle d’invite et les instructions
   • Spécifier les paramètres d’entrée
   • Configurer les sources de la base de connaissances
   • Définir le format de réponse et les contraintes

7. Sélectionnez Enregistrer ou Publier, le cas échéant, pour créer l’outil.

8. Sélectionnez Ajouter et configurer. L’outil est ajouté à votre assistant. La page de configuration de votre outil s’affiche. Vous pouvez afficher et apporter des modifications à la configuration de votre outil ici.

Vous pouvez voir le nouvel outil dans la page Outils de l’assistant.

Afficher et apporter des modifications à la configuration de votre outil

Vous pouvez afficher et modifier la configuration de votre outil à tout moment : accédez à la page Outils de votre assistant, puis sélectionnez l’outil dans la liste des outils.

La page de configuration de votre outil s’ouvre. Les détails sont affichés dans trois sections :

• Détails
• Entrées
• Achèvement

Pour les serveurs MCP connectés en tant qu’outils d’assistant, la page de configuration diffère des autres types d’outils. La section Détails est similaire, mais au lieu des sections Entrées et Achèvement, vous trouverez les sections Outils et Ressources avec des informations sur les outils et ressources disponibles pour le serveur MCP. Pour plus d’informations, consultez Afficher les outils et les ressources dans un serveur MCP existant.

Détails

La section Détails vous permet de configurer les détails de base de votre outil.

Ici, vous pouvez afficher et mettre à jour :

• Nom : nom de l’outil. Ce nom apparaît dans la liste des outils de votre assistant. Choisissez un nom qui indique clairement la fonction de l’outil.

• Description : description de l’outil. L’orchestration générative s’appuie sur cette description pour déterminer quand votre assistant doit utiliser l’outil. Écrivez des descriptions claires, spécifiques, notamment sur ce que fait l’outil et quand il doit être utilisé.

• Détails supplémentaires :

  • Autoriser l’assistant à décider dynamiquement quand utiliser l’outil : lorsque cette option est sélectionnée, l’assistant peut utiliser l’orchestration générative pour déterminer quand utiliser l’outil. Si cette option n’est pas sélectionnée, l’assistant utilise uniquement l’outil lorsqu’il est explicitement appelé à partir d’une rubrique. (Par défaut, cette option est sélectionnée lorsque l’orchestration générative est activée.)
  • Demander à l’utilisateur final avant d’exécuter : dans l’expérience de conversation instantanée de l’utilisateur final, demandez confirmation à l’assistant avant d’exécuter l’outil. Cette option est définie sur Non par défaut.
  • Authentification : indiquez s’il faut utiliser les informations d’identification de l’utilisateur (Utilisateur final) ou du créateur (Fourni par le créateur) pour l’outil. Par défaut, l’authentification utilisateur s’applique.
  • Description : si vous le souhaitez, vous pouvez ajouter une description de l’outil que l’assistant affiche à l’utilisateur quand il souhaite exécuter l’outil. Cette description permet à l’utilisateur de savoir ce qu’il est invité à authentifier.

Entrées

Ici, vous pouvez afficher et configurer les entrées de votre outil. Les entrées sont utilisées pour collecter des informations de l’utilisateur afin de remplir les entrées requises pour l’outil. Les informations sont affichées sous la forme d’une table, une ligne pour chaque entrée.

Par défaut, la valeur de la colonne Remplir à l’aide de pour chaque entrée est définie sur Remplissage dynamique avec l’IA. L’agent tente d’extraire la valeur du contexte disponible, par exemple 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. Sélectionnez Personnaliser pour accéder à des personnalisations plus détaillées pour la collecte et le remplissage des entrées :

• Nom d’affichage et description : comment l’entrée est présentée à l’utilisateur.
• Identifier en tant que : comment la réponse de l’utilisateur est interprétée, par exemple en tant que chaîne de texte ou mappée à une entité prédéfinie.
• Logique de nouvelle tentative : si l’assistant n’identifie pas d’entité dans l’instruction de l’utilisateur, il peut poser à nouveau la question.
• Validation d’entrée : configurez un comportement de validation supplémentaire sur l’entrée de l’utilisateur, au-delà de la valeur par défaut prévue pour le type d’entité.

Vous pouvez également choisir de remplacer une entrée par une valeur explicite au lieu de laisser l’assistant l’extraire. Pour définir un remplacement, définissez Remplir à l’aide de sur Valeur personnalisée, puis saisissez une valeur, sélectionnez une variable ou utilisez une formule Power Fx. Si une entrée est remplacée, l’assistant ne demande pas de valeur à l’utilisateur.

Achèvement

Ici, vous pouvez sélectionner ce que vous souhaitez faire lorsque l’outil est en cours d’exécution.

Vous pouvez faire en sorte que l’assistant génère automatiquement une réponse contextuelle pour un utilisateur, en fonction de sa requête et du résultat de l’outil.

Vous pouvez également choisir de créer une réponse spécifique et formatée pour que votre outil la retourne. Vous pouvez insérer des références aux variables de sortie depuis l’outil à l’aide du sélecteur de variables. Vous pouvez également utiliser des formules Power Fx pour mettre en forme la réponse.

Sous Après l’exécution, sélectionnez l’une des différentes options pour savoir la façon dont l’outil doit répondre à l’utilisateur après l’exécution de l’outil :

• Ne pas répondre (par défaut) : l’assistant incorpore la sortie de l’outil dans sa réponse
• Rédiger la réponse avec l’IA générative : laissez l’IA élaborer une réponse contextuelle en utilisant les sorties de l’outil
• Envoyer une réponse spécifique : créer une réponse basée sur un modèle avec insertion de variables
• Envoyer une carte adaptative : créer des réponses riches et interactives avec des boutons et des actions

Vous pouvez également configurer les variables de sortie à mettre à la disposition de l’assistant et d’autres outils.

Sélection d’outils et collecte d’entrées

Lorsque vous définissez un outil dans Copilot Studio, vous fournissez également des informations qui décrivent son objectif. Ces informations permettent à l’assistant d’identifier quand utiliser l’outil. La description de l’outil aide également l’orchestrateur à utiliser l’IA générative pour générer des questions, si nécessaire, pour collecter des entrées. Votre assistant peut utiliser des questions pour collecter des informations afin de renseigner les entrées nécessaires à l’utilisation de l’outil. Par conséquent, vous n’avez pas besoin de créer manuellement des nœuds Question pour recueillir toutes les entrées nécessaires telles que les entrées dans un flux. L’orchestrateur de l’assistant gère la collecte d’entrée pour vous au moment de l’exécution.

L’assistant considère plusieurs facteurs pour déterminer la sélection de l’outil :

• Nom et description de l’outil
• Contexte de la conversation actuelle
• Intention de l’utilisateur dérivée de son message
• Entrées et sorties disponibles
• Utilisation de l’outil précédent dans la conversation

Lors de l’utilisation du mode génératif, par défaut, les outils renvoient leurs informations à l’assistant. Avec la réponse de l’outil, l’assistant peut générer une réponse contextuelle à la requête de l’utilisateur. Vous pouvez également demander à votre outil de toujours répondre immédiatement, soit en générant un message, soit en créant un message explicite.

Appeler un outil existant à partir d’une rubrique

Vous pouvez appeler un outil explicitement à partir d’une rubrique. En fonction de votre cas d’utilisation, vous pouvez utiliser votre outil dans le cadre d’une rubrique plus large, qui utilise plus de nœuds. Ou, comme dans l’exemple de la météo, l’ajout d’un nœud à une rubrique peut suffire.

Pour appeler un outil à partir d’une rubrique :

1. Dans Copilot Studio, accédez à la page Rubriques pour l’assistant que vous souhaitez modifier.

2. Créez une rubrique et donnez-lui un nom, par exemple Connaître la météo.

3. Ajoutez les phrases déclencheur appropriées. Pour continuer avec le même exemple sur la météo de l’étape précédente, les phrases déclencheur peuvent inclure :

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

4. Sélectionnez Ajouter un nœud (+), puis sélectionnez Ajouter un outil. Sélectionnez l’outil dans les outils disponibles. Il existe trois onglets montrant différents types d’outils :

   • Outils de base
   • Connecteur
   • Outil

   Votre nœud Action est maintenant ajouté à votre rubrique.

5. Cliquez sur Enregistrer.

Informations sur le connecteur MCP

Pour le connecteur MCP, vous pouvez afficher les noms et descriptions des outils et ressources MCP mis à disposition par le connecteur MCP. Les informations relatives aux outils et ressources sont affichées dans une table, une ligne pour chaque outil.

Considérations relatives à l’authentification pour les outils

Certains outils nécessitent une authentification pour fonctionner correctement, comme l’invite dynamique ou d’autres outils qui appellent une API Dataverse. Une configuration d’authentification appropriée garantit la sécurité tout en conservant une expérience utilisateur fluide.

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

• Informations d’identification de l’utilisateur final : l’assistant utilise les informations d’identification de l’utilisateur pour s’authentifier auprès du service. Cette méthode garantit que les utilisateurs n’accèdent qu’aux données qu’ils sont autorisés à consulter.
• Informations d’identification fournies par le créateur : l’assistant utilise les informations d’identification de son auteur pour s’authentifier auprès du service. Utilisez ce mode d’authentification pour les ressources partagées ou lorsque les utilisateurs n’ont pas besoin d’un accès individuel.

Tester votre outil

Avec l’orchestration générative, l’orchestrateur sélectionne votre outil lorsqu’il considère que celui-ci est pertinent pour une requête utilisateur.

Vous pouvez également appeler un outil existant à partir d’une rubrique.

Activer ou désactiver un outil dans votre assistant

Vous pouvez activer ou désactiver un outil pour votre assistant à partir de la page de configuration de l’outil. La désactivation d’un outil empêche l’assistant d’utiliser l’outil, mais celui-ci est toujours connecté à l’assistant et peut être désactivé ultérieurement. Lorsque vous ajoutez un outil à un assistant, il est activé par défaut.

Pour désactiver un outil dans un assistant :

1. Accédez à votre assistant et sélectionnez la page Outils de votre assistant.
2. Sélectionnez l’outil pour accéder à la page de configuration de l’outil.
3. En haut de la page de configuration, désactivez l’outil à l’aide du bouton bascule Activé.
4. Cliquez sur Enregistrer pour appliquer les modifications.

L’outil apparaît toujours dans la liste des outils de l’assistant, mais il n’est plus activé.

Supprimer un outil de votre assistant

La désactivation d’un outil empêche l’utilisation de l’outil, mais vous offre également la possibilité de le réactiver ultérieurement. Vous pouvez également supprimer un outil de votre assistant de manière définitive. Pour supprimer un outil de votre assistant :

1. Accédez à votre assistant et sélectionnez la page Outils de votre assistant.
2. Recherchez l’outil dans la liste des outils, puis survolez le nom de l’outil. Sélectionnez les trois points (...).
3. Sélectionnez Supprimer. Une fenêtre de confirmation s’ouvre.
4. Sélectionnez Supprimer pour supprimer l’outil.

L’outil disparaît de la liste des outils de l’assistant.

Contenu associé

• Utiliser des connecteurs
• Utiliser des invites
• Utiliser les flux d’assistant avec votre assistant
• Protocole de contexte de modèle (MCP)
• Ajouter des outils à partir d’une API REST
• Utiliser les compétences
• Outils pour les clients
• Utilisation de l’ordinateur (version préliminaire)