Ajouter un outil à un agent (GitHub Copilot)

Vous pouvez ajouter des outils à votre agent depuis l’onglet Build . Les outils permettent à votre agent d’effectuer des actions, de se connecter à des services externes et de récupérer des données en temps réel lors des conversations.

Note

Le framework utilisé pour construire cet agent utilise une facturation basée sur l’utilisation. L’utilisation, la création, le test et l’évaluation des agents peuvent consommer des crédits Copilot. En savoir plus dans Aperçu de la facturation basée sur l’utilisation.

Prerequisites

  • Un agent créé avec le harnais GitHub Copilot. En savoir plus dans Créer un agent.

Ajouter un outil existant depuis l’onglet Build

  1. Connectez-vous à Copilot Studio et ouvrez votre agent.

  2. Dans la barre de navigation de l’agent, sélectionnez l’onglet Build .

  3. Dans le panneau des composants, sélectionnez le bouton Outils .

  4. Dans la boîte de dialogue Ajouter un outil , parcourez ou recherchez l’outil que vous souhaitez ajouter. Utilisez les onglets Featured, Model Context Protocol (MCP),Connectors ou Workflows pour filtrer par type d’outil.

Lorsque vous saisissez un terme de recherche, l’onglet En vedette est remplacé par un onglet Tous qui affiche des résultats correspondants à tous les types d’outils.

  1. Sélectionnez l’outil pour en voir les détails, y compris une description et les actions proposées.

    Note

    Si votre organisation a bloqué un outil à cause des politiques de données, vous ne pouvez pas le sélectionner. En savoir plus dans Outils bloqués par les politiques de votre organisation.

  2. Sélectionnez Ajouter pour ajouter l’outil à votre agent.

Outils bloqués par les politiques de votre organisation

Votre organisation peut utiliser des politiques de gouvernance pour restreindre les outils et connecteurs disponibles dans Copilot Studio.

Lorsqu’une politique de données bloque un outil, l’outil apparaît indisponible dans le panneau Ajouter un outil et vous ne pouvez pas le sélectionner. Survolez l’icône de croix à côté de l’outil non disponible pour comprendre pourquoi l’outil n’est pas disponible. Dans certains environnements, une icône d’information apparaît à la place. Sélectionnez-le pour ouvrir une explication « Bloqué par une stratégie ».

Capture d’écran montrant un outil bloqué par une politique de données dans le panneau Ajouter un outil.

Le message explique que la politique de données de votre organisation bloque l’outil, donc l’outil ne peut pas être utilisé, même par un agent, et que publier ou exécuter un agent qui l’utilise peut échouer. Si vous avez besoin d’accéder à un outil bloqué, contactez votre administrateur.

Pour en savoir plus, consultez Configurer des stratégies de données pour les agents.

Configurez un outil après l’avoir ajouté

Après avoir ajouté un outil, vous pourriez avoir besoin de :

  • S’authentifier : Certains outils exigent que vous vous connectiez ou fournissiez vos identifiants avant de pouvoir les utiliser. Suivez les instructions d’authentification dès qu’elles apparaissent. Lorsqu’un outil s’authentifie avec le compte de chaque utilisateur, les utilisateurs configurent leur connexion dès la première fois que l’agent en a besoin. En savoir plus dans Configurez vos connexions lorsqu’un agent vous le demande.
  • Sélectionnez les actions : Pour les connecteurs qui proposent plusieurs actions, vous pouvez sélectionner quelles actions spécifiques mettre à disposition de votre agent.
  • Consultez la description : Assurez-vous que la description de l’outil reflète fidèlement son utilité. Le moteur d’exécution d’orchestration de l’agent utilise la description pour déterminer quand invoquer l’outil.

Ajouter un nouvel outil personnalisé

Si l’outil dont vous avez besoin n’est pas listé dans la boîte de dialogue Ajouter un outil, vous pouvez ajouter un outil personnalisé. Les agents propulsés par l’infrastructure GitHub Copilot prennent en charge les outils personnalisés suivants :

Pour commencer, sélectionnez le bouton Ajouter dans la boîte de dialogue Ajouter un outil, puis sélectionnez Model Context Protocol (MCP) ou Workflow.

  • Des outils MCP à partir d’un serveur existant Model Context Protocol (MCP). Utilisez des outils MCP pour vous connecter à des services personnalisés, des bases de données ou des API qui exposent des capacités en tant qu’outils via la norme MCP.
  • Workflows que vous créez dans le concepteur de flux de Copilot Studio. Utilisez des flux de travail pour définir des processus en plusieurs étapes que votre agent peut exécuter à la demande.

Fichiers créés par votre agent

Certains outils produisent des fichiers comme sortie – par exemple, un rapport généré, un tableau ou une image. Ces fichiers sont limités à 10 Mo chacun, et les fichiers dépassant la limite ne sont pas retournés à l’utilisateur. Découvrez-en plus dans Fichiers créés par l’agent (aperçu GitHub Copilot).

Conseils pour des descriptions d’outils efficaces

Tip

Le nom et la description de l’outil sont importants pour une invocation précise de l’outil. L’exécution d’orchestration améliorée les utilise pour décider quand invoquer un outil, donc :

  • Utilisez des noms clairs et spécifiques qui décrivent l’outil (par exemple, « Créer un ticket de support » plutôt que « outil de ticket »).
  • Rédigez des descriptions qui expliquent quand utiliser l’outil et ce qu’il renvoie.
  • Évitez les descriptions vagues ou qui se chevauchent entre les outils.
  • Dernière mise à jour :