Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Important
Les plug-ins MCP et API fournissent des actions dans les agents déclaratifs. Il ne s’agit pas de packages de plug-ins installables de manière autonome : seul l’agent contenant peut accéder à leurs fonctions et outils. Pour plus d’informations sur la relation entre le package et le manifeste d’action, consultez Plug-ins et actions d’agent déclaratif.
Conseil
Recommandé : Commencez avec les outils de développement Work IQ pour les scénarios de plug-in et d’agent déclaratif pro-code pris en charge. Voir le guide de démarrage rapide de WIQD. Les instructions basées sur la boîte à outils restent disponibles pour les projets existants et les flux de travail qui les nécessitent. Vérifiez la prise en charge de la capacité et de l’expérience cible avant de choisir un outil : WIQD ne cible pas les agents de moteur personnalisés.
Les plug-ins d’API permettent à un agent déclaratif d’appeler votre API REST existante. Utilisez Microsoft 365 Agents Toolkit pour créer un projet d’agent avec une intégration d’action d’API basée sur la spécification OpenAPI de votre API.
Configuration requise
- Configuration requise spécifiée dans Configuration requise pour les options d’extensibilité de Copilot
- Une API REST existante avec une spécification OpenAPI (cette procédure pas à pas utilise l’exemple d’API Budget Tracker)
- Visual Studio Code
- Microsoft 365 Agents Toolkit
Conseil
Pour obtenir de meilleurs résultats, assurez-vous que votre spécification OpenAPI suit les instructions détaillées dans Comment rendre un document OpenAPI efficace dans l’extension de Copilot.
Pour suivre ce guide, téléchargez l’exemple d’API Budget Tracker et configurez-le pour qu’il s’exécute sur votre machine de développement locale. Générez l’exemple au moins une fois pour générer le fichier BudgetTracker.json pour l’API.
Créer le plug-in d’agent et d’API
Remarque
Les captures d’écran et les références de l’interface utilisateur dans cet article utilisent une version commerciale de Microsoft 365 Agents Toolkit. Les versions préliminaires peuvent différer de l’interface utilisateur affichée.
La configuration du plug-in API comprend :
- Spécification OpenAPI pour l’API REST.
- Un manifeste de plug-in qui fait référence à la spécification OpenAPI incluse et décrit les opérations, la méthode d’authentification et les formats de réponse disponibles.
Incluez ces fichiers dans le package d’application de l’agent contenant avec son manifeste d’application, sa définition de l’agent et ses icônes. Le manifeste du plug-in d’API n’est pas lui-même un package installable.
Ouvrez Visual Studio Code. Si Agents Toolkit n’est pas déjà installé, consultez Installer Agents Toolkit pour obtenir des instructions d’installation.
Sélectionnez l’icône Microsoft 365 Agents Toolkit dans la barre d’activité à gauche.
Sélectionnez Créer un agent/une application dans le volet Office Agents Toolkit.
Sélectionnez l’agent déclaratif.
Sélectionnez Ajouter une action, puis sélectionnez Démarrer avec un document de description OpenAPI.
Sélectionnez Parcourir et accédez à l’emplacement de la spécification OpenAPI dans l’exemple Suivi du budget, situé dans ./openapi/BudgetTracker.json.
Sélectionnez toutes les opérations à activer pour le module.
Choisissez un emplacement pour le projet d’agent.
Entrez
Budget Trackercomme nom pour le projet d’agent.
Lorsque vous terminez ces étapes, Agents Toolkit génère le projet d’agent et sa configuration de plug-in d’API, et ouvre le projet dans une nouvelle fenêtre Visual Studio Code.
Remarque
La clé de preuve pour l’échange de code (PKCE) est activée par défaut. Si votre serveur d’identité ne prend pas en charge PKCE, désactivez-le en ajoutant la ligne suivante à m365agents.yml dans le projet d’agent.
isPKCEEnabled: false
Provisionner et charger une version test de l’agent
Le chargement indépendant rend l’agent contenant et son action API disponibles pour les tests de développement. Il n’installe pas le plug-in d’API en tant que fonctionnalité indépendante. Cette procédure n’est pas une méthode de distribution générale pour un package de plug-in composé. Pour connaître les itinéraires de partage et de publication, consultez Choisir comment publier et distribuer votre plug-in.
Ouvrez le projet d’agent dans Visual Studio Code.
Sélectionnez l’icône Microsoft 365 Agents Toolkit dans la barre d’activité à gauche.
Dans le volet Comptes , sélectionnez Se connecter à Microsoft 365. (Si vous êtes déjà connecté, passez à l’étape suivante).
Vérifiez que Chargement d’application personnalisée activé et Accès Copilot activé s’affichent sous votre compte Microsoft 365. Si ce n’est pas le cas, contactez l’administrateur de votre organization pour la mettre en case activée. Pour plus d’informations, consultez Configuration requise pour les options d’extensibilité de Copilot.
Dans le volet Cycle de vie , sélectionnez Provisionner.
Lorsqu’on vous demande d’entrer l’identifiant client pour l’enregistrement OAuth..., entrez l’identifiant client de votre plug-in.
Lorsqu’on vous demande d’entrer la clé secrète client pour l’inscription OAuth..., entrez votre clé secrète client du plugin.
Lisez le message dans la boîte de dialogue, puis sélectionnez Confirmer pour continuer.
Attendez que la boîte à outils signale que l’approvisionnement est terminé.
Votre agent est désormais disponible pour le test avec votre compte d’utilisateur dans Microsoft 365 Copilot dans Microsoft Teams.
Tester l’action API de l’agent
Ouvrez Teams dans votre navigateur et connectez-vous avec le compte Microsoft 365 que vous avez utilisé pour charger une version test de votre agent.
Sélectionnez Chat dans la barre d’activité de gauche.
Sélectionnez Copilot dans le volet Chat.
Sélectionnez Suivi du budget dans la liste des agents sur le côté droit. Si la liste n’est pas disponible, sélectionnez l’icône Conversations Copilot et plus dans le coin supérieur droit.
Posez une question sur les budgets. Par exemple, essayez
How much is left in the Fourth Coffee lobby renovation budget?. Lorsque vous y êtes invité, sélectionnez Toujours autoriser ou Autoriser une fois pour continuer.Lorsque vous êtes invité à vous connecter, sélectionnez Se connecter à l’outil de suivi du budget.