Erweitern der botbasierten Nachrichtenerweiterung als Plug-In für Copilot für Microsoft 365

Hinweis

• Stellen Sie sicher, dass Copilot für Microsoft 365 für Ihre organization verfügbar ist. Sie haben zwei Möglichkeiten, eine Entwicklerumgebung für Copilot zu erhalten:
  • Ein Sandbox-Microsoft 365-Mandant mit Copilot (verfügbar in der eingeschränkten Vorschau über die TAP-Mitgliedschaft).
  • Eine berechtigte Microsoft 365- oder Office 365-Produktionsumgebung mit einer Copilot für Microsoft 365-Lizenz.
• Botbasiertes Suchnachrichtenerweiterungs-Plug-In ist in der öffentlichen Entwicklervorschau verfügbar.
• Nur botbasierte Nachrichtenerweiterungen mit Suchbefehlen können als Plug-Ins für Copilot für Microsoft 365 erweitert werden.

Microsoft Copilot für Microsoft 365, unterstützt von einer erweiterten Verarbeitungs- und Orchestrierungs-Engine, integriert Microsoft 365-Apps, Microsoft Graph und große Sprachmodelle (Large Language Models, LLMs), um Ihre Wörter in ein leistungsstarkes Produktivitätstool umzuwandeln. Obwohl Copilot für Microsoft 365 Apps und Daten innerhalb des Microsoft 365-Ökosystems nutzen können, verlassen sich viele Benutzer für die Arbeitsverwaltung und Zusammenarbeit auf verschiedene externe Tools und Dienste. Indem Sie Ihre Nachrichtenerweiterung als Plug-In in Copilot für Microsoft 365 erweitern, können Sie Benutzern die Interaktion mit Tools und Diensten von Drittanbietern ermöglichen, damit sie mit Copilot für Microsoft 365 mehr erreichen können. Sie können diese Erweiterung erreichen, indem Sie ein Plug-In entwickeln oder eine Verbindung mit einer externen Datenquelle herstellen.

Weitere Informationen zum Erweitern von Copilot für Microsoft 365 mithilfe von Teams-Nachrichtenerweiterungen finden Sie im Video:

Was ist ein Plug-In?

Ein Plug-In ermöglicht es Copilot für Microsoft 365, direkt mit Daten, Apps und Diensten von Drittanbietern zu interagieren, seine Funktionen zu erweitern und seine Möglichkeiten zu erweitern. Plug-Ins ermöglichen Copilot für Microsoft 365 Folgendes:

• Rufen Sie Echtzeitinformationen ab, z. B. die aktuelle Berichterstattung über eine Produkteinführung.
• Rufen Sie wissensbasierte Informationen ab, z. B. die Entwurfsdateien eines Teams in Figma.
• Führen Sie Aktionen im Namen des Benutzers aus, z. B. das Erstellen eines Contoso-Tickets.

Beschreibungen verbessern die Benutzerfreundlichkeit und Effektivität eines Nachrichtenerweiterungs-Plug-Ins. Die folgende Beschreibung bietet eine klare und präzise Zusammenfassung der Features der App:

• App-Beschreibung: Die App-Beschreibung trägt dazu bei, die Auffindbarkeit Ihrer App im Teams Store zu verbessern.
• Befehlsbeschreibung: Die Befehlsbeschreibung ordnet die Benutzerabsicht und -äußerung dem Suchbefehl innerhalb eines Plug-Ins zu und muss basierend auf der Analyse der Benutzerabsicht und der Schlüsselwörter erstellt werden.
• Parameterbeschreibung: Die Parameterbeschreibung erläutert die Anforderungen des Systems in einer natürlichen Sprache mit Ausgabeformat.
• Semantische Beschreibung: Die semantische Beschreibung hilft Copilot für Micrososft 365 beim Generieren von Inhalten, indem sie ein konzeptionelles Verständnis der Funktionen und Szenarien des Plug-Ins bereitstellt, in denen sie dabei helfen kann, Benutzerziele zu erreichen und die Absicht des Benutzers mit den Funktionen des Plug-Ins überein stimmen.

