Teams-App-Testtool für Visual Studio

Artikel
03/13/2024

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:

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:

Öffnen Sie Visual Studio.
Wählen Sie Neues Projekt erstellen aus.
Geben Sie im Suchfeld Microsoft Teams ein. Wählen Sie in den Suchergebnissen Microsoft Teams-App aus.
Wählen Sie Weiter aus.
Geben Sie Projektname ein , und wählen Sie Erstellen aus.
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.
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:
- OpenAI
- Azure OpenAI
Aktualisieren Sie OpenAI ApiKey in der appsettings.TestTool.json Datei.
1. Aktualisieren Sie Azure OpenAIApiKey und OpenAIEndpoint in der appsettings.TestTool.json Datei.
2. Ersetzen Sie den Modellnamen durch den Azure OpenAI-Modellbereitstellungsnamen in der Program.cs Datei.
Wählen Sie in der Dropdownliste Debuggen die Option Teams App Test Tool (Browser) aus.

Das Testtool öffnet den Bot auf einer 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
Benutzerdefinierte Aktivitätstrigger

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:

Navigieren Sie in Visual Studio Code zum Projektmappen-Explorer.
Wählen Sie die Program.cs Datei aus.
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.
Wechseln Sie im Testtool zu Aktivität simulieren , und wählen Sie Benutzer hinzufügen aus.

Ein Popupdialogfeld wird angezeigt, um eine Vorschau des Aktivitätshandlers anzuzeigen.
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. 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.

Navigieren Sie in Visual Studio Code zum Projektmappen-Explorer.
Wählen Sie die Program.cs Datei aus.
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.
Navigieren Sie zur Webseite Testtool, und wählen Sie im Protokollbereich die neueste Antwort aus, um zu kopieren replyToId.
Wählen SieBenutzerdefinierte Aktivität>simulieren aus.
Fügen Sie zum Anpassen der Aktivität unter der -Eigenschaft hinzu messageReactiontype .

Ersetzen Sie durch die neueste replyToId.

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

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 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

Freigeben über