Partager via


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

Les extensions de message créées à l’aide de Bot Framework (basé sur un bot) utilisent un service web en tant que bot. Vous pouvez utiliser des extensions de message pour permettre aux utilisateurs d’interagir avec votre service web à partir de différents emplacements dans le client Teams, tels que la zone de rédaction de message, la zone de commande, ou directement à partir d’un message et de renvoyer des données structurées, telles que des cartes.

L’extension de message basé sur un bot tire parti du schéma de messagerie et du protocole de communication sécurisé de Bot Framework. Le bot est défini dans le manifeste de l’application pour l’application Teams et vous pouvez également définir différents types de commandes pour votre extension de message, tels que les commandes d’action ou les commandes de recherche.

Il existe deux types de commandes d’extension de message, la commande d’action et la commande de recherche. Le type de commande d’extension de message définit les éléments d’interface utilisateur et les flux d’interaction disponibles pour votre service web. Vous pouvez utiliser une commande de recherche ou une commande d’action pour interagir avec votre service web via un bot dans Teams.

Capture d’écran montrant comment un développeur peut sélectionner entre les commandes d’action et les commandes de recherche.

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

Remarque

La limite de taille de la carte de résultat est de 28 Ko. La carte n’est pas envoyée si sa taille dépasse 28 Ko.

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 :

Nom de la propriété Objectif Obligatoire ? Version du manifeste
id ID unique que vous affectez à la commande de recherche. La demande de l’utilisateur inclut cet ID. Oui 1.0
title Nom de la commande. Cette valeur apparaît dans l’interface utilisateur. Oui 1.0
description Texte d’aide indiquant l’action de cette commande. Cette valeur apparaît dans l’interface utilisateur. Oui 1.0
semanticDescription Description sémantique de la commande pour la consommation par les modèles de langage volumineux (LLM). Non 1.17
type Type de commande. La valeur par défaut est query. Non 1.4
initialRun Si cette propriété a la valeur true, cela indique que cette commande doit être exécutée dès que l’utilisateur sélectionne cette commande dans l’interface utilisateur. Non 1.0
context Tableau facultatif de valeurs qui définit le contexte dans lequel l’action de recherche est disponible. Les valeurs possibles sont message, compose ou commandBox. La valeur par défaut est compose,commandBox. Non 1,5

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 :

Nom de la propriété Objectif Est-ce obligatoire ? Version minimale du manifeste
parameters Définit une liste statique de paramètres pour la commande . Non 1.0
parameter.name Décrit le nom du paramètre. est parameter.name envoyé à votre service dans la demande de l’utilisateur. Oui 1.0
parameter.description Décrit les objectifs du paramètre ou l’exemple de la valeur qui doit être fournie. Cette valeur apparaît dans l’interface utilisateur. Oui 1.0
parameter.semanticDescription Description sémantique du paramètre pour la consommation par les grands modèles de langage (LLM). Non 1.17
parameter.title Titre ou étiquette court du paramètre convivial. Oui 1.0
parameter.inputType Définissez sur le type de l’entrée requise. Les valeurs possibles incluent text, textarea, number, date, time, toggle. La valeur par défaut est définie sur text. Non 1.4
parameters.value Valeur initiale du paramètre. La valeur n’est pas prise en charge Non 1,5

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

Meetings Copilot 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 à copilote de réunion et obtenir des réponses de votre plug-in qui sont pertinentes pour le contexte de réunion. Les plug-ins sont disponibles pour permettre aux utilisateurs d’activer à la fois dans Copilot pour les réunions Microsoft 365 et Copilot for Teams.

Capture d’écran montrant le menu volant des plug-ins dans les réunions Copilot pour Teams.

Avantages Description
Autonomisation des utilisateurs L’extension de Meeting Copilot permet aux utilisateurs d’effectuer diverses actions pour améliorer leur expérience de réunion.
Commandes de l’interface utilisateur Les utilisateurs peuvent facilement accéder à des fonctionnalités telles que l’ouverture d’un module de tâche ou le partage d’une application à l’étape.
Commandes de recherche Une récupération efficace des données à partir de bases de données d’application est rendue possible, ce qui simplifie le processus de recherche.
Scénarios Description
Commandes réactives Les utilisateurs peuvent directement commander Copilot pour effectuer des actions spécifiques ou fournir des informations.
- Invites en langage naturel : les utilisateurs peuvent demander à Copilot d’effectuer des commandes de recherche.
- Suggestions d’invite : les applications peuvent proposer des invites statiques ou enrichies pour que Copilot s’exécute.
Proactive Assistance Copilot écoute de manière proactive les signaux de réunion et aide les utilisateurs en :
- Suggestion d’invites à partir d’applications : suggestions contextuellement pertinentes basées sur les sujets de discussion.
- Fournir une assistance sans invites explicites : Copilot peut suggérer automatiquement des actions en fonction de la discussion.

Étape suivante

Voir aussi