Weitere Informationen finden Sie unter Definieren von Beschreibungen.

Alle botbasierten Suchnachrichtenerweiterungen sind für die Plug-In-Unterstützung berechtigt, vorbehaltlich der Validierung, um sicherzustellen, dass das Plug-In die Erwartungen an Qualität, Sicherheit, Datenschutz und Nützlichkeit erfüllt. Sie können eine botbasierte Suchnachrichtenerweiterung mit Teams Toolkit für Visual Studio Code, Visual Studio, Teams Toolkit-Befehlszeilenschnittstelle (CLI) oder Dem Entwicklerportal für Teams erstellen und die Nachrichtenerweiterung so erweitern, dass sie als Plug-In in Copilot für Microsoft 365 funktioniert.

Voraussetzungen

Bevor Sie beginnen, stellen Sie sicher, dass Sie mit den folgenden Standards und Richtlinien zum Erstellen von Nachrichtenerweiterungs-Plug-Ins für Copilot für Microsoft 365 vertraut sind:

• Standards für Compliance, Leistung, Sicherheit und Benutzererfahrung, die in den Teams Store-Validierungsrichtlinien beschrieben sind.

• Richtlinien zum Erstellen oder Aktualisieren eines Nachrichtenerweiterungs-Plug-Ins für Copilot für Microsoft 365.

Erstellen einer botbasierten Nachrichtenerweiterung

Wichtig

Plug-Ins für Microsoft Copilot für Microsoft 365 befinden sich in der Vorschauphase und funktionieren nur in Microsoft 365 Chat in Microsoft Teams.

Lassen Sie uns eine botbasierte Suchnachrichtenerweiterung erstellen, die npm-Registrierungen in Teams und Copilot durchsuchen und Ergebnisse über den Nachrichtenerstellungsbereich des Microsoft Teams-Clients freigeben kann.

Visual Studio Code

Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Tools installieren, um Ihre Nachrichtenerweiterung zu erstellen und bereitzustellen:

• Installieren Sie die neueste Vorabversion des Teams Toolkits.
• Stellen Sie sicher, dass das Featureflag "Copilot-Plug-In entwickeln" aktiviert ist. Führen Sie die folgenden Schritte aus, um das Featureflag zu aktivieren:
  1. Öffnen Sie Visual Studio Code.
  2. Wechseln Sie zu Einstellungen verwalten>.
  3. Geben Sie Teams Toolkit in das Suchfeld Search Einstellungen ein.
  4. Aktivieren Sie unter Erweiterungen das Kontrollkästchen Fx-erweiterung: Copilot-Plug-In entwickeln .

Führen Sie die folgenden Schritte aus, um ein botbasiertes Suchnachrichtenerweiterungs-Plug-In mit Visual Studio Code zu erstellen:

1. Öffnen Sie Visual Studio Code.

2. Wählen Sie im linken Bereich Teams Toolkit aus.

3. Wählen Sie Neue App erstellen aus.

4. Wählen Sie Nachrichtenerweiterung aus.

5. Wählen Sie Benutzerdefinierte Search Ergebnisse aus.

6. Wählen Sie Mit einem Bot starten aus.

   

7. Wählen Sie eine Programmiersprache aus.

8. Wählen Sie Standardordner aus.

9. Geben Sie den Namen Ihrer App ein, und drücken Sie die EINGABETASTE. Teams Toolkit erstellt ein Gerüst für Ihre App und erstellt eine Nachrichtenerweiterung.

Führen Sie die folgenden Schritte aus, um Ihre Nachrichtenerweiterung in Teams auszuführen:

1. Wählen Sie im linken Bereich Teams Toolkit aus.

2. Führen Sie unter KONTEN die folgenden Schritte aus:

   1. Wählen Sie Bei Microsoft 365 anmelden aus, und geben Sie Ihre Microsoft 365-Anmeldeinformationen ein.

   2. Wählen Sie Bei Azure anmelden aus, und geben Sie Ihre Azure-Anmeldeinformationen ein.

      

