Testen und Debuggen Ihres Microsoft Teams-Bots

Wichtig

Dieser Artikel basiert auf dem v3 Bot Framework SDK. Wenn Sie nach der aktuellen Dokumentationsversion 4.6 oder höher des SDK suchen, lesen Sie den Abschnitt "Unterhaltungsbots".

Beim Testen Ihres Bots müssen Sie sowohl die Kontext(en) berücksichtigen, in denen Ihr Bot ausgeführt werden soll, als auch alle Funktionen, die Sie möglicherweise zu Ihrem Bot hinzugefügt haben, die für Microsoft Teams spezifische Daten erfordern. Stellen Sie sicher, dass die Methode, die Sie zum Testen Des Bots ausgewählt haben, mit der Funktionalität übereinstimmt.

Testen durch Hochladen in Teams

Die umfassendste Möglichkeit, Ihren Bot zu testen, besteht darin, ein App-Paket zu erstellen und in Teams hochzuladen. Dies ist die einzige Methode zum Testen der vollständigen Funktionalität, die Ihrem Bot in allen Bereichen zur Verfügung steht.

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

Lokal Debuggen des 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ühren Sie den folgenden Befehl aus, um den Tunneldienst zu starten. Möglicherweise müssen Sie Ihrem Pfad ngrok hinzufügen.

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

Verwenden Sie den https-Endpunkt, der von ngrok in Ihrem App-Manifest bereitgestellt wird. Wenn Sie Das Befehlsfenster schließen und neu starten, erhalten Sie eine neue URL und müssen Ihre Bot-Endpunktadresse so aktualisieren, dass diese auch verwendet wird.

Testen Ihres Bots ohne Hochladen in Teams

Gelegentlich ist es erforderlich, Ihren Bot zu testen, ohne ihn als App in Teams zu installieren. Wir bieten zwei Methoden zum Testen an. Das Testen Ihres Bots, ohne ihn als App zu installieren, kann hilfreich sein, um sicherzustellen, dass Ihr Bot verfügbar ist und reagiert. Sie können jedoch nicht die gesamte Breite der Microsoft Teams Funktionen testen, die Sie Ihrem Bot möglicherweise hinzugefügt haben. Wenn Sie Ihren Bot vollständig testen müssen, befolgen Sie die Anweisungen zum Testen, indem Sie sie hochladen.

Verwenden des Bot-Emulator

Die Bot Framework Emulator ist eine Desktopanwendung, mit der Botentwickler 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 es Ihnen jedoch nicht, Teams-spezifische Funktionen zu testen, die Sie Ihrem Bot hinzugefügt haben, und antworten von Ihrem Bot keine genaue visuelle Darstellung ihrer Darstellung in Teams. Wenn Sie eine dieser Dinge testen müssen, ist es nicht am besten, Ihren Bot hochzuladen.

Vollständige Anweisungen zu den Bot Framework Emulator finden Sie hier.

Sprechen Sie mit Ihrem Bot direkt nach ID

Wichtig

Das Gespräch mit Ihrem Bot anhand der ID ist nur zu Testzwecken vorgesehen.

Sie können auch eine Unterhaltung mit Ihrem Bot mithilfe seiner ID initiieren. Im Folgenden finden Sie zwei Methoden dafür. Wenn ein Bot über eine dieser Methoden hinzugefügt wurde, ist er in Kanalunterhaltungen nicht adressierbar, und Sie können keine anderen Microsoft Teams App-Funktionen wie Registerkarten oder Messaging-Erweiterungen nutzen.

  1. Wählen Sie auf der Seite "Bot-Dashboard" für Ihren Bot unter "Kanäle" die Option "Zu Microsoft Teams hinzufügen" aus. Microsoft Teams wird mit einem persönlichen Chat mit Ihrem Bot gestartet.
  2. Verweisen Sie direkt in Microsoft Teams auf die App-ID Ihres Bots:
    • 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

    • Wählen Sie in Microsoft Teams im Chatbereich das Symbol "Chat hinzufügen" aus. Fügen Sie für "An:" die Microsoft App-ID Ihres Bots ein.

      Hochladen der AppID für den Bot

      Die App-ID sollte in Ihren Botnamen aufgelöst werden.

    • Wählen Sie Ihren Bot aus, und senden Sie eine Nachricht, um eine Unterhaltung zu initiieren.

    • Alternativ können Sie die App-ID Ihres Bots in das Suchfeld oben links in Microsoft Teams einfügen. Navigieren Sie auf der Suchergebnisseite zur Registerkarte "Kontakte", um Ihren Bot anzuzeigen und mit ihm zu chatten.

Ihr Bot empfängt das conversationUpdate Ereignis genau wie Bots, die einem Team hinzugefügt wurden, jedoch ohne die Teaminformationen im channelData Objekt.

Blockieren eines Bots im persönlichen Chat

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

Blockieren eines Bots

Entfernen eines Bots aus einem Team

Benutzer können den Bot löschen, indem sie das Papierkorbsymbol in der Bots-Liste in der Teams-Ansicht auswählen. Beachten Sie, dass der Bot nur aus der Verwendung dieses Teams entfernt wird, einzelne Benutzer können im persönlichen Kontext interagieren.

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

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 "Bei Microsoft Teams aktivieren". Dadurch wird verhindert, dass Benutzer mit dem Bot interagieren, aber er ist weiterhin auffindbar, und Benutzer können ihn zu 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". Dadurch wird verhindert, dass Benutzer Ihren Bot entdecken, hinzufügen oder mit diesem interagieren. Beachten Sie, dass dadurch der Bot nicht aus den Teams Instanzen anderer Benutzer entfernt wird, auch wenn er für ihn nicht mehr funktioniert.

Entfernen Ihres Bots aus AppSource

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