Erstellen von Nachrichtenerweiterungen mit Bot Framework

Mithilfe von Suchbefehlen für Nachrichtenerweiterungen können Benutzer externe Systeme durchsuchen und die Ergebnisse dieser Suche in form einer Karte in eine Nachricht einfügen. In diesem Dokument erfahren Sie, wie Sie Speicherorte für suchbefehlsaufrufe auswählen und dem App-Manifest den Suchbefehl hinzufügen.

Im folgenden Video erfahren Sie, wie Sie Suchbefehle für Nachrichtenerweiterungen definieren:

Der Suchbefehl in einer Nachrichtenerweiterung wird mithilfe der composeExtensions.commands -Eigenschaft und des query Typs im App-Manifest (zuvor als Teams-App-Manifest bezeichnet) konfiguriert. Befehls- und Parameterbeschreibungen verbessern die Benutzerfreundlichkeit und Effektivität einer Nachrichtenerweiterung. Eine gute Befehlsbeschreibung bietet eine klare und präzise Zusammenfassung der Features der App.

Der folgende Code ist ein Beispiel für die -Eigenschaft, die composeExtensions einen Suchbefehl definiert:

{
 "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
    }
  ],

Parameter

Sie müssen dem composeExtensions.commands Array von Objekten die folgenden Parameter hinzufügen:

Sie müssen die folgenden Suchparameterdetails hinzufügen, die den Für Ihren Benutzer im Teams-Client sichtbaren Text definieren:

Weitere Informationen finden Sie unter App-Manifestschema.

Nachrichtenerweiterung als Plug-In für Copilot für Teams-Besprechungen

Nachrichtenerweiterungs-Plug-Ins werden in Copilot für Teams-Besprechungen unterstützt. Wenn Sie botbasierte Nachrichtenerweiterungs-Plug-Ins auf Besprechungen erweitern, können Sie copilot for Teams-Besprechungen verbessern. Copilot für Teams-Besprechungen kann verschiedene App-Funktionen während Besprechungen nutzen, z. B. Aufgabenmodule, App-Freigaben und vieles mehr, um die Benutzerbindung und Produktivität zu verbessern. Beispielsweise kann ein Plug-In in Copilot für Teams-Besprechungen verwendet werden, um Diskussionen zusammenzufassen, Notizen zu generieren und Aufgaben aufzulisten. Außerdem werden die Vorteile herkömmlicher Plug-Ins erweitert, indem die Echtzeitinteraktion mit externen Daten und benutzerdefinierten Funktionen ermöglicht wird.

Copilot für Teams-Besprechungen ist interaktiv und effizient und kann ihnen helfen, Diskussionen zusammenzufassen, Aktionselemente vorzuschlagen und unterstützungslose Unterstützung in Echtzeit bereitzustellen. Benutzer können Copilot für Teams-Besprechungen Fragen in natürlicher Sprache stellen und Antworten von Ihrem Plug-In erhalten, die für den Besprechungskontext relevant sind. Plug-Ins sind für Benutzer verfügbar, die sowohl in Microsoft 365 Copilot als auch in Copilot für Teams-Besprechungen aktiviert werden können.

Nächster Schritt

Aktionsbefehle ermöglichen es Ihnen, Ihren Benutzern ein modales Popupfenster zu präsentieren, das als Aufgabenmodul in Teams bezeichnet wird. Das Aufgabenmodul sammelt Informationen oder zeigt diese an, verarbeitet die Interaktion und sendet die Informationen an Teams zurück. In diesem Dokument erfahren Sie, wie Sie Speicherorte zum Aufrufen des Aktionsbefehls auswählen, ein Aufgabenmodul erstellen, die endgültige Nachricht oder Karte senden sowie einen Aktionsbefehl mit App Studio oder manuell erstellen.

Der Aktionsbefehl in einer Nachrichtenerweiterung wird mithilfe der -Eigenschaft und action des composeExtensions.commands Typs im App-Manifest konfiguriert.

Der folgende Code ist ein Beispiel für die -Eigenschaft, die composeExtensions einen Aktionsbefehl definiert:

"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"
                        }
                    ]
                }
            ]
        }
    ]

Parameter

Sie müssen dem composeExtensions.commands Array von Objekten die folgenden Parameter hinzufügen:

Wenn Sie eine statische Liste von Parametern verwenden, müssen Sie auch die folgenden Parameter hinzufügen:

Wenn Sie eine eingebettete Webansicht verwenden, können Sie optional das taskInfo -Objekt hinzufügen, um Ihre Webansicht abzurufen, ohne ihren Bot direkt aufzurufen. Wenn Sie diese Option auswählen, ist das Verhalten ähnlich wie bei der Verwendung einer statischen Liste von Parametern. Die erste Interaktion mit Ihrem Bot besteht darin, auf die Aufgabenmodul-Sendeaktion zu reagieren. Wenn Sie ein taskInfo -Objekt verwenden, müssen Sie den fetchTask Parameter auf falsefestlegen.

Weitere Informationen finden Sie unter App-Manifestschema.

Nächster Schritt