3. Wählen Sie im linken Bereich Ausführen und Debuggen (STRG+UMSCHALT+D) aus.

4. Wählen Sie Debuggen in Teams (Edge) oder Debuggen in Teams (Chrome) aus. Teams Toolkit startet Ihre App in Teams mithilfe eines Webbrowsers.

5. Wählen Sie Hinzufügen. Die App wird in Teams installiert.

6. Wechseln Sie zu einem Chat, und wählen Sie Aktionen und Apps aus.

7. Geben Sie im Flyoutmenü der Nachrichtenerweiterung den Namen Ihrer Nachrichtenerweiterung in das Suchfeld ein.

8. Wählen Sie Ihre Nachrichtenerweiterung aus, und geben Sie Ihre Suchabfrage ein.

9. Wählen Sie ein Produkt aus der Liste aus. Teams entpackt das Produkt als adaptive Karte im Bereich zum Verfassen von Nachrichten.

10. Wählen Sie Senden aus.

Auslösen der Nachrichtenerweiterung in M365 Chat

Führen Sie die folgenden Schritte aus, um die Nachrichtenerweiterung als Plug-In in M365 Chat auszulösen:

1. Wählen Sie Apps aus.

2. Search für M365 Chat, und öffnen Sie die M365 Chat-App.

3. Wählen Sie Plug-Ins aus.

4. Aktivieren Sie in der Liste der Plug-Ins den Umschalter für Ihre Nachrichtenerweiterung.

   

5. Senden Sie im Bereich zum Verfassen von Nachrichten eine Nachricht an M365 Chat, um in Teams und Copilot nach npm-Paketinformationen zu suchen. Suchen Sie beispielsweise die npm-Paketinformationen unter teamsfx-react in npm-searchlocal.

   

Hinweis

Diese Aufforderung veranlasst M365 Chat möglicherweise nicht immer dazu, eine Antwort von Ihrer Nachrichtenerweiterung zu enthalten. Wenn dies der Fall ist, versuchen Sie es mit anderen Eingabeaufforderungen, oder senden Sie uns Feedback, indem Sie die Antwort des M365-Chats herabsetzen und eine Nachricht hinterlassen.

Visual Studio

Bevor Sie beginnen, stellen Sie sicher, dass Sie die folgenden Tools installieren, um Ihre Nachrichtenerweiterung zu erstellen und bereitzustellen:

• Installieren Sie die Visual Studio Enterprise 2022 Preview-Version 17.9.0 Preview 1.0 oder höher, und installieren Sie die Microsoft Teams-Entwicklungstools unter ASP.NET- und Webentwicklungsworkload.
• Stellen Sie sicher, dass das Copilot-Featureflag aktiviert ist. Führen Sie die folgenden Schritte aus, um das Featureflag zu aktivieren:
  1. Öffnen Sie Visual Studio.
  2. Wechseln Sie zu Extras>Optionen.
  3. Geben Sie Teams Toolkit in das Suchfeld Search Einstellungen ein.
  4. Aktivieren Sie unter Vorschaufeatures das Kontrollkästchen Teams Toolkit: Copilot-Plug-In entwickeln .

Führen Sie die folgenden Schritte aus, um mithilfe von Visual Studio ein botbasiertes Suchnachrichtenerweiterungs-Plug-In zu erstellen:

1. Öffnen Sie Visual Studio.

2. Wechseln Sie zu Datei>Neues>Projekt... oder Neues Projekt erstellen.

3. Search für Teams aus, und wählen Sie Microsoft Teams-App aus.

4. Wählen Sie Benutzerdefinierte Search Ergebnisse aus.

   

5. Wählen Sie Erstellen aus. Das Projekt ist ein Gerüst.

