Définir des commandes de recherche d’extension de message

La commande de recherche est appelée à partir de l’un des emplacements suivants ou des deux :

• Zone de rédaction du message : boutons situés en bas de la zone de rédaction du message.
• Zone de commande : en utilisant / dans la zone de commande. Par exemple, /your-app-name. Si vous utilisez teams classique, la commande de recherche est appelée par @mentioning dans la zone de commande. Par exemple, @your-app-name.

Lorsqu’une commande de recherche est appelée à partir de la zone de rédaction du message, l’utilisateur envoie les résultats à la conversation. Lorsqu’une commande de recherche est appelée à partir de la zone de commande, l’utilisateur interagit avec le carte résultant ou le copie pour une utilisation ailleurs.

L’image suivante affiche les emplacements d’appel de la commande de recherche :

Ajouter la commande de recherche au manifeste de votre application

Pour ajouter la commande de recherche à votre manifeste d’application (précédemment appelé manifeste d’application Teams), vous devez ajouter un nouvel composeExtensions objet au niveau supérieur de votre manifeste d’application JSON. Vous pouvez ajouter la commande de recherche à l’aide du Portail des développeurs ou manuellement.

Créer une extension de message de recherche à l’aide de Bot Framework

Vous pouvez créer une extension de message de recherche à l’aide du Kit de ressources Teams et du Portail des développeurs pour Teams.

Conditions préalables

Avant de commencer, vérifiez que vous répondez aux exigences suivantes :

• Node.js. Les versions prises en charge sont 16, 18.
• Compte Microsoft 365 pour le développement
• Configurez votre environnement de développement pour étendre les applications Teams dans Microsoft 365. Une fois que vous avez inscrit votre locataire développeur dans Office 365 version ciblée, l’application de l’inscription peut prendre quelques jours.
• Teams Toolkit Extension Visual Studio Code version 5.2.0 et ultérieure ou l’interface CLI teams Toolkit.

Toolkit Teams

Pour créer une extension de message basée sur la recherche à l’aide de Teams Toolkit, procédez comme suit :

1. Ouvrez Visual Studio Code.

2. Dans le volet gauche, sélectionnez Kit de ressources 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 un langage de programmation.

7. Sélectionnez Dossier par défaut.

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

   Teams Toolkit crée une structure automatique de votre projet et crée une extension de message de recherche.

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

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

2. Sous COMPTES, connectez-vous avec votre compte Microsoft 365 et votre compte Azure si ce n’est déjà fait.

   

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

4. Dans la liste déroulante de configuration de lancement, sélectionnez Preview in Teams (Edge) ou Preview in Teams (Chrome). Teams Toolkit lance le client web Teams dans une fenêtre de navigateur.

5. Accédez à un message de conversation et sélectionnez l’icône Actions et applications . Dans le menu volant, recherchez votre application.

6. Sélectionnez votre extension de message dans la liste et entrez une commande de recherche dans la zone de recherche.

7. Sélectionnez un élément dans la liste. L’élément se déploie dans une carte adaptative dans la zone de composition de message.

8. Sélectionnez Envoyer. Teams envoie le résultat de la recherche sous forme de carte adaptative dans le message de conversation.

Documentation pour les développeurs

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

2. Accédez à Applications.

3. Sélectionnez Créer une application.

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 existant, sélectionnez Créer un bot pour créer un bot et entrez l’ID du bot que vous avez créé.

8. Sélectionnez Enregistrer.

9. Sélectionnez les étendues requises.

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

    Une page de détails de commande s’affiche.

11. Dans la page Détails de la commande, sélectionnez Rechercher 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
    • Sélectionner le type d’entrée

12. Sélectionnez Enregistrer. Extension de message de recherche à l’aide de l’infrastructure de bot créée.

13. Dans le coin supérieur droit, sélectionnez Aperçu dans Teams. L’application s’ouvre dans le client web ou de bureau Teams.

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

Importante

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

Les plug-ins Microsoft 365 fournissent une intégration avec différents produits Microsoft 365, tels que Teams et Outlook. L’intégration permet aux utilisateurs de rechercher ou de créer du contenu dans des systèmes externes. Les plug-ins d’extension de message permettent aux Microsoft Copilot pour Microsoft 365 d’interagir avec les API d’autres logiciels et services via un bot. Nous vous recommandons de créer ou de mettre à niveau vos extensions de message existantes pour optimiser leur utilité et leur facilité d’utilisation dans Copilot pour Microsoft 365. Pour plus d’informations, consultez Étendre l’extension de message bot en tant que plug-in pour Copilot pour Microsoft 365.

Extraits de code

Le code suivant fournit un exemple d’extensions de message basées sur la recherche :

C#

• Référence du Kit de développement logiciel (SDK)
• Exemple de référence de code

protected override async Task<MessagingExtensionResponse> OnTeamsMessagingExtensionQueryAsync(ITurnContext<IInvokeActivity> turnContext, MessagingExtensionQuery query, CancellationToken cancellationToken)
        {
            var text = query?.Parameters?[0]?.Value as string ?? string.Empty;

            var packages = new[] {
            new { title = "A very extensive set of extension methods", value = "FluentAssertions" },
            new { title = "Fluent UI Library", value = "FluentUI" }};

            // We take every row of the results and wrap them in cards wrapped in MessagingExtensionAttachment objects.
            // The Preview is optional, if it includes a Tap, that will trigger the OnTeamsMessagingExtensionSelectItemAsync event back on this bot.
            var attachments = packages.Select(package =>
            {
                var previewCard = new ThumbnailCard { Title = package.title, Tap = new CardAction { Type = "invoke", Value = package } };
                if (!string.IsNullOrEmpty(package.title))
                {
                    previewCard.Images = new List<CardImage>() { new CardImage(package.title, "Icon") };
                }

                var attachment = new MessagingExtensionAttachment
                {
                    ContentType = HeroCard.ContentType,
                    Content = new HeroCard { Title = package.title },
                    Preview = previewCard.ToAttachment()
                };

                return attachment;
            }).ToList();

            // The list of MessagingExtensionAttachments must we wrapped in a MessagingExtensionResult wrapped in a MessagingExtensionResponse.
            return new MessagingExtensionResponse
            {
                ComposeExtension = new MessagingExtensionResult
                {
                    Type = "result",
                    AttachmentLayout = "list",
                    Attachments = attachments
                }
            };
        }

Node.js

• Exemple de référence de code

async handleTeamsMessagingExtensionQuery(context, query) {
        const searchQuery = query.parameters[0].value;     
        const attachments = [];
                const response = await axios.get(`http://registry.npmjs.com/-/v1/search?${ querystring.stringify({ text: searchQuery, size: 8 }) }`);
                
                response.data.objects.forEach(obj => {
                        const heroCard = CardFactory.heroCard(obj.package.name);
                        const preview = CardFactory.heroCard(obj.package.name);
                        preview.content.tap = { type: 'invoke', value: { description: obj.package.description } };
                        const attachment = { ...heroCard, preview };
                        attachments.push(attachment);
                });
    
                return {
                    composeExtension:  {
                           type: 'result',
                           attachmentLayout: 'list',
                           attachments: attachments
                    }
                };
            }       
        }

Exemple de code

Exemple de nom	Description	.NET	Node.js	Manifeste
Recherche d'extension des messages Teams	Cet exemple montre comment créer une extension de message basée sur la recherche. Il recherche les packages NuGet et affiche les résultats dans l’extension de messagerie basée sur la recherche.	View	View	View

Guide pas à pas

Suivez le guide pas à pas pour créer une extension de message basée sur la recherche.

Étape suivante

Répondre aux commandes de recherche.

Voir aussi

• Documentation pour les développeurs
• Extensions de messages