Étendre l’extension de message basé sur un bot en tant qu’agent pour Microsoft 365 Copilot

Remarque

• Vérifiez que Microsoft 365 Copilot est disponible pour votre organization. Vous disposez de deux façons d’obtenir un environnement de développement pour Microsoft 365 Copilot :
  • Un locataire Microsoft 365 de bac à sable avec Microsoft 365 Copilot (disponible en préversion limitée via l’appartenance TAP).
  • Un environnement de production Microsoft 365 ou Office 365 éligible avec une licence Microsoft 365 Copilot.
• L’agent d’extension de message de recherche basée sur 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 qu’agents pour Microsoft 365 Copilot.

Microsoft 365 Copilot, 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 (LLM) pour transformer vos mots en un outil de productivité puissant. Bien que Microsoft 365 Copilot 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 qu’agent dans Microsoft 365 Copilot, vous pouvez permettre aux utilisateurs d’interagir avec des outils et services tiers, ce qui leur permet d’obtenir plus d’Microsoft 365 Copilot. Vous pouvez obtenir cette extension en développant un agent ou en vous connectant à une source de données externe.

Qu’est-ce qu’un agent ?

Un agent permet à Microsoft 365 Copilot 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 agents autorisent Microsoft 365 Copilot à :

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

Les descriptions améliorent la facilité d’utilisation et l’efficacité d’un agent 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 agent 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 Microsoft 365 Copilot de générer du contenu en fournissant une compréhension conceptuelle des fonctionnalités et des scénarios de l’agent dans lesquels il peut aider à atteindre les objectifs de l’utilisateur et à faire correspondre l’intention de l’utilisateur avec les fonctionnalités de l’agent.

Pour plus d’informations, consultez instructions pour créer et mettre à niveau des agents.

Toutes les extensions de message de recherche basée sur des bots éligibles à la prise en charge de l’agent doivent répondre aux exigences de stratégie et sont soumises à validation pour garantir que l’agent 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 fonctionner en tant qu’agent dans Microsoft 365 Copilot.

Configuration requise

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

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

• Instructions pour créer ou mettre à niveau un agent d’extension de message pour Microsoft 365 Copilot.

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

Importante

Les agents pour Microsoft 365 Copilot sont en préversion et fonctionnent uniquement dans Microsoft 365 Copilot pour Teams.

Nous allons créer un agent d’extension de message de recherche basé sur un bot pour Teams et Microsoft 365 Copilot et partager les résultats via la zone de rédaction des messages 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 paramètres de recherche.
  4. Sous Extensions, cochez la case Fx-extension : Développer un plug-in Copilot .

Pour créer un agent d’extension de message de recherche basé 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éclencher l’extension de message dans Microsoft 365 Copilot

Pour déclencher l’extension de message en tant qu’agent dans Microsoft 365 Copilot pour Teams, procédez comme suit :

1. Sélectionner les applications.

2. Recherchez Copilot et ouvrez Microsoft 365 Copilot.

3. Sélectionnez Panneau dans le coin supérieur droit.

4. Sélectionnez l’agent requis dans le volet droit.

   

5. À partir de la zone de composition de message, envoyez un message à Microsoft 365 Copilot pour rechercher la dernière mise à jour à partir de Teams et Microsoft 365 Copilot.

   

Remarque

Cette invite peut ne pas toujours garantir une réponse de votre extension de message dans Microsoft 365 Copilot. Si cela se produit, essayez différentes invites ou envoyez des commentaires en attribuant la réponse Microsoft 365 Copilot 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 Paramètres de recherche.
  4. Dans la section Fonctionnalités en préversion , cochez la case Kit de ressources Teams : Développer le plug-in Copilot .
• Vérifiez que le profil de lancement à plusieurs projets est activé. Pour activer le profil, procédez comme suit :
  1. Ouvrez Visual Studio.
  2. Accédez à Options d’outils>.
  3. Dans la section Fonctionnalités en préversion , cochez la case Activer les profils de lancement multi-projets .

Pour créer un agent d’extension de message de recherche basé 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. Recherchez Teams et sélectionnez Application Microsoft Teams.

4. Entrez les détails du projet. Vérifiez que la case Placer la solution et le projet dans le même répertoire n’est pas cochée.

5. Sélectionnez Créer.

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

   

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

8. 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).

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

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

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

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

    

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

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

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

    

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

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

    

Déclencher l’extension de message dans Microsoft 365 Copilot

Pour déclencher l’extension de message en tant qu’agent dans Microsoft 365 Copilot, 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 Copilot et ouvrez Microsoft 365 Copilot.

5. Sélectionnez Panneau dans le coin supérieur droit.

6. Sélectionnez l’agent requis dans le volet droit.

   

7. À partir de la zone de composition de message, envoyez un message à Microsoft 365 Copilot pour rechercher la dernière mise à jour à partir de Teams et Microsoft 365 Copilot.

   

Remarque

Cette invite peut ne pas toujours garantir une réponse de votre extension de message dans Microsoft 365 Copilot. Si cela se produit, essayez différentes invites ou envoyez des commentaires en attribuant la réponse Microsoft 365 Copilot 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 agent d’extension de message de recherche basé 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/teamsapp-cli
   

3. Entrez teamsapp 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 :

    teamsapp 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 :

     teamsapp 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éclencher l’extension de message dans Microsoft 365 Copilot

Pour déclencher l’extension de message en tant qu’agent dans Microsoft 365 Copilot pour Teams, procédez comme suit :

1. Sélectionner les applications.

2. Recherchez Copilot et ouvrez Microsoft 365 Copilot.

3. Sélectionnez Panneau dans le coin supérieur droit.

4. Sélectionnez l’agent requis dans le volet droit.

   

5. À partir de la zone de composition de message, envoyez un message à Microsoft 365 Copilot pour rechercher la dernière mise à jour à partir de Teams et Microsoft 365 Copilot.

   

Remarque

Cette invite peut ne pas toujours garantir une réponse de votre extension de message dans Microsoft 365 Copilot. Si cela se produit, essayez différentes invites ou envoyez des commentaires en attribuant la réponse Microsoft 365 Copilot et en laissant un message.

Documentation pour les développeurs

Pour créer une extension de message 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 pour Teams.

2. Accédez à Applications.

3. Sélectionnez + Nouvelles applications.

4. Dans la page Ajouter des applications, mettez à jour le nom et sélectionnez la version du manifeste en préversion publique pour les développeurs (devPreview).

   

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

6. Sélectionnez Extension de messagerie.

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

      

8. 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éé.

      

9. Sélectionnez Enregistrer.

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

    Ajouter une page de commande s’affiche.

11. Dans la page Ajouter une commande , sélectionnez 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

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

13. 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 agent dans Microsoft 365 Copilot, consultez Débogage de la sélection de l’agent.

Guide pas à pas

Suivez le guide pas à pas pour créer un agent d’extension de message de recherche basé sur un bot pour Microsoft 365 Copilot.

Voir aussi

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