6. Wählen Sie im Dropdownmenü Debuggen die Option Dev Tunnels>Tunnel erstellen aus.

   
   

   1. Wählen Sie das Konto aus, um den Tunnel zu erstellen. Azure, Microsoft-Konto (MSA) und GitHub sind die kontotypen, die unterstützt werden.
   2. Name: Geben Sie einen Namen für den Tunnel ein.
   3. Tunneltyp: Wählen Sie Persistent oder Temporär aus.
   4. Zugriff: Wählen Sie Öffentlich aus.
   5. Wählen Sie OK aus. Visual Studio zeigt eine Bestätigungsmeldung an, dass ein Tunnel erstellt wurde.

   Der von Ihnen erstellte Tunnel ist unter Dev Tunnels (Name des Tunnels > ) aufgeführt.

7. Wechseln Sie zu Projektmappen-Explorer, und wählen Sie Ihr Projekt aus.

8. Klicken Sie mit der rechten Maustaste auf das Projektmenü, und wählen Sie Teams ToolkitPrepare Teams App Dependencies (Teams-App-Abhängigkeiten> vorbereiten) aus.

   

   Wenn Sie dazu aufgefordert werden, melden Sie sich mit einem Microsoft 365-Konto an.

9. Wählen Sie im Dropdownmenü Debuggen die Option Microsoft Teams (Browser) aus. Visual Studio startet den Teams-Webclient.

10. Wählen Sie Hinzufügen. Die Nachrichtenerweiterung wird Teams hinzugefügt.

    

11. Wechseln Sie zu einem Chat, und wählen Sie Aktionen und Apps aus.

12. Geben Sie im Flyoutmenü der Nachrichtenerweiterung den Namen Ihrer Nachrichtenerweiterung in das Suchfeld ein.

13. Wählen Sie Ihre Nachrichtenerweiterung aus, und geben Sie Ihre Suchabfrage ein.

    

14. Wählen Sie ein Produkt aus der Liste aus. Teams entpackt das Produkt in einer adaptiven Karte im Bereich zum Verfassen von Nachrichten.

15. Wählen Sie Senden aus. Die adaptive Karte wird an den Chat gesendet.

    

Auslösen der Nachrichtenerweiterung in M365 Chat

Führen Sie die folgenden Schritte aus, um die Nachrichtenerweiterung als Plug-In in M365 Chat auszulösen:

1. Wechseln Sie zu Visual Studio.

2. Wählen Sie in der Dropdownliste Debuggen die Option Copilot (Browser) aus. Visual Studio startet den Teams-Webclient.

   

3. Wechseln Sie zu Teams-Webclient-Apps>.

4. Search für M365 Chat, und öffnen Sie die M365 Chat-App.

5. Wählen Sie Plug-Ins aus.

6. Aktivieren Sie in der Liste der Plug-Ins den Umschalter für Ihre App.

   

7. Senden Sie im Bereich zum Verfassen von Nachrichten eine Nachricht an M365 Chat, um in Teams und Copilot nach npm-Paketinformationen zu suchen. Suchen Sie beispielsweise die npm-Paketinformationen auf teamsfx-react in npmsearchlocal.

   

Hinweis

Diese Aufforderung veranlasst M365 Chat möglicherweise nicht immer dazu, eine Antwort von Ihrer Nachrichtenerweiterung zu enthalten. Wenn dies der Fall ist, versuchen Sie es mit anderen Eingabeaufforderungen, oder senden Sie uns Feedback, indem Sie die Antwort des M365-Chats herabsetzen und eine Nachricht hinterlassen.

Toolkit CLI

Bevor Sie beginnen, stellen Sie sicher, dass Sie die Umgebungsvariable DEVELOP_COPILOT_PLUGIN auf true festlegen. Führen Sie die folgenden Schritte aus, um die Umgebungsvariablen festzulegen:

1. Wählen Sie auf Ihrem Computer die Windows + X-Taste aus.

2. Wählen Sie System aus.

3. Wählen Sie unter Informationen>zu Gerätespezifikationendie Option Erweiterte Systemeinstellungen aus.

4. Wählen Sie unter Systemeigenschaftendie Option Umgebungsvariablen aus.

5. Wählen Sie unter Benutzervariablendie Option Neu aus. Das Dialogfeld Neue Benutzervariable wird geöffnet.

