Partager via

Ajouter des outils aux assistants personnalisés

Les outils sont des éléments de construction qui permettent à votre agent d’interagir avec des systèmes externes. Les outils élargissent ce que votre agent peut faire, lui permettant d’effectuer diverses actions en réponse aux demandes des utilisateurs ou aux déclencheurs autonomes. Chaque outil représente une fonctionnalité spécifique que votre agent peut effectuer. Par exemple, vous pouvez équiper votre agent d’outils pour effectuer des tâches telles que :

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

Mécanismes pour ajouter des outils aux agents

Vous pouvez étendre les fonctionnalités de votre agent personnalisé en ajoutant un ou plusieurs outils. Votre agent peut utiliser des outils pour répondre automatiquement aux utilisateurs à l’aide de l’orchestration générative. Vous pouvez aussi appeler des outils explicitement depuis un même sujet.

Avec l’orchestration générative (active par défaut), votre agent peut sélectionner automatiquement l’outil ou la rubrique le plus approprié, ou effectuer une recherche dans l’ensemble des 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 agent peut uniquement utiliser des rubriques pour répondre à l’utilisateur. Cependant, vous pouvez toujours concevoir votre agent pour appeler des outils explicitement depuis des rubriques.

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

  • 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 à partir des services Microsoft et non-Microsoft.
    • Connecteur personnalisé : définissez une connexion à un service ou un système personnalisé pour activer des options d’outil personnalisées à l’aide de 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 agent :

  • Compétences : conteneur pour un ensemble d’outils connexes.
  • Outil client : envoyez une activité d’événement au client afin que le client exécute une action et retourne une réponse.

Pour plus d’informations sur les compétences et les outils clients, consultez les liens de la section Contenu associé .

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

La création d’outils directement dans Copilot Studio simplifie le processus de développement et garantit une intégration appropriée à votre agent. 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 de l’agent.

  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 :

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

    Capture d’écran montrant la sélection du type de nouvel outil à ajouter à l’assistant

  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 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’agent.

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 agent, 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
  • Données d'entrée
  • Completion

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 des détails de base sur 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 agent. 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 agent doit utiliser l’outil. Écrivez des descriptions claires, spécifiques, notamment ce que fait l’outil et quand il doit être utilisé.

  • Détails supplémentaires :

    • Autoriser l’agent à décider dynamiquement quand utiliser l’outil : lorsque cette option est sélectionnée, l’agent peut utiliser l’orchestration générative pour déterminer quand utiliser l’outil. Si cette option n’est pas sélectionnée, l’agent 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.)
    • Demandez à l’utilisateur final avant d’exécuter : dans l’expérience de conversation de l’utilisateur final, demandez à l’agent de confirmation 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.

Données d'entrée

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, le remplissage à l’aide de la valeur de colonne pour chaque entrée est défini 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 affinées pour la collecte d’entrée et le remplissage :

  • Nom d’affichage et description : comment l’entrée apparaît à l’utilisateur.
  • Identifiez comme : 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’agent 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 pour le type d’entité.

Vous pouvez également choisir de remplacer une entrée par une valeur explicite au lieu de laisser l’agent 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’agent ne demande pas à l’utilisateur une valeur.

Completion

Ici, vous pouvez sélectionner ce que vous souhaitez qu'il se passe une fois que l’outil a terminé son exécution.

Vous pouvez faire en sorte que l’agent 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 mise en forme pour que votre outil retourne. Vous pouvez insérer des références aux variables de sortie de 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 permettant de répondre à l’utilisateur après l’exécution de l’outil :

  • Ne répondez pas (par défaut) : l’agent incorpore la sortie de l’outil dans sa réponse
  • Écrire la réponse avec l’IA générative : laissez l’IA créer une réponse contextuelle à l’aide des sorties de l’outil
  • Envoyer une réponse spécifique : Créer une réponse avec modèle avec insertion de variable
  • Envoyer une carte adaptative : créer des réponses enrichies et interactives avec des boutons et des actions

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

Sélection des outils et collection 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 conversation actuel
  • 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’agent. 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 répondre immédiatement, soit de générer un message ou de créer un message explicite.

Conseil / Astuce

Lorsque vous utilisez des questions générées à partir d’un outil, informez vos utilisateurs que l’IA a généré une partie de la conversation.

Par exemple, ajoutez un message supplémentaire dans le sujet système Conversation Start. Cette rubrique détermine le message affiché à vos utilisateurs lorsqu’une nouvelle conversation démarre.

Appeler un outil existant à partir d’une rubrique

Vous pouvez appeler un outil explicitement à partir d’une rubrique. Selon votre cas d’usage, vous pouvez utiliser votre outil dans le cadre d’un sujet plus large, qui utilise plusieurs nœuds. Ou, comme dans l’exemple suivant, ajouter un nœud d’action (outil) à un sujet pourrait 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.

  5. Sélectionnez l’outil dans les outils disponibles. Il existe trois onglets montrant différents types d’outils :

    • Outils de base
    • Connector
    • Tool

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

  6. 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 un tableau, 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 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’agent dans le contexte utilisateur et ne peuvent pas être exécutés, sauf 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 accèdent uniquement aux données qu’ils sont autorisés à voir.
  • 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 ne doivent pas avoir 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 qu’il 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 agent, l’outil 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.

Note

Vous ne pouvez supprimer des outils qu’à partir de la page Outils de l’assistant. Vous ne pouvez pas supprimer d’outils à partir de la page principale Outils de Copilot Studio.

Limitations des outils dans les agents

  • Lors de l’utilisation de l’orchestration générative, l’orchestrateur peut gérer un maximum de 128 outils par agent. Pour de meilleures performances et résultats, nous recommandons cependant de limiter le nombre d’outils dans votre agent à 25 à 30 maximum.
  • Lorsqu’on utilise l’orchestration multi-agents avec des agents enfants, les agents enfants disposent de leur propre orchestration et peuvent gérer leur propre ensemble allant jusqu’à 128 outils.

Contenu connexe

  • Last updated on