Teilen über


Testen und debuggen Sie Ihren Bot lokal mit der IDE

Beim Testen Ihres Bots müssen Sie sowohl die Kontexte berücksichtigen, in denen Ihr Bot ausgeführt werden soll, als auch alle Funktionen, die Sie Ihrem Bot hinzufügen, die für Microsoft Teams spezifische Daten erfordern. Stellen Sie sicher, dass die Methode, die Sie zum Testen Ihres Bots ausgewählt haben, seiner Funktionalität entspricht.

Testen durch Hochladen in Microsoft Teams

Die umfassendste Methode zum Testen Ihres Bots besteht darin, ein App-Paket zu erstellen und es in Microsoft Teams hochzuladen. Das Hochladen des App-Pakets in Teams ist die einzige Methode, um die für Ihren Bot verfügbaren Funktionen in allen Bereichen zu testen.

Es gibt zwei Methoden zum Hochladen Ihrer App:

Hinweis

Um das Manifest zu ändern und Ihre App erneut hochzuladen, löschen Sie den Bot, bevor Sie das geänderte App-Paket hochladen. Um den Bot zu testen, aktivieren Sie den benutzerdefinierten App-Upload in Teams. Weitere Informationen finden Sie unter Aktivieren des Uploads von benutzerdefinierten Apps.

Es wird nicht empfohlen, mehrere Apps mit unterschiedlichen Inhalten unter derselben Bot-ID hochzuladen. Dies kann zu unvorhersehbarem Botverhalten führen. Entfernen oder deinstallieren Sie alle früheren Versionen der Apps, um sicherzustellen, dass nur die neueste Version hochgeladen wird. Wenn die Apps dieselbe Bot-ID verwenden, weisen Sie die erforderlichen Berechtigungen im App-Paket zu. Aktivieren Sie außerdem sowohl Apps in der App-Berechtigungsrichtlinie als auch die verwalteten Apps, um sicherzustellen, dass sie nicht blockiert werden. Andernfalls kann die App-Nutzung zu Problemen führen.

Lokales Debuggen Ihres Bots

Wenn Sie Ihren Bot während der Entwicklung lokal hosten, müssen Sie einen Tunneldienst wie ngrok verwenden, um Ihren Bot zu testen. Nachdem Sie ngrok heruntergeladen und installiert haben, fügen Sie Ihrem Pfad ngrok hinzu, und führen Sie den folgenden Befehl aus, um den Tunneldienst zu starten:

ngrok http <port> --host-header=localhost:<port>

Verwenden Sie den https-Endpunkt, der von ngrok in Ihrem App-Manifest bereitgestellt wird.

Hinweis

  • Wenn Sie das Befehlsfenster schließen und einen Neustart durchführen, erhalten Sie eine neue URL und müssen Ihre Bot-Endpunktadresse aktualisieren, um auch diese zu verwenden.
  • Bots, die über Microsoft Bot Framework erstellt wurden, müssen über den HTTPS-Endpunkt zugänglich sein, der Endpunkt wird jedoch nicht verfügbar gemacht. Der Endpunkt ist nur zwischen Bot Framework und Ihrer internen Adresse verknüpft.

Testen Ihres Bots ohne Hochladen in Microsoft Teams

Gelegentlich ist es erforderlich, Ihren Bot zu testen, ohne ihn als App in Microsoft Teams zu installieren. Wir stellen zwei Methoden zum Testen des Bots bereit. Das Testen Ihres Bots, ohne ihn als App zu installieren, kann nützlich sein, um sicherzustellen, dass Ihr Bot verfügbar ist und reagiert. Es ermöglicht Ihnen jedoch nicht, die gesamte Bandbreite der Microsoft Teams-Funktionen zu testen, die Sie Ihrem Bot hinzugefügt haben. Wenn Sie Ihren Bot vollständig testen möchten, sehen Sie sich Testen durch Hochladen an.

Verwenden des Bot-Emulators

Der Bot Framework Emulator ist eine Desktopanwendung, die es Bot-Entwicklern ermöglicht, ihre Bots entweder lokal oder remote zu testen und zu debuggen. Der Emulators hilft Ihnen mit Ihrem Bot zu chatten und die Nachrichten zu überprüfen, die Ihr Bot sendet und empfängt. Dies ist nützlich, um zu überprüfen, ob Ihr Bot verfügbar ist und reagiert. Mit dem Emulator können Sie jedoch keine Teams-spezifischen Funktionen testen, die Sie dem Bot hinzufügen. Die Antworten ihres Bots stellen keine genaue visuelle Darstellung der Art dar, wie sie in Teams gerendert werden. Wenn Sie eines dieser Dinge testen müssen, ist es am besten, Ihren Bot hochzuladen.

Weitere Informationen finden Sie in den vollständigen Anweisungen zum Bot Framework Emulator.

Direkt per ID mit Ihrem Bot kommunizieren

Wichtig

  • Die Kommunikation mit Ihrem Bot per ID ist nur für grundlegende Testzwecke vorgesehen. Alle Teams-spezifischen Funktionen, die Sie Ihrem Bot hinzufügen, funktionieren nicht.
  • Ab dem 31. Januar 2024 können Benutzer nicht mehr mit Bots chatten, die nicht mit einer Microsoft Teams-App verbunden sind, z. B. Mit Azure-Bots, die über bot Framework oder Power Virtual Agents erstellt wurden. Es wird empfohlen, eine neue Teams-App zu erstellen, die mit dem Azure-Bot über das Entwicklerportal verbunden ist, sie in Teams zu veröffentlichen und Benutzern die Installation der App mithilfe der App-Berechtigungsrichtlinien zu ermöglichen. Wenn Sie die App testen möchten, können Sie Benutzern eine App-Setuprichtlinie zuweisen, die das Hochladen benutzerdefinierter Apps und chatten mit dem Azure-Bot über einen direkten Link zu einem Chat ermöglicht.

Initiieren Sie eine Konversation mit Ihrem Bot, indem Sie dessen ID verwenden. Wenn ein Bot über eine dieser Methoden hinzugefügt wird, ist er in Kanalunterhaltungen nicht adressierbar, und Sie können keine anderen Teams-App-Funktionen wie Registerkarten oder Nachrichtenerweiterungen nutzen. Initiieren Sie eine Unterhaltung auf eine der folgenden Arten:

  • Wählen Sie auf der seite Bot-Dashboard für Ihren Bot unter Kanäle die Option Zu Microsoft Teams hinzufügen aus. Teams startet einen persönlichen Chat mit Ihrem Bot.

  • Verweisen Sie in Teams direkt auf die App-ID Ihres Bots:

    1. Wechseln Sie zu Details des Botdashboards>, und kopieren Sie die Microsoft-App-ID für Ihren Bot.

      Screenshot: Microsoft-App-ID auf der Detailseite

    2. Öffnen Sie Microsoft Teams, und wählen Sie im Bereich Chat das Symbol Neuer Chat aus. Geben Sie in der Datei An: die Microsoft-App-ID Ihres Bots ein.

      Screenshot: Symbol

      Die App-ID muss in Ihrem Botnamen aufgelöst werden.

    3. Wählen Sie Ihren Bot aus, und senden Sie eine Nachricht, um eine Unterhaltung zu starten. Alternativ können Sie die App-ID Ihres Bots oben links in Teams in das Suchfeld einfügen. Wechseln Sie auf der Suchergebnisseite zur Registerkarte Personen, um Ihren Bot anzuzeigen und damit zu chatten.

Hinweis

Damit Teams auf die App-ID Ihres Bots verweisen kann, aktivieren Sie den benutzerdefinierten App-Upload.

Ihr Bot empfängt das conversationUpdate-Ereignis, wenn Sie die Bots zu einem Team hinzufügen, jedoch ohne die Teaminformationen im channelData-Objekt.

Blockieren eines Bots im persönlichen Chat

Benutzer können ihren Bot am Senden persönlicher Chatnachrichten hindern. Sie können dies umschalten, indem sie im Chatkanal mit der rechten Maustaste auf Ihren Bot klicken und Botkonversation blockieren auswählen. Dies bedeutet, dass Ihre Bots weiterhin Nachrichten senden, aber der Benutzer empfängt die Nachrichten nicht.

Screenshot: Option

Entfernen eines Bots aus einem Team

Benutzer können den Bot löschen, indem sie in ihrer Teams-Ansicht in der Bots-Liste das Papierkorbsymbol auswählen. Dadurch wird der Bot nur aus der Verwendung durch dieses Team entfernt. Einzelne Benutzer können weiterhin im persönlichen Kontext interagieren. Benutzer können Bots im persönlichen Kontext nicht entfernen oder deaktivieren.

Deaktivieren eines Bots in Teams

Um zu verhindern, dass Ihr Bot Nachrichten empfängt, wechseln Sie zu Ihrem Bot-Dashboard, und bearbeiten Sie den Teams-Kanal. Deaktivieren Sie die Option In Microsoft Teams aktivieren. Dadurch wird verhindert, dass Benutzer mit dem Bot interagieren, aber er ist weiterhin auffindbar, und Benutzer können ihn Teams hinzufügen.

Löschen eines Bots aus Microsoft Teams

Um Ihren Bot vollständig aus Microsoft Teams zu entfernen, wechseln Sie zu Ihrem Bot-Dashboard, und bearbeiten Sie den Teams-Kanal. Klicken Sie auf die Schaltfläche Löschen am unteren Rand der Seite. Das Löschen eines Bots aus Teams verhindert, dass Benutzer Ihren Bot entdecken, hinzufügen und mit diesem interagieren können. Durch das Löschen eines Bots aus Teams wird der Bot nicht aus den Teams-Instanzen anderer Benutzer entfernt, er funktioniert jedoch auch nicht mehr für ihn.

Siehe auch