6. Aktualisieren Sie die folgenden Felder:

   1. Variablenname: DEVELOP_COPILOT_PLUGIN
   2. Variablenwert: true

7. Wählen Sie OK aus.

   

Führen Sie die folgenden Schritte aus, um ein Bot-basiertes Suchnachrichtenerweiterungs-Plug-In mithilfe der Teams Toolkit CLI zu erstellen:

1. Wechseln Sie zur Eingabeaufforderung.

2. Geben Sie den folgenden Befehl ein:

   npm install -g @microsoft/teamsfx-cli@beta
   

3. Geben Sie im Terminal ein teamsfx new .

4. Wählen Sie Nachrichtenerweiterung aus. Verwenden Sie die Pfeiltasten, um zwischen den Optionen zu wechseln.

   

5. Wählen Sie Benutzerdefinierte Search Ergebnisse aus.

6. Wählen Sie Mit einem Bot starten aus.

   

7. Geben Sie den Speicherort für Ihr Projekt ein, und drücken Sie die EINGABETASTE.

8. Geben Sie den Namen Ihrer Anwendung ein, und drücken Sie die EINGABETASTE.

   Teams Toolkit gerüstet und erstellt ein Projekt am angegebenen Speicherort.

9. Wechseln Sie zu dem Ordnerpfad, in dem Ihr Projekt erstellt wird, und geben Sie den folgenden Befehl ein, um Ihre App in Azure bereitzustellen:

    teamsfx provision --env dev
   

   Teams Toolkit CLI öffnet ein Browserfenster und fordert Sie auf, sich bei Ihrem Microsoft-Konto anzumelden.

10. Melden Sie sich bei Ihrem Microsoft-Konto an. Die Teams Toolkit-BEFEHLSZEILE führt die Überprüfung durch und stellt Ihre App in Azure bereit.

11. Wählen Sie in der Liste ein Abonnement aus.

    

12. Wählen Sie in der Liste eine Ressourcengruppe aus.

13. Wenn Sie eine Meldung mit dem Text "Kosten" erhalten, können je nach Nutzung anfallen. Möchten Sie Ressourcen in der Entwicklungsumgebung mithilfe der oben aufgeführten Konten bereitstellen?, geben Sie Y ein.

    

    Das Teams-Toolkit überprüft Ihr App-Manifest und stellt Ihre App in Azure bereit.

14. Geben Sie im Eingabeaufforderungsfenster den folgenden Befehl ein, um eine Vorschau Ihrer App in Teams anzuzeigen:

     teamsfx preview --env dev
    

    Ein neues Browserfenster mit dem Teams-Webclient wird geöffnet. Sie können Ihre App zu Teams hinzufügen.

15. Wählen Sie Hinzufügen. Die Nachrichtenerweiterung wird Teams hinzugefügt.

16. Wechseln Sie zu einem Chat, und wählen Sie Aktionen und Apps aus.

17. Geben Sie im Flyoutmenü der Nachrichtenerweiterung den Namen Ihrer Nachrichtenerweiterung in das Suchfeld ein.

18. Wählen Sie Ihre Nachrichtenerweiterung aus, und geben Sie Ihre Suchabfrage ein.

Auslösen der Nachrichtenerweiterung in M365 Chat

Führen Sie die folgenden Schritte aus, um die Nachrichtenerweiterung über M365 Chat auszulösen:

1. Wählen Sie Apps aus.

2. Search für M365 Chat, und öffnen Sie die M365 Chat-App.

3. Wählen Sie Plug-Ins aus.

4. Aktivieren Sie in der Liste der Plug-Ins den Umschalter für Ihre App.

   

5. Senden Sie im Bereich zum Verfassen von Nachrichten eine Nachricht an M365 Chat, um in Teams und Copilot nach npm-Paketinformationen zu suchen. Suchen Sie beispielsweise die npm-Paketinformationen unter teamsfx-react in npm-searchlocal.

   

Hinweis

Diese Aufforderung veranlasst M365 Chat möglicherweise nicht immer dazu, eine Antwort von Ihrer Nachrichtenerweiterung zu enthalten. Wenn dies der Fall ist, versuchen Sie es mit anderen Aufforderungen, oder hinterlassen Sie uns Feedback, indem Sie die Antwort des M365-Chats herabsenden und eine Nachricht mit dem Tag [MessageExtension] hinterlassen.

Entwicklerportal für Teams

Führen Sie die folgenden Schritte aus, um mithilfe des Entwicklerportals für Teams ein botbasiertes Suchnachrichtenerweiterungs-Plug-In zu erstellen:

1. Wechseln Sie zum Teams-Entwicklerportal.

2. Wechseln Sie zu Apps.

3. Wählen Sie + Neue Apps aus.

4. Wählen Sie unter Konfigurieren die Option App-Features aus.

5. Wählen Sie Messaging-Erweiterung aus.

   

6. Wählen Sie unter Nachrichtenerweiterungstyp die Option Bot aus.

   1. Wenn Sie einen Haftungsausschluss erhalten, der besagt, dass die API-Nachrichtenerweiterung bereits von Benutzern verwendet wird. Möchten Sie den Nachrichtenerweiterungstyp in bot ändern?. Wählen Sie Ja, ändern aus.

   

7. Wenn Sie über einen vorhandenen Bot verfügen, wählen Sie Vorhandenen Bot aus, oder wenn Sie über eine Bot-ID verfügen, wählen Sie Bot-ID eingeben aus.

   1. Wenn Sie nicht über eine Bot-ID verfügen, können Sie Neuen Bot erstellen auswählen, um einen neuen Bot zu erstellen und die Bot-ID des neuen Bots einzugeben, den Sie erstellt haben.

   

8. Klicken Sie auf Speichern.

9. Wählen Sie unter Befehldie Option + Befehl hinzufügen aus.

   Eine Befehlsseite hinzufügen wird angezeigt.

10. Wählen Sie auf der Seite Befehl hinzufügen den Search als Befehlstyp aus, und aktualisieren Sie die folgenden Felder:

    • Befehls-ID
    • Befehlstitel
    • Befehlsbeschreibung
    • Kontext, in dem der Befehl funktioniert
    • Parametername
    • Parametertitel
    • Parameterbeschreibung

11. Klicken Sie auf Speichern. Der Befehl wird der Nachrichtenerweiterung hinzugefügt.

12. Klicken Sie auf Speichern.

Eine botbasierte Suchnachrichtenerweiterung wird erstellt.

Um Ihre botbasierte Nachrichtenerweiterung zu testen, die im Entwicklerportal für Teams erstellt wurde, können Sie die folgenden Methoden verwenden:

• Vorschau in Teams: Öffnen Sie im Entwicklerportal Ihre Nachrichtenerweiterung, und wählen Sie in Teams in der oberen rechten Ecke Vorschau aus. Sie werden zu Teams weitergeleitet, wo Sie die App zu Teams hinzufügen können, um eine Vorschau der App anzuzeigen.

• App-Paket herunterladen: Wählen Sie auf der Seite der Nachrichtenerweiterung im linken Bereich App-Paket aus, und wählen Sie dann in der oberen linken Ecke des Fensters App-Paket herunterladen aus. Das App-Paket wird in einer .zip-Datei auf Ihren lokalen Computer heruntergeladen. Sie können das App-Paket in Teams hochladen und die Nachrichtenerweiterung testen.

Weitere Informationen zum Testen Ihres Plug-Ins in Copilot für Microsoft 365 Chat finden Sie unter Debugging-Plug-In-Auswahl.

Schrittweise Anleitung

Befolgen Sie die Schritt-für-Schritt-Anleitung , um ein botbasiertes Suchnachrichtenerweiterungs-Plug-In für M365 Chat zu erstellen.

Siehe auch

• Erstellen von Nachrichtenerweiterungen mithilfe der API
• Definieren von Aktionsbefehlen für Nachrichtenerweiterungen
• Erweitern von Microsoft Copilot für Microsoft 365