Testen und Debuggen des bot lokalTest and debug your bot locally

Wenn Sie Ihren bot testen, müssen Sie sowohl den Kontext (die), den Sie für Ihren bot ausführen möchten, als auch alle Funktionen berücksichtigen, die Sie Ihrem bot möglicherweise hinzugefügt haben und für Microsoft Teams spezifische Daten benötigen.When testing your bot you need to take into consideration both the context(s) you want your bot to run in, as well as any functionality you may have added to your bot that requires data specific to Microsoft Teams. Stellen Sie sicher, dass die Methode, die Sie zum Testen Ihres bot ausgewählt haben, mit der Funktionalität übereinstimmt.Make sure that the method you chose to test your bot aligns with its functionality.

Testen durch Hochladen in Microsoft TeamsTest by uploading to Teams

Die umfassendste Möglichkeit zum Testen Ihres bot besteht darin, ein App-Paket zu erstellen und es in Microsoft Teams hochzuladen.The most comprehensive way to test your bot is by creating an app package and uploading it to Teams. Dies ist die einzige Methode zum Testen der vollständigen Funktionalität, die für Ihren bot zur Verfügung steht, über alle Bereiche hinweg.This is the only method to test the full functionality available to your bot, across all scopes.

Es gibt zwei Methoden zum Hochladen Ihrer APP.There are two methods for uploading your app. Sie können entweder App Studio verwenden, um Ihnen zu helfen, oder Sie können ein App-Paket manuell erstellen und Ihre APP hochladen.You can either use App Studio to help you, or you can manually create an app package and upload your app. Wenn Sie Ihr Manifest ändern und Ihre APP erneut hochladen müssen, sollten Sie ihren bot vor dem Hochladen Ihres geänderten App-Pakets löschen.If you need to alter your manifest and re-upload your app, you should delete your bot before uploading your altered app package.

Debuggen des bot lokalDebug your bot locally

Wenn Sie Ihren bot während der Entwicklung lokal hosten, müssen Sie einen Tunnel Dienst wie ngrok verwenden, um Ihren bot zu testen.If you are hosting your bot locally during development you'll need to use a tunneling service like ngrok in order to test your bot. Nachdem Sie ngrok heruntergeladen und installiert haben, führen Sie den folgenden Befehl aus, um den Tunnel Dienst zu starten (möglicherweise müssen Sie ngrok zu Ihrem Pfad hinzufügen).Once you've downloaded and installed ngrok, run the below command to start the tunneling service (you may need to add ngrok to your path).

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

Verwenden Sie den von ngrok bereitgestellten HTTPS-Endpunkt in Ihrem App-Manifest.Use the https endpoint provided by ngrok in your app manifest. Wenn Sie das Befehlsfenster schließen und neu starten, erhalten Sie eine neue URL, und Sie müssen ihre bot-Endpunktadresse so aktualisieren, dass diese ebenfalls verwendet wird.If you close your command window and restart you'll get a new URL, and you'll need to update your bot endpoint address to use that one as well.

Testen Ihres bot ohne hochladen in Microsoft TeamsTesting your bot without uploading to Teams

Gelegentlich kann es erforderlich sein, ihren bot zu testen, ohne ihn als app in Microsoft Teams zu installieren.Occasionally it may be necessary to test your bot without installing it as an app in Teams. Hierzu stehen zwei Methoden zur Verfügung.We provide two methods for doing so below. Das Testen Ihres bot ohne Installation als APP kann nützlich sein, um sicherzustellen, dass Ihr bot verfügbar ist und reagiert, aber Sie können nicht die gesamte Bandbreite der Microsoft Teams-Funktionen testen, die Sie Ihrem bot möglicherweise hinzugefügt haben.Testing your bot without installing it as an app can be useful to ensure your bot is available and responding, however it will not allow you to test the full breadth of Microsoft Teams functionality you may have added to your bot. Wenn Sie Ihren bot vollständig testen müssen, befolgen Sie die Anweisungen zum Testen durch Hochladen.If you need to fully test your bot, please follow the instructions for testing by uploading.

Verwenden des bot-EmulatorsUse the Bot Emulator

Der bot Framework-Emulator ist eine Desktopanwendung, die bot-Entwicklern das Testen und Debuggen Ihrer Bots entweder lokal oder Remote ermöglicht.The Bot Framework Emulator is a desktop application that allows bot developers to test and debug their bots, either locally or remotely. Mit dem Emulator können Sie mit Ihrem bot chatten und die von Ihrem bot gesendeten und empfangenen Nachrichten überprüfen.Using the emulator, you can chat with your bot and inspect the messages that your bot sends and receives. Dies kann nützlich sein, um zu überprüfen, ob Ihr bot verfügbar ist und reagiert, aber der Emulator erlaubt Ihnen nicht, alle Teams-spezifischen Funktionen zu testen, die Sie Ihrem bot hinzugefügt haben, und auch Antworten von Ihrem bot werden keine präzise visuelle Darstellung dessen sein, was Sie tun werden. in Microsoft Teams gerendert werden.This can be useful for verifying that your bot is available and responding, however the emulator will not allow you to test any Teams-specific functionality you've added to your bot, nor will responses from your bot be an accurate visual representation of how they will be rendered in Teams. Wenn Sie eines dieser beiden Dinge testen müssen, ist es am besten, ihren bot hochzuladen.If you need to test either of those things it is best to upload your bot.

Ausführliche Anweisungen zum bot Framework-Emulator finden Sie hier.Complete instructions on the Bot Framework Emulator can be found here.

Sprechen Sie mit Ihrem bot direkt über IDTalk to your bot directly by Id

Wichtig

Das Gespräch mit Ihrem bot durch ID ist nur für grundlegende Testzwecke gedacht.Talking to your bot by Id is intended for basic testing purposes only. Alle Teams-spezifischen Funktionen, die Sie Ihrem bot hinzugefügt haben, können nicht verwendet werden.Any Teams-specific functionality you've added to your bot will not work.

Sie können auch eine Unterhaltung mit Ihrem bot initiieren, indem Sie dessen ID verwenden. Im folgenden sind zwei Methoden aufgeführt.You can also initiate a conversation with your bot by using its Id. Two methods for doing so are given below. Wenn ein bot durch eine dieser Methoden hinzugefügt wurde, kann er nicht in Kanal Unterhaltungen verwendet werden, und Sie können nicht von anderen Microsoft Teams-App-Funktionen wie Registerkarten oder Messaging Erweiterungen profitieren.When a bot has been added through one of these methods it will not be addressable in channel conversations, and you cannot take advantage of other Microsoft Teams app capabilities like tabs or messaging extensions.

  1. Wählen Sie auf der Seite bot-Dashboard für Ihren bot unter Kanäledie Option zu Microsoft Teams hinzufügenaus.On the Bot Dashboard page for your bot, under Channels, select Add to Microsoft Teams. Microsoft Teams wird mit einem persönlichen Chat mit Ihrem bot gestartet.Microsoft Teams will launch with a personal chat with your bot.
  2. Verweisen Sie direkt in Microsoft Teams auf die APP-ID Ihres bot:Directly reference your bot's app ID from within Microsoft Teams:
    • Kopieren Sie auf der Seite bot-Dashboard für Ihren bot unter Detailsdie Microsoft-App-ID für Ihren bot.On the Bot Dashboard page for your bot, under Details, copy the Microsoft App ID for your bot.

      Aufrufen der-Anwendungskennung für den bot

    • Wählen Sie in Microsoft Teams im Chat Bereich das Symbol Chat hinzufügen aus.From within Microsoft Teams, on the Chat pane, select the Add chat icon. Um:, fügen Sie die Microsoft-App-ID Ihres bot ein.For To:, paste your bot's Microsoft App ID.

      Aufrufen der-Anwendungskennung für den bot

      Die APP-ID sollte in ihren bot-Namen aufgelöst werden.The app ID should resolve to your bot name.

    • Wählen Sie Ihren bot aus, und senden Sie eine Nachricht, um eine Unterhaltung zu initiieren.Select your bot and send a message to initiate a conversation.

    • Alternativ können Sie die APP-ID Ihres bot in das Suchfeld oben links in Microsoft Teams einfügen.Alternatively, you can paste your bot's app ID in the search box in the top left in Microsoft Teams. Navigieren Sie auf der Suchergebnisseite zur Registerkarte Personen, um Ihren bot anzuzeigen und damit zu beginnen, damit zu chatten.In the search results page, navigate to the People tab to see your bot and to start chatting with it.

Ihr bot erhält das conversationUpdate Ereignis genauso wie Bots, die einem Team hinzugefügt wurden, jedoch ohne die Team channelData Informationen im Objekt.Your bot will receive the conversationUpdate event just like bots added to a team, but without the team information in the channelData object.

Blockieren eines bot im persönlichen ChatBlocking a bot in personal chat

Beachten Sie, dass Benutzer entscheiden können, ihren bot am Senden persönlicher Chatnachrichten zu hindern.Note that users can choose to block your bot from sending personal chat messages. Sie können dies umschalten, indem Sie mit der rechten Maustaste auf Ihren bot im Chat Kanal klicken und die Option bot-unter Haltung blockierenwählen.They may toggle this by right-clicking your bot in the chat channel and choosing Block bot conversation. Dies bedeutet, dass ihre Bots weiterhin Nachrichten senden, aber der Benutzer wird diese Nachrichten nicht erhalten.This means your bots will continue to send messages but the user will not receive those messages.

Blockieren eines bot

Entfernen eines bot aus einem TeamRemoving a bot from a team

Benutzer können den bot löschen, indem Sie das Papierkorbsymbol in der Liste "Bots" in der Ansicht "Teams" auswählen.Users can delete the bot by choosing the trash-can icon on the bots list in their teams view. Beachten Sie, dass dadurch nur der bot aus der Verwendung dieses Teams entfernt wird; einzelne Benutzer können weiterhin im persönlichen Kontext interagieren.Note that this only removes the bot from that team's use; individual users will still be able to interact in personal context.

Bots im persönlichen Kontext können nicht deaktiviert oder von einem Benutzer entfernt werden, ohne dass der bot von Microsoft Teams vollständig entfernt wird.Bots in personal context cannot be disabled or removed by a user, short of completely removing the bot from Teams.

Deaktivieren eines bot in Microsoft TeamsDisabling a bot in Teams

Um Ihren bot beim Empfang von Nachrichten zu beenden, wechseln Sie zu Ihrem bot-Dashboard, und bearbeiten Sie den Microsoft Teams-Kanal.To stop your bot receiving messages, go to your Bot Dashboard and edit the Microsoft Teams channel. Deaktivieren Sie die Option auf Microsoft Teams aktivieren .Clear the Enable on Microsoft Teams option. Dadurch wird verhindert, dass Benutzer mit dem bot interagieren, er kann jedoch weiterhin erkannt werden, und die Benutzer können ihn weiterhin zu Microsoft Teams hinzufügen.This prevents users from interacting with the bot, but it will still be discoverable and users will still be able to add it to teams.

Löschen eines bot aus Microsoft TeamsDeleting a bot from Teams

Wenn Sie Ihren bot vollständig aus Microsoft Teams entfernen möchten, wechseln Sie zu Ihrem bot-Dashboard, und bearbeiten Sie den Microsoft Teams-Kanal.To remove your bot completely from Teams, go to your Bot Dashboard and edit the Microsoft Teams channel. Klicken Sie unten auf die Schaltfläche Löschen .Choose the Delete button at the bottom. Dadurch wird verhindert, dass Benutzer ihren bot entdecken, hinzufügen oder mit ihr interagieren.This prevents users from discovering, adding, or interacting with your bot. Beachten Sie, dass dadurch der bot nicht aus den Teams-Instanzen anderer Benutzer entfernt wird, obwohl er auch für Sie nicht mehr funktioniert.Note that this does not remove the bot from other users' Teams instances, although it will cease functioning for them as well.