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

Les plug-ins d’API connectent une API REST à Microsoft 365 Copilot. Vous pouvez utiliser microsoft 365 Agents Toolkit pour générer rapidement un plug-in et une API REST correspondante que vous pouvez utiliser comme point de départ pour le développement de votre plug-in.

• Conditions requises spécifiées dans Conditions requises pour les options d’extensibilité Copilot
• Visual Studio Code
• Microsoft 365 Agents Toolkit
• Node.js 20.x ou 22.x

Créer le plug-in et l’API

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és de gauche.

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

   

4. Sélectionnez Agent déclaratif.

5. Sélectionnez Ajouter une action, puis 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 de plug-in d’API.

9. Entrez Repairs Agent comme nom pour votre projet de plug-in.

Une fois ces étapes terminées, Agents Toolkit génère les fichiers requis pour le plug-in et ouvre une nouvelle fenêtre Visual Studio Code avec le projet de plug-in chargé. Pour plus d’informations sur le projet, consultez le fichier README.md dans le répertoire racine du projet généré.

Exécuter le plug-in

1. Dans la fenêtre Visual Studio Code avec le projet de plug-in chargé, sélectionnez l’icône Microsoft 365 Agents Toolkit dans la barre d’activités de 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 le chargement d’application personnalisé activé et l’accès Copilot activé s’affichent sous votre compte Microsoft 365. Si ce n’est pas le cas, case activée avec votre administrateur organization. Pour plus d’informations, consultez Configuration requise pour les options d’extensibilité 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 le package de plug-in et le charge pour votre compte d’utilisateur. Une fois cette opération terminée, une nouvelle fenêtre de navigateur s’ouvre pour l’application Microsoft Teams.

Tester le plug-in

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

2. Sélectionnez Réparer l’agent local 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, le plug-in s’exécute localement sur votre ordinateur de développement sans authentification. Pour ajouter l’authentification, déployez la solution sur Azure.

Déployer sur Azure et activer l’authentification

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

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

3. Lorsque vous êtes invité à entrer un nom de groupe de ressources, acceptez la valeur par défaut ou modifiez-la 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 Provisionner pour continuer.

6. Attendez que les étapes d’approvisionnement se terminent, puis sélectionnez Déployer dans le volet Cycle de vie .

Une fois ces étapes terminées, le plug-in est déployé en tant que fonction Azure avec authentification.

Tester le plug-in avec l’authentification

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

2. Sélectionnez Réparer l’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?.