Testen und debuggen Sie Ihren Bot lokal mit der IDE

  • Artikel

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, 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 das Querladen in Teams. Siehe Aktivieren des Querladens.

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.

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. Der Emulator ermöglicht es Ihnen jedoch nicht, Teams-spezifischen Funktionen zu testen, die Sie dem Bot hinzugefügt haben, und die Antworten von Ihrem Bot stellen keine genaue visuelle Darstellung 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 hinzugefügt haben, funktionieren nicht.

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. Kopieren Sie auf der seite Bot-Dashboard für Ihren Bot unter Details die Microsoft-App-ID für Ihren Bot.

      Abrufen der AppID für den Bot

    2. Öffnen Sie Microsoft Teams, und wählen Sie im Bereich Chat das Symbol Chat hinzufügen aus. Fügen Sie im Feld An: die Microsoft App-ID Ihres Bots ein.

      Hochladen von Bots

      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 das Querladen von Apps.

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 aktivieren, indem sie im Chatkanal mit der rechten Maustaste auf Ihren Bot klicken und Bot-Unterhaltungen blockieren auswählen. Dies bedeutet, dass Ihre Bots weiterhin Nachrichten senden, aber der Benutzer empfängt die Nachrichten nicht.

Blockieren eines Bots

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. Bots im persönlichen Kontext können von Benutzern nicht deaktiviert oder entfernt werden.

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