Microsoft 365 Agents Playground für Visual Studio

Microsoft 365 Agents Playground (früher als Teams App Test Tool bekannt) macht das Debuggen von botbasierten Apps mühelos. Sie können mit Ihrem Bot chatten und seine Nachrichten und adaptive Karten anzeigen, wie sie in Microsoft Teams angezeigt werden. Sie benötigen kein Microsoft 365-Entwicklerkonto, kein Tunneling oder keine Teams-App- und Bot-Registrierung, um Agents Playground verwenden zu können.

Die folgende Abbildung zeigt eine Beispiel-App, die eine Antwort im Agents Playground anzeigt:

Im Folgenden sind die Vorteile von Agents Playground aufgeführt:

• Sandboxumgebung: Die Sandboxumgebung von Agents Playground emuliert das Verhalten, das Aussehen und die Benutzererfahrung von Teams.

• Tunneling: Ein externer Tunneldienst ist nicht erforderlich, da Agents Playground auf einem lokalen Server ausgeführt wird, mit dem Ihr Bot kommunizieren kann.

• Reduzieren von Kontoabhängigkeiten: Der Microsoft 365-Entwicklermandant und die App-Uploadberechtigungen sind zum Debuggen des Bots nicht erforderlich.

• Schnelle Iterationen in inneren Schleifen: Optimiert den Prozess der Änderungen am App-Design und der Botlogik, ohne den Bot erneut in der Cloud bereitstellen zu müssen.

• Modelldaten und Aktivitäten: Agents Playground erleichtert das Testen komplexer Szenarien, z. B. das Senden einer Begrüßungsnachricht, wenn ein neues Mitglied dem Kanal beitritt, und die Verwendung von Pseudodaten und Aktivitätstriggern.

• Zuverlässig: Agents Playground ist zuverlässig, da die adaptive Karte des Bots dieselbe Renderingtechnologie wie in Teams verwendet.

• Integration in vorhandene Teams-Botanwendungen: Agents Playground lässt sich mühelos in vorhandene Teams-Botanwendungen integrieren, die mit dem Bot Framework SDK erstellt wurden.

• Unterstützung für verschiedene Bereiche: Agents Playground unterstützt Tests in persönlichen, Team- und Gruppenchatbereichen.

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Tools zum Erstellen und Bereitstellen Ihres Bots in Agents Playground installieren:

Agents Playground-Erfahrung in Visual Studio

Agents Playground bietet im Vergleich zum Teams-Client eine schnellere Debugerfahrung für Botanwendungen. Agents Playground bietet Unterstützung für alle Bot-App-Features. In diesem Szenario verwenden wir den KI-Chatbot als Beispiel. Führen Sie die folgenden Schritte aus, um Ihren Bot in Agents Playground zu debuggen:

1. Öffnen Sie Visual Studio.

2. Wählen Sie Neues Projekt erstellen aus.

   

3. Geben Sie im Suchfeld Microsoft Teams ein. Wählen Sie in den Suchergebnissen Microsoft Teams-App aus.

4. Wählen Sie Weiter aus.

   

5. Geben Sie Projektname ein , und wählen Sie Erstellen aus.

   

6. Wählen Sie AI Chat Bot>Erstellen aus.

   Hinweis

   • OpenAI oder Azure OpenAI sind die Voraussetzung für das Debuggen der AI Chat Bot-App .

   

   Das Fenster GettingStarted wird angezeigt.

   

7. Die appsettings.Playground.json Datei hilft beim Konfigurieren von Agents Playground, indem einige Parameter aktualisiert werden. Führen Sie zum Aktualisieren appsettings.Playground.json der Datei entweder die OpenAI- oder Azure OpenAI-Schritte aus:

   • OpenAI
   • Azure OpenAI

   Aktualisieren Sie OpenAI ApiKey in der appsettings.Playground.json Datei.

   

8. Wählen Sie in der Dropdownliste Debuggen die Option Microsoft 365 Agents Playground (Browser) aus.

   

   Agents Playground öffnet den Bot auf einer Webseite.

   

Aktivitätstrigger

Sie können eine Aktivität im Agents Playground mithilfe von Aktivitätstriggern simulieren. Es gibt zwei Arten von Aktivitätstriggern:

• Vordefinierte Aktivitätstrigger
• Benutzerdefinierte Aktivitätstrigger

Vordefinierte Aktivitätstrigger

Agents Playground bietet vordefinierte Aktivitätstrigger zum Testen der Funktionen Ihres Bots.

Vordefinierte Aktivitätstrigger sind im Menü Aktivität simulieren im Agents Playground verfügbar. In diesem Szenario verwenden wir den Trigger " Benutzeraktivität hinzufügen " als Beispiel. Führen Sie die folgenden Schritte aus, um eine Benutzer hinzufügen-Aktivität zu simulieren:

1. Wechseln Sie in Visual Studio Code zu Projektmappen-Explorer.

2. Wählen Sie die Program.cs Datei aus.

3. Fügen Sie in der Program.cs-Datei unter builder.Services.AddTransient<IBot>(sp => den folgenden Code hinzu:

   app.OnConversationUpdate("membersAdded", async (context, state, cancellationToken) =>
   {
      await context.SendActivityAsync($"new member added", cancellationToken: cancellationToken);
   });
   

   Der OnConversationUpdate Handler erkennt die Mitglieder, die an der Unterhaltung teilnehmen, wie in der Aktivität Benutzer hinzufügen beschrieben.

   

4. Wechseln Sie in Agents Playground zu Aktivität simulieren , und wählen Sie Benutzer hinzufügen aus.

   

   Ein Popupdialogfeld wird angezeigt, um eine Vorschau des Aktivitätshandlers anzuzeigen.

5. Wählen Sie Aktivität senden aus.

   

   Der Bot sendet eine Antwort.

   

Benutzerdefinierte Aktivitätstrigger

Sie können die benutzerdefinierte Aktivität verwenden, um den Aktivitätstrigger reactionsAddedan die Anforderungen Ihrer Bot-App anzupassen. Agents Playground füllt automatisch die erforderlichen Eigenschaften der Aktivität auf. Sie können auch den Aktivitätstyp ändern und weitere Eigenschaften wie , MembersAddedmembersremovedund reactionsremovedhinzufügen.

1. Wechseln Sie in Visual Studio Code zu Projektmappen-Explorer.

2. Wählen Sie die Program.cs Datei aus.

3. Fügen Sie in der Program.cs-Datei unter builder.Services.AddTransient<IBot>(sp => den folgenden Code hinzu:

   app.OnMessageReactionsAdded(async (context, state, cancellationToken) =>
   {
      await context.SendActivityAsync($"reaction added.", cancellationToken: cancellationToken);
   });
   

   Der OnMessageReactionsAdded Handler identifiziert die anzufügende Reaktion mithilfe der ReplyToId -Eigenschaft der vorherigen Konversation.

   

4. Wechseln Sie zur Webseite Agents Playground, und wählen Sie im Protokollbereich die neueste Antwort aus, um zu kopieren replyToId.

   

5. Wählen SieBenutzerdefinierte Aktivität>simulieren aus.

   

6. Fügen Sie zum Anpassen der Aktivität unter der -Eigenschaft hinzu messageReactiontype .

7. Ersetzen Sie durch die neueste replyToId.

   {
     "type": "messageReaction",
     "reactionsAdded": [
       {
         "type": "like"
       }
     ],
     "replyToId": "d60fd1cb-3e8f-44ef-849c-404806ba1b47"
   }
   

8. Wählen Sie Aktivität senden aus.

   

   Der Bot sendet als Antwort einen onReactionsAdded Handler.

   

Begrenzungen

• Botfeatures, die über das App-Manifest aktiviert wurden, sind nicht verfügbar, da Agents Playground sie nicht verarbeitet.

• Agents Playground unterstützt nicht alle Arten von Karten mit Ausnahme von adaptiven Karten.

• Agents Playground unterstützt die folgenden Features für adaptive Karten nicht:

  • Typeahead
  • benutzer Erwähnung
  • Stageview
  • Adaptive Karte in ganzer Breite

• Agents Playground unterstützt die folgenden Funktionen nicht:

  • Mobil
  • Besprechung

Siehe auch

• Übersicht über das Microsoft 365-Agents-Toolkit
• Erstellen von Bots für Teams
• Adaptive Karte
• Bot Framework SDK