Créer des extensions de message à l’aide de Bot Framework

Les commandes de recherche d’extension de message permettent aux utilisateurs de rechercher des systèmes externes et d’insérer les résultats de cette recherche dans un message sous la forme d’un carte. Ce document vous guide sur la sélection des emplacements d’appel de commandes de recherche et l’ajout de la commande de recherche au manifeste de votre application.

Pour savoir comment définir des commandes de recherche d’extension de message, consultez la vidéo suivante :

La commande de recherche dans une extension de message est configurée à l’aide de la composeExtensions.commands propriété et du query type dans le manifeste de l’application (précédemment appelé manifeste d’application Teams). Les descriptions des commandes et des paramètres améliorent la facilité d’utilisation et l’efficacité d’une extension de message. Une bonne description de commande offre un résumé clair et concis des fonctionnalités de l’application.

Le code suivant est un exemple de propriété composeExtensions définissant une commande de recherche :

{
 "composeExtensions": [
    {
      "botId": "eccdf132-0900-4d36-936b-dec5e6357f11",
      "commands": [
        {
          "id": "Dev",
          "type": "query",
          "title": "Jedi",
          "description": "May the force be with you",
          "initialRun": true,
          "fetchTask": false,
          "context": [
            "commandBox",
            "compose",
            "message"
          ],
          "parameters": [
            {
              "name": "Luke",
              "title": "Skywalker",
              "description": "Jedi master",
              "inputType": "text"
            }
          ]
        }
      ],
      "canUpdateConfiguration": true
    }
  ],

Paramètres

Vous devez ajouter les paramètres suivants à votre composeExtensions.commands tableau d’objets :

Vous devez ajouter les détails des paramètres de recherche suivants qui définissent le texte visible par votre utilisateur dans le client Teams :

Pour plus d’informations, consultez Schéma de manifeste d’application.

Extension de message en tant que plug-in pour les réunions Copilot pour Teams

Les plug-ins d’extension de message sont pris en charge dans Copilot pour les réunions Teams. L’extension des plug-ins d’extension de message basé sur bot aux réunions vous permet d’améliorer les réunions Copilot for Teams. Les réunions Copilot pour Teams peuvent utiliser diverses fonctionnalités d’application pendant les réunions, telles que les modules de tâches, le partage d’applications, etc., pour améliorer l’engagement et la productivité des utilisateurs. Par exemple, un plug-in peut être utilisé dans les réunions Copilot pour Teams pour résumer les discussions, générer des notes et lister les tâches. Il étend également les avantages des plug-ins traditionnels en permettant une interaction en temps réel avec des données externes et des fonctionnalités personnalisées.

Copilot pour les réunions Teams est interactif et efficace. Il peut vous aider à résumer les discussions, suggérer des éléments d’action et fournir une assistance sans invite en temps réel. Les utilisateurs peuvent poser des questions en langage naturel à Copilot pour les réunions Teams et obtenir des réponses de votre plug-in qui sont pertinentes pour le contexte de réunion. Les plug-ins peuvent être activés dans les réunions Microsoft 365 Copilot et Copilot pour Teams.

Étape suivante

Les commandes d’action vous permettent de présenter à vos utilisateurs une fenêtre contextuelle modale appelée module de tâche dans Teams. Le module de tâche collecte ou affiche des informations, traite l’interaction et les renvoie à Teams. Ce document vous guide sur la façon de sélectionner des emplacements d’appel de commande d’action, de créer votre module de tâche, d’envoyer un message final ou une carte, de créer une commande d’action à l’aide d’App Studio ou de le créer manuellement.

La commande d’action dans une extension de message est configurée à l’aide de la composeExtensions.commands propriété et action tapez dans le manifeste de l’application.

Le code suivant est un exemple de propriété composeExtensions définissant une commande d’action :

"composeExtensions": [
        {
            "botId": "xxxxxx-xxx-bot-ID-xxxxxxxx}",
            "commands": [
                {
                    "id": "createCard",
                    "context": [
                        "compose",
                        "message",
                        "commandBox"
                    ],
                    "description": "Command to run action to create a Card from Compose Box",
                    "title": "Create Card",
                    "type": "action",
                    "parameters": [
                        {
                            "name": "title",
                            "title": "Card title",
                            "description": "Title for the card",
                            "inputType": "text"
                        },
                        {
                            "name": "subTitle",
                            "title": "Subtitle",
                            "description": "Subtitle for the card",
                            "inputType": "text"
                        },
                        {
                            "name": "text",
                            "title": "Text",
                            "description": "Text for the card",
                            "inputType": "textarea"
                        }
                    ]
                }
            ]
        }
    ]

Paramètres

Vous devez ajouter les paramètres suivants à votre composeExtensions.commands tableau d’objets :

Si vous utilisez une liste statique de paramètres, vous devez également ajouter les paramètres suivants :

Si vous utilisez une vue web incorporée, vous pouvez éventuellement ajouter l’objet taskInfo pour extraire votre vue web sans appeler directement votre bot. Si vous sélectionnez cette option, le comportement est similaire à celui de l’utilisation d’une liste statique de paramètres. Dans la mesure où la première interaction avec votre bot est réponse au module de tâche envoyer l’action. Si vous utilisez un taskInfo objet, vous devez définir le paramètre sur fetchTaskfalse.

Pour plus d’informations, consultez Schéma de manifeste d’application.

Étape suivante