Testen und Debuggen Ihres Microsoft Teams-Bots

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 hinzugefügt haben und die Microsoft Teams-spezifische Daten erfordern. Stellen Sie sicher, dass die Methode, die Sie zum Testen Ihres Bots gewählt haben, mit seiner Funktionalität übereinstimmt.

Testen durch Hochladen in Teams

Die umfassendste Möglichkeit zum Testen Ihres Bots besteht darin, ein App-Paket zu erstellen und in Teams hochzuladen. Das Hochladen der App in Teams ist die einzige Methode, um die volle Funktionalität zu testen, die Ihrem Bot in allen Bereichen zur Verfügung steht.

Es gibt zwei Methoden zum Hochladen Ihrer App. Sie können entweder das Entwicklerportal für Teams verwenden oder manuell ein App-Paket erstellen und Ihre App hochladen. Wenn Sie Ihr Manifest ändern und Ihre App erneut hochladen müssen, sollten Sie Ihren Bot löschen , bevor Sie Ihr geändertes App-Paket hochladen.

Bot lokal debuggen

Wenn Sie Ihren Bot während der Entwicklung lokal hosten, müssen Sie einen Tunnelingdienst wie ngrok verwenden, um Ihren Bot zu testen. Nachdem Sie ngrok heruntergeladen und installiert haben, führen Sie den folgenden Befehl aus, um den Tunneling-Dienst zu starten. Möglicherweise müssen Sie Ihrem Pfad ngrok hinzufügen.

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

Verwenden Sie den von ngrok bereitgestellten HTTPS-Endpunkt in Ihrem App-Manifest. Wenn Sie Ihr Befehlsfenster schließen und neu starten, erhalten Sie eine neue URL und müssen Ihre Bot-Endpunktadresse aktualisieren, um diese auch zu verwenden.

Testen Ihres Bots ohne Hochladen in Teams

Gelegentlich ist es notwendig, Ihren Bot zu testen, ohne ihn als App in Teams zu installieren. Das Testen Ihres Bots ohne Installation als App kann nützlich sein, um sicherzustellen, dass Ihr Bot verfügbar ist und reagiert. Allerdings können Sie nicht die gesamte Bandbreite der Teams-Funktionalität testen, die Sie Ihrem Bot hinzugefügt haben. Wenn Sie Ihren Bot vollständig testen müssen, folgen Sie den Anweisungen zum Testen durch Hochladen.

Verwenden des Bot-Emulators

Der Bot Framework Emulator ist eine Desktopanwendung, mit der Bot-Entwickler ihre Bots lokal oder remote testen und debuggen können. Mithilfe des Emulators können Sie mit Ihrem Bot chatten und die Nachrichten überprüfen, die Ihr Bot sendet und empfängt. Dies kann nützlich sein, um zu überprüfen, ob Ihr Bot verfügbar ist und reagiert. Der Emulator ermöglicht Ihnen jedoch weder das Testen von Teams-spezifischen Funktionen, die Sie Ihrem Bot hinzugefügt haben, noch sind die Antworten Ihres Bots eine genaue visuelle Darstellung dessen, wie sie in Teams gerendert werden. Wenn Sie eines dieser Dinge testen müssen, ist es nicht am besten, Ihren Bot hochzuladen.

Eine vollständige Anleitung zum Bot Framework Emulator finden Sie hier.

Blockieren eines Bots im persönlichen Chat

Benutzer können festlegen, dass Ihr Bot keine persönlichen Chatnachrichten mehr sendet. Sie können dies umschalten, indem sie mit der rechten Maustaste auf Ihren Bot im Chatkanal klicken und Bot-Konversation blockieren auswählen. Dies bedeutet, dass Ihre Bots weiterhin Nachrichten senden, der Benutzer diese Nachrichten jedoch nicht empfängt.

Entfernen eines Bots aus einem Team

Benutzer können den Bot löschen, indem sie das Mülleimersymbol in der Bot-Liste in ihrer Teams-Ansicht auswählen. Beachten Sie, dass dadurch der Bot nur von der Nutzung durch dieses Team entfernt wird, einzelne Benutzer können im persönlichen Kontext interagieren.

Bots im persönlichen Kontext können von einem Benutzer nicht deaktiviert oder entfernt werden, es sei denn, der Bot wird vollständig aus Teams entfernt.

Deaktivieren eines Bots in Teams

Um zu verhindern, dass Ihr Bot Nachrichten empfängt, wechseln Sie zu Ihrem Bot-Dashboard, und bearbeiten Sie den Microsoft Teams-Kanal. Deaktivieren Sie die Option "In Microsoft Teams aktivieren ". Das Deaktivieren eines Bots in Teams 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 Teams

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

Entfernen Ihres Bots aus AppSource

Wenn Sie Ihren Bot aus Ihrer Teams-App in AppSource (früher Office Store) entfernen möchten, müssen Sie den Bot aus Ihrem App-Manifest entfernen und Ihre App erneut zur Überprüfung übermitteln. Weitere Informationen finden Sie unter Veröffentlichen Ihrer Microsoft Teams-App in AppSource.