Teams-App-Testtool für Visual Studio

  • Artikel

Das Teams App-Testtool (Testtool) ermöglicht das mühelose Debuggen von botbasierten Apps. 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, Tunneling oder eine Teams-App- und Bot-Registrierung, um das Testtool verwenden zu können.

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

Screenshot der adaptiven Karte des Teams-App-Testtools.

Im Folgenden sind die Vorteile des Testtools aufgeführt:

  • Sandboxumgebung: Die Sandboxumgebung des Testtools emuliert das Verhalten, aussehen und die Benutzererfahrung von Teams.

  • Tunneling: Ein externer Tunneldienst ist nicht erforderlich, da das Testtool 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: Das Testtool 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: Das Testtool ist zuverlässig, da die adaptive Karte des Bots dieselbe Renderingtechnologie wie in Teams verwendet.

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

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

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Tools zum Erstellen und Bereitstellen Ihres Bots im Testtool installieren:

Installieren Zum Benutzen...
Node.js Back-End-JavaScript-Laufzeitumgebung.
Visual Studio 2022
 Sie können die Unternehmensversion in Visual Studio 2022 und die Workloads ASP.NET und Webentwicklung installieren. Verwenden Sie version 17.9 oder höher.

Testen des Tools in Visual Studio

Das Testtool bietet eine schnellere Debugerfahrung für Botanwendungen im Vergleich zum Teams-Client. Das Testtool 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 im Testtool zu debuggen:

  1. Öffnen Sie Visual Studio.

  2. Wählen Sie Neues Projekt erstellen aus.

    Screenshot: Auswahl zum Erstellen eines neuen Projekts

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

  4. Wählen Sie Weiter aus.

    Screenshot: Auswahl von Vorlagen zum Erstellen eines neuen Projekts

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

    Screenshot: Option zum Eingeben des Projektnamens

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

    Hinweis

    Screenshot: Auswahl der Teams-Anwendung zum Erstellen eines neuen Projekts

    Das Fenster GettingStarted wird angezeigt.

    Screenshot: Seite

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

    • Aktualisieren Sie OpenAI ApiKey in der appsettings.TestTool.json Datei.

      Screenshot: Aktualisierter OpenAI-Schlüssel

  8. Wählen Sie in der Dropdownliste Debuggen die Option Teams App Test Tool (Browser) aus.

    Screenshot: Option zum Auswählen des Teams-App-Testtools in der Dropdownliste

    Das Testtool öffnet den Bot auf einer Webseite.

    Screenshot: Bot öffnet das Testtool auf der Webseite.

Aktivitätstrigger

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

Vordefinierte Aktivitätstrigger

Das Testtool stellt vordefinierte Aktivitätstrigger zum Testen der Funktionen Ihres Bots bereit.

Kategorie Aktivität Handler
Auslösen der Updateaktivität für die Installation Installieren des Bots


Deinstallieren des Bots		 onInstallationUpdate
onInstallationUpdateAdded

onInstallationUpdate
onInstallationUpdateRemove
Auslösen der Konversationsaktualisierungsaktivität Benutzer hinzufügen

Bot hinzufügen

Kanal hinzufügen		 onMembersAdded

onTeamsMembersAddedEvent

onTeamsChannelRenamedEvent
Entfernen eines Benutzers


Bot entfernen


Kanal entfernen

Team entfernen		 onMembersRemoved
onTeamsMembersRemovedEvent

onMembersRemoved
onTeamsMembersRemovedEvent

onTeamsChannelDeletedEvent

onTeamsTeamDeletedEvent
Kanal umbenennen

Team umbenennen		 onTeamsChannelRenamedEvent

onTeamsTeamRenamedEvent

Hinweis

Nicht alle Arten von Aktivitäten sind in allen Bereichen verfügbar. Sie können z. B. keinen Kanal in einem persönlichen Chat oder einem Gruppenchat hinzufügen oder entfernen.

Vordefinierte Aktivitätstrigger sind im Testtool im Menü Aktivität simulieren 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.

    Screenshot: Code, der program.cs Datei hinzugefügt wurde, um einen vordefinierten Benutzer zum Hinzufügen einer Pseudoaktivität hinzuzufügen.

  4. Wechseln Sie im Testtool zu Aktivität simulieren , und wählen Sie Benutzer hinzufügen aus.

    Screenshot: Option

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

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

    Screenshot: Option zum Senden von Aktivitäten für vordefinierte Pseudoaktivität zum Hinzufügen eines Benutzers

    Der Bot sendet eine Antwort.

    Screenshot: Antwort der vordefinierten Pseudoaktivität zum Hinzufügen eines Benutzers

Benutzerdefinierte Aktivitätstrigger

Sie können die benutzerdefinierte Aktivität verwenden, um den Aktivitätstrigger reactionsAddedan die Anforderungen Ihrer Bot-App anzupassen. Das Testtool 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.

    Screenshot: Code, der program.cs-Datei zur Anpassung der Pseudoaktivität hinzugefügt wurde.

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

    Screenshot: Auswahl von

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

    Screenshot: Liste der Optionen unter

  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.

    Screenshot: Option zum Senden von Aktivitäten nach der Anpassung der Pseudoaktivität

    Der Bot sendet als Antwort einen onReactionsAdded Handler.

    Screenshot: Antwort der benutzerdefinierten Pseudoaktivität

Begrenzungen

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

  • Das Testtool unterstützt nicht alle Arten von Karten mit Ausnahme von adaptiven Karten.

  • Das Testtool unterstützt die folgenden Features für adaptive Karten nicht:

  • Das Testtool unterstützt die folgenden Funktionen nicht:

    • Mobil
    • Besprechung

Siehe auch