Étendre l’extension de message basé sur un bot en tant que plug-in pour Copilot pour Microsoft 365

Remarque

• Vérifiez que Copilot pour Microsoft 365 est disponible pour votre organization. Vous disposez de deux façons d’obtenir un environnement de développement pour Copilot :
  • Un locataire Microsoft 365 de bac à sable avec Copilot (disponible en préversion limitée via l’appartenance TAP).
  • Un environnement de production Microsoft 365 ou Office 365 éligible avec une licence Copilot pour Microsoft 365.
• Le plug-in d’extension de message de recherche basée sur un bot est disponible dans la préversion publique pour les développeurs.
• Seules les extensions de message basées sur un bot avec des commandes de recherche peuvent être étendues en tant que plug-ins pour Copilot pour Microsoft 365.

Microsoft Copilot pour Microsoft 365, alimenté par un moteur de traitement et d’orchestration avancé, intègre les applications Microsoft 365, Microsoft Graph et les modèles de langage volumineux (LLMs) pour transformer vos mots en un outil de productivité puissant. Bien que Copilot pour Microsoft 365 puissent utiliser des applications et des données au sein de l’écosystème Microsoft 365, de nombreux utilisateurs s’appuient sur divers outils et services externes pour la gestion du travail et la collaboration. En étendant votre extension de message en tant que plug-in dans Copilot pour Microsoft 365, vous pouvez permettre aux utilisateurs d’interagir avec des outils et services tiers, ce qui leur permet d’obtenir plus d’Copilot pour Microsoft 365. Vous pouvez obtenir cette extension en développant un plug-in ou en vous connectant à une source de données externe.

Regardez la vidéo pour en savoir plus sur l’extension Copilot pour Microsoft 365 à l’aide des extensions de message Teams :

Qu’est-ce qu’un plug-in ?

Un plug-in permet à Copilot pour Microsoft 365 d’interagir directement avec des données, des applications et des services tiers, d’améliorer ses fonctionnalités et d’élargir sa gamme de fonctionnalités. Les plug-ins permettent Copilot pour Microsoft 365 de :

• Récupérez des informations en temps réel, telles que les dernières actualités sur le lancement d’un produit.
• Récupérez des informations basées sur les connaissances, telles que les fichiers de conception d’une équipe dans Figma.
• Effectuez des actions au nom de l’utilisateur, telles que la création d’un ticket Contoso.

Les descriptions améliorent la facilité d’utilisation et l’efficacité d’un plug-in d’extension de message. La description suivante offre un résumé clair et concis des fonctionnalités de l’application :

• Description de l’application : la description de l’application permet d’améliorer la détectabilité de votre application dans le Magasin Teams.
• Description de la commande : la description de la commande mappe l’intention et l’énoncé de l’utilisateur à la commande de recherche à l’intérieur d’un plug-in et doit être basée sur l’analyse de l’intention de l’utilisateur et des mots clés.
• Description du paramètre : la description du paramètre explique les exigences du système dans un langage naturel avec un format de sortie.
• Description sémantique : la description sémantique permet à Copilot pour Micrososft 365 de générer du contenu en fournissant une compréhension conceptuelle des fonctionnalités et des scénarios du plug-in où il peut aider à atteindre les objectifs de l’utilisateur et à faire correspondre l’intention de l’utilisateur avec les fonctionnalités du plug-in.

Pour plus d’informations, consultez Définir des descriptions.

Toutes les extensions de message de recherche basée sur un bot peuvent bénéficier de la prise en charge du plug-in, sous réserve d’une validation pour garantir que le plug-in répond aux attentes en matière de qualité, de sécurité, de confidentialité et d’utilité. Vous pouvez créer une extension de message de recherche basée sur un bot à l’aide du Kit de ressources Teams pour Visual Studio Code, Visual Studio, l’interface de ligne de commande (CLI) du Kit de ressources Teams ou le Portail des développeurs pour Teams et étendre l’extension de message pour qu’elle fonctionne comme un plug-in dans Copilot pour Microsoft 365.

Configuration requise

Avant de commencer, vérifiez que vous êtes familiarisé avec les normes et recommandations suivantes pour la création de plug-ins d’extension de message pour Copilot pour Microsoft 365 :

• Normes relatives à la conformité, aux performances, à la sécurité et à l’expérience utilisateur décrites dans les instructions de validation du Magasin Teams.

• Recommandations pour créer ou mettre à niveau un plug-in d’extension de message pour Copilot pour Microsoft 365.

Créer une extension de message basé sur un bot

Importante

Les plug-ins pour Microsoft Copilot pour Microsoft 365 sont en préversion et fonctionnent uniquement dans Microsoft 365 Chat dans Microsoft Teams.

Nous allons créer une extension de message de recherche basée sur un bot qui peut rechercher des registres npm dans Teams et Copilot et partager les résultats via la zone de rédaction de message du client Microsoft Teams.

Visual Studio Code

Avant de commencer, veillez à installer les outils suivants pour générer et déployer votre extension de message :

• Installez la dernière version préliminaire du Kit de ressources Teams.
• Vérifiez que l’indicateur de fonctionnalité Développer le plug-in Copilot est activé. Pour activer l'indicateur de fonctionnalité, procédez comme suit :
  1. Ouvrez Visual Studio Code.
  2. Accédez à Gérer les>paramètres.
  3. Entrez Teams Toolkit dans la zone de recherche des paramètres de Recherche.
  4. Sous Extensions, cochez la case Fx-extension : Développer un plug-in Copilot .

Pour créer un plug-in d’extension de message de recherche basée sur un bot à l’aide de Visual Studio Code, procédez comme suit :

1. Ouvrez Visual Studio Code.

2. Dans le volet de gauche, sélectionnez Boîte à outils Teams.

3. Sélectionnez Créer une application.

4. Sélectionnez Extension de message.

5. Sélectionnez Résultats de la recherche personnalisée.

6. Sélectionnez Démarrer avec un bot.

   

7. Sélectionnez un langage de programmation.

8. Sélectionnez Dossier par défaut.

9. Entrez le nom de votre application, puis sélectionnez Entrée. Teams Toolkit crée une structure automatique de votre application et crée une extension de message.

Pour exécuter votre extension de message dans Teams, procédez comme suit :

1. Dans le volet de gauche, sélectionnez Boîte à outils Teams.

2. Sous COMPTES, procédez comme suit :

   1. Sélectionnez Se connecter à Microsoft 365 et entrez vos informations d’identification Microsoft 365.

   2. Sélectionnez Se connecter à Azure et entrez vos informations d’identification Azure.

      

3. Dans le volet gauche, sélectionnez Exécuter et déboguer (Ctrl+Maj+D).

4. Sélectionnez Déboguer dans Teams (Edge) ou Déboguer dans Teams (Chrome). Teams Toolkit lance votre application dans Teams à l’aide d’un navigateur web.

5. Sélectionnez Ajouter. L’application est installée sur Teams.

6. Accédez à une conversation et sélectionnez Actions et applications.

7. Dans le menu volant de l'extension de message, entrez le nom de votre extension de message dans la zone de recherche.

8. Sélectionnez votre extension de message et entrez votre requête de recherche.

9. Sélectionnez un produit dans la liste. Teams déploie le produit sous la forme d’une carte adaptative dans la zone de composition des messages.

10. Sélectionnez Envoyer.

Déclenchement d'une extension de message dans M365 Chat

Pour déclencher l'extension de message en tant que plug-in dans M365 Chat, procédez comme suit :

1. Sélectionner les applications.

2. Recherchez M365 Chat et ouvrez l'application M365 Chat.

3. Sélectionnez Plug-ins.

4. Dans la liste des plug-ins, activez le bouton bascule de votre extension de message.

   

5. À partir de la zone de composition du message, envoyez un message à M365 Chat pour rechercher des informations sur le package npm dans Teams et Copilot. Par exemple, recherchez les informations du package npm sur teamsfx-react dans npm-searchlocal.

   

Remarque

Cette invite peut ne pas toujours faire en sorte que M365 Chat inclue une réponse de votre extension de message. Si c'est le cas, essayez d'autres invites ou laissez-nous vos commentaires en attribuant un vote négatif à la réponse de M365 Chat et en laissant un message.

Visual Studio

Avant de commencer, veillez à installer les outils suivants pour générer et déployer votre extension de message :

• Installez le Visual Studio Enterprise 2022 Preview version 17.9.0 Preview 1.0 ou ultérieure et installez les outils de développement Microsoft Teams sous ASP.NET charge de travail développement web.
• Vérifiez que l’indicateur de fonctionnalité Copilot est activé. Pour activer l'indicateur de fonctionnalité, procédez comme suit :
  1. Ouvrez Visual Studio.
  2. Accédez à Options d’outils>.
  3. Entrez Teams Toolkit dans la zone de recherche Recherche Paramètres.
  4. Sous Fonctionnalités en préversion, cochez la case Kit de ressources Teams : Développer le plug-in Copilot .

Pour créer un plug-in d’extension de message de recherche basée sur un bot à l’aide de Visual Studio, procédez comme suit :

1. Ouvrez Visual Studio.

2. Accédez à Fichier>nouveau>projet... ou Créer un projet.

3. Recherche teams et sélectionnez Application Microsoft Teams.

4. Sélectionnez Résultats de la recherche personnalisée.

   

5. Sélectionnez Créer. Le projet est généré automatiquement.

6. Dans le menu déroulant débogage, sélectionnez Dev Tunnels>Créer un tunnel.

   
   

   1. Sélectionnez le compte pour créer le tunnel. Azure, Compte Microsoft (MSA) et GitHub sont les types de comptes pris en charge.
   2. Nom : entrez un nom pour le tunnel.
   3. Type de tunnel : sélectionnez Persistant ou Temporaire.
   4. Accès : sélectionnez Public.
   5. Sélectionnez OK. Visual Studio affiche un message de confirmation indiquant qu’un tunnel est créé.

   Le tunnel que vous avez créé est répertorié sous Dev Tunnels > (nom du tunnel).

7. Accédez à Explorateur de solutions et sélectionnez votre projet.

8. Cliquez avec le bouton droit sur le menu du projet et sélectionnez Teams Toolkit>Préparer les dépendances d’application Teams.

   

   Si vous y êtes invité, connectez-vous avec un compte Microsoft 365.

9. Dans le menu déroulant débogage, sélectionnez Microsoft Teams (navigateur). Visual Studio lance le client web Teams.

10. Sélectionnez Ajouter. L'extension de message est ajoutée à Teams.

    

11. Accédez à une conversation et sélectionnez Actions et applications.

12. Dans le menu volant de l'extension de message, entrez le nom de votre extension de message dans la zone de recherche.

13. Sélectionnez votre extension de message et entrez votre requête de recherche.

    

14. Sélectionnez un produit dans la liste. Teams déploie le produit dans une carte adaptative dans la zone de composition des messages.

15. Sélectionnez Envoyer. La carte adaptative est envoyée à la conversation.

    

Déclenchement d'une extension de message dans M365 Chat

Pour déclencher l'extension de message en tant que plug-in dans M365 Chat, procédez comme suit :

1. Accédez à Visual Studio.

2. Dans la liste déroulante de débogage, sélectionnez Copilot (navigateur). Visual Studio lance le client web Teams.

   

3. Accédez à Applications clientes> web Teams.

4. Recherchez M365 Chat et ouvrez l'application M365 Chat.

5. Sélectionnez Plug-ins.

6. Dans la liste des plug-ins, activez le bouton bascule de votre application.

   

7. À partir de la zone de composition du message, envoyez un message à M365 Chat pour rechercher des informations sur le package npm dans Teams et Copilot. Par exemple, recherchez les informations sur le package npm sur teamsfx-react dans npmsearchlocal.

   

Remarque

Cette invite peut ne pas toujours faire en sorte que M365 Chat inclue une réponse de votre extension de message. Si c'est le cas, essayez d'autres invites ou laissez-nous vos commentaires en attribuant un vote négatif à la réponse de M365 Chat et en laissant un message.

Interface CLI du kit de ressources

Avant de commencer, veillez à définir la variable d’environnement DEVELOP_COPILOT_PLUGIN sur true. Pour définir les variables d’environnement, procédez comme suit :

1. Sur votre ordinateur, sélectionnez la touche X Windows + .

2. Sélectionnez Système.

3. Sous À propos des>spécifications de l’appareil, sélectionnez Paramètres système avancés.

4. Sous Propriétés système, sélectionnez Variables d’environnement...

5. Sous Variables utilisateur, sélectionnez Nouveau... Une boîte de dialogue Nouvelle variable utilisateur s’ouvre .

6. Mettez à jour les champs suivants :

   1. Nom de la variable : DEVELOP_COPILOT_PLUGIN
   2. Valeur de la variable : true

7. Sélectionnez OK.

   

Pour créer un plug-in d’extension de message de recherche basée sur un bot à l’aide de l’interface CLI teams Toolkit, procédez comme suit :

1. Accédez à l’invite de commandes.

2. Entrez la commande suivante :

   npm install -g @microsoft/teamsfx-cli@beta
   

3. Entrez teamsfx new dans le terminal.

4. Sélectionnez Extension de message. Utilisez les touches de direction pour basculer entre les options.

   

5. Sélectionnez Résultats de la recherche personnalisée.

6. Sélectionnez Démarrer avec un bot.

   

7. Entrez l’emplacement de votre projet, puis sélectionnez Entrée.

8. Entrez le nom de votre application, puis sélectionnez Entrée.

   Teams Toolkit crée un modèle automatique et crée un projet à l’emplacement spécifié.

9. Accédez au chemin du dossier où votre projet est créé et entrez la commande suivante pour provisionner votre application dans Azure :

    teamsfx provision --env dev
   

   L’interface CLI du Kit de ressources Teams ouvre une fenêtre de navigateur et vous demande de vous connecter à votre compte Microsoft.

10. Connectez-vous à votre compte Microsoft. L’interface CLI teams Toolkit exécute la validation et provisionne votre application sur Azure.

11. Dans la liste, sélectionnez un abonnement.

    

12. Dans la liste, sélectionnez un groupe de ressources.

13. Si vous recevez un message indiquant Que le coût peut être facturé en fonction de l’utilisation. Voulez-vous provisionner des ressources dans l’environnement de développement à l’aide des comptes répertoriés ci-dessus ?, entrez Y.

    

    Teams Toolkit valide votre manifeste d’application et provisionne votre application sur Azure.

14. Dans la fenêtre d’invite de commandes, entrez la commande suivante pour afficher un aperçu de votre application dans Teams :

     teamsfx preview --env dev
    

    Une nouvelle fenêtre de navigateur avec le client web Teams s’ouvre. Vous pouvez ajouter votre application à Teams.

15. Sélectionnez Ajouter. L'extension de message est ajoutée à Teams.

16. Accédez à une conversation et sélectionnez Actions et applications.

17. Dans le menu volant de l'extension de message, entrez le nom de votre extension de message dans la zone de recherche.

18. Sélectionnez votre extension de message et entrez votre requête de recherche.

Déclenchement d'une extension de message dans M365 Chat

Pour déclencher l’extension de message via la conversation M365, procédez comme suit :

1. Sélectionner les applications.

2. Recherchez M365 Chat et ouvrez l'application M365 Chat.

3. Sélectionnez Plug-ins.

4. Dans la liste des plug-ins, activez le bouton bascule de votre application.

   

5. À partir de la zone de composition du message, envoyez un message à M365 Chat pour rechercher des informations sur le package npm dans Teams et Copilot. Par exemple, recherchez les informations du package npm sur teamsfx-react dans npm-searchlocal.

   

Remarque

Cette invite peut ne pas toujours faire en sorte que M365 Chat inclue une réponse de votre extension de message. Si cela se produit, essayez d’autres invites ou laissez-nous des commentaires en dévotant la réponse de conversation M365 et laissez un message marqué avec [MessageExtension].

Documentation pour les développeurs

Pour créer un plug-in d’extension de message de recherche basée sur un bot à l’aide du Portail des développeurs pour Teams, procédez comme suit :

1. Accédez au Portail des développeurs Teams.

2. Accédez à Applications.

3. Sélectionnez + Nouvelles applications.

4. Sous Configurer, sélectionnez Fonctionnalités de l’application.

5. Sélectionnez Extension de messagerie.

   

6. Sous Type d’extension de message, sélectionnez Bot.

   1. Si vous obtenez une clause d’exclusion de responsabilité, qui indique que l’extension de message d’API est déjà utilisée par les utilisateurs. Voulez-vous changer le type d’extension de message en bot ?. Sélectionnez Oui, modifier.

   

7. Si vous avez un bot existant, sélectionnez Bot existant ou, si vous avez un ID de bot, sélectionnez Entrer l’ID du bot.

   1. Si vous n’avez pas d’ID de bot, vous pouvez sélectionner Créer un bot pour créer un bot et entrer l’ID du bot que vous avez créé.

   

8. Sélectionnez Enregistrer.

9. Sous Commande, sélectionnez + Ajouter une commande.

   Ajouter une page de commande s’affiche.

10. Dans la page Ajouter une commande, sélectionnez le Recherche comme type de commande et mettez à jour les champs suivants :

    • ID de commande
    • Titre de la commande
    • Description de la commande
    • Contexte dans lequel la commande fonctionne
    • Nom du paramètre
    • Titre du paramètre
    • Description du paramètre

11. Sélectionnez Enregistrer. La commande est ajoutée à l’extension de message.

12. Sélectionnez Enregistrer.

Une extension de message de recherche basée sur un bot est créée.

Pour tester votre extension de message basée sur un bot créée dans le portail des développeurs pour Teams, vous pouvez utiliser les méthodes suivantes :

• Aperçu dans Teams : dans le portail des développeurs, ouvrez votre extension de message et sélectionnez Aperçu dans Teams dans le coin supérieur droit. Vous êtes redirigé vers Teams, où vous pouvez ajouter l’application à Teams pour afficher un aperçu de l’application.

• Télécharger le package d’application : dans la page d’extension de message, sélectionnez Package d’application dans le volet gauche, puis, dans le coin supérieur gauche de la fenêtre, sélectionnez Télécharger le package d’application. Le package d’application est téléchargé sur votre ordinateur local dans un fichier .zip. Vous pouvez charger le package d’application dans teams et tester l’extension de message.

Pour plus d’informations sur le test de votre plug-in dans Copilot pour Microsoft 365 conversation, consultez Sélection du plug-in de débogage.

Guide pas à pas

Suivez le guide pas à pas pour créer un plug-in d’extension de message de recherche basé sur un bot pour M365 Chat.

Voir aussi

• Générer des extensions de message à l’aide de l’API
• Définir des commandes d’action d’extension de message
• Étendre Microsoft Copilot pour Microsoft 365