Créer des plug-ins d’API avec une nouvelle API pour Microsoft 365 Copilot

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 une API REST. Utilisez Microsoft 365 Agents Toolkit pour générer un projet d’agent, un manifeste de plug-in API et une implémentation d’API REST comme point de départ.

Créer l’agent et l’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.

  1. Ouvrez Visual Studio Code. Si Agents Toolkit n’est pas déjà installé, consultez Installer Agents Toolkit pour obtenir des instructions d’installation.

  2. Sélectionnez l’icône Microsoft 365 Agents Toolkit dans la barre d’activité à gauche.

  3. Sélectionnez Créer un agent/une application dans le volet Office Agents Toolkit.

    Capture d’écran de l’interface d’Agents Toolkit

  4. Sélectionnez l’agent déclaratif.

  5. Sélectionnez Ajouter une action, puis sélectionnez Démarrer avec une nouvelle API.

  6. Sélectionnez OAuth comme type d’authentification.

  7. Sélectionnez votre langage de programmation préféré : JavaScript ou TypeScript. Ce guide suppose TypeScript.

  8. Choisissez un emplacement pour le projet d’agent.

  9. Entrez Repairs Agent un nom pour votre projet d’agent.

Lorsque vous terminez ces étapes, Agents Toolkit génère les fichiers projet d’agent et d’API, y compris le manifeste du plug-in API, et ouvre le projet dans une nouvelle fenêtre Visual Studio Code. Pour plus d’informations, consultez le fichier README.md dans le répertoire racine du projet généré.

Exécuter l’API et charger une version test de l’agent

  1. Dans la fenêtre Visual Studio Code avec le projet d’agent chargé, sélectionnez l’icône Microsoft 365 Agents Toolkit dans la barre d’activité gauche.

  2. Dans le volet Comptes , sélectionnez Se connecter à Microsoft 365. (Si vous êtes déjà connecté, passez à l’étape suivante).

  3. 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.

  4. Sélectionnez l’icône Exécuter et déboguer dans la barre d’activité de gauche.

  5. Sélectionnez Déboguer dans Copilot (Edge) ou Déboguer dans Copilot (Chrome), puis appuyez sur F5 pour démarrer le débogage.

Agents Toolkit génère le projet, crée un package d’application contenant l’agent et sa configuration de plug-in d’API, puis charge l’agent pour votre compte d’utilisateur. Il démarre également l’API localement. Une nouvelle fenêtre de navigateur s’ouvre sur l’application Microsoft Teams.

Tester l’action API de l’agent

  1. Dans Microsoft Teams dans votre navigateur, sélectionnez Copilot.

  2. Sélectionnez Repairlocal dans la liste 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.

  3. Envoyez un message à Copilot au sujet des réparations. Par exemple, essayez Which repairs are assigned to Karin?.

À ce stade, l’API REST s’exécute localement sur votre machine de développement sans authentification. Pour ajouter l’authentification, déployez l’API sur Azure.

Déployer dans Azure et activer l’authentification

  1. Sélectionnez l’icône Microsoft 365 Agents Toolkit dans la barre d’activité à gauche.

  2. Dans le volet Cycle de vie , sélectionnez Provisionner.

  3. Lorsque vous êtes invité à entrer un nom de groupe de ressources, acceptez le nom par défaut ou modifiez-le comme vous le souhaitez, puis appuyez sur Entrée.

  4. Sélectionnez un emplacement pour le groupe de ressources.

  5. Passez en revue le message dans la boîte de dialogue. Si tout semble correct, sélectionnez Approvisionner pour continuer.

  6. Attendez la fin des étapes d’approvisionnement, puis sélectionnez Déployer (Déployer ) dans le volet Lifecycle (Cycle de vie ).

Une fois ces étapes terminées, vous déployez l’API REST en tant que fonction Azure avec authentification. L’agent appelle cette API hébergée via la configuration du plug-in d’API.

Tester l’agent avec l’API authentifiée

  1. Dans Microsoft Teams dans votre navigateur, sélectionnez Copilot.

  2. Sélectionnez Repaire Agentdev dans la liste Agents sur le côté droit.

  3. Envoyez un message à Copilot au sujet des réparations. Par exemple, essayez Which repairs are assigned to Issac?.