Behandeln von Problemen mit der BotkonfigurationTroubleshoot bot configuration issues

gilt für: SDK v4APPLIES TO: SDK v4

Ein Bot kann verschiedene Fehlertypen generieren. So kann es beispielsweise vorkommen, dass er nicht reagiert, Fehler auslöst oder in einem Kanal funktioniert, in einem anderen jedoch nicht.A bot can generate different types of errors, such as not being able to respond, throwing errors, or working in one channel but not in another. Der erste Schritt bei der Problembehandlung eines Bots besteht darin, ihn im Webchat zu testen.The first step in troubleshooting a bot is to test it in Web Chat. Dadurch können Sie ermitteln, ob das Problem botspezifisch (Bot funktioniert in keinem Kanal) oder kanalspezifisch (Bot funktioniert nur in einigen Kanälen, in anderen aber nicht) ist.This will allow you to determine if the problem is specific to your bot (bot doesn't work in any channel) or to a particular channel (bot works in some channels but not others).

Testen im WebchatTest in Web Chat

  1. Öffnen Sie Ihre Botressource im Azure-Portal.Open your bot resource in the Azure Portal.
  2. Öffnen Sie den Bereich Testen im Webchat.Open the Test in Web Chat pane.
  3. Senden Sie Ihrem Bot eine Nachricht.Send your bot a message.

Testen im Webchat

Wenn der Bot nicht mit der erwarteten Ausgabe antwortet, fahren Sie mit Bot funktioniert im Webchat nicht fort.If the bot does not respond with the expected output, go to Bot does not work in Web Chat. Fahren Sie andernfalls mit Bot funktioniert im Webchat, aber nicht in anderen Kanälen fort.Otherwise, go to Bot works in Web Chat but not in other channels.

Bot funktioniert im Webchat nichtBot does not work in Web Chat

Ein nicht funktionierender Bot kann verschiedene Ursachen haben.There could be a number of reasons why a bot doesn't work. In den meisten Fällen ist die Botanwendung ausgefallen und kann keine Nachrichten empfangen, oder der Bot empfängt die Nachrichten, kann aber nicht antworten.Most likely, the bot application is down and cannot receive messages, or the bot receives the messages but fails to respond. Nachfolgend sind einige mögliche Ursachen aufgeführt:Here are some of the possible causes:

  • Der Bot ist ausgefallen und kann nicht erreicht werden.The bot is down and cannot be reached.
  • Der Bot stürzt ab.The bot is crashing.
  • Der Endpunkt des Bots ist falsch.The bot's endpoint is incorrect.
  • Der Bot empfängt Ihre Nachrichten, kann aber nicht antworten.The bot is successfully receiving your messages but cannot respond.

So ermitteln Sie, ob der Bot ausgeführt wird:To see if the bot is running:

  1. Öffnen Sie den Bereich Übersicht.Open the Overview pane.
  2. Kopieren Sie den Messaging-Endpunkt, und fügen Sie ihn in Ihren Browser ein.Copy the Messaging endpoint and paste it into your browser.

Wenn der Endpunkt den HTTP-Fehler 404 oder 405 zurückgibt, ist der Bot erreichbar und kann auf Nachrichten antworten.If the endpoint returns HTTP Error 404 or 405, that means the bot is reachable and the bot is able to respond to messages. Informationen zum Untersuchen von Timeoutfehlern finden Sie in den Artikeln zu Timeouts oder zu HTTP 5xx-Fehlern.To investigate timeout issues, see times out or fails with an HTTP 5xx error articles.

Wenn der Endpunkt einen Fehler mit dem Hinweis zurückgibt, dass die Website oder Seite nicht erreichbar ist, ist Ihr Bot ausgefallen und muss erneut bereitgestellt werden.If the endpoint returns an error "This site can't be reached" or "can't reach this page", that means that your bot is down and you need to redeploy it.

Bot funktioniert im Webchat, aber nicht in anderen KanälenBot works in Web Chat but not in other channels

Wenn der Bot im Webchat erwartungsgemäß funktioniert, in einem anderen Kanal aber nicht, kann dies folgende Ursachen haben:If the bot works as expected in Web Chat but fails in some other channel, possible reasons are:

Probleme mit der KanalkonfigurationChannel configuration issues

Unter Umständen wurden die Parameter der Kanalkonfiguration (etwa Benutzername und Kennwort des Bots) nicht korrekt festgelegt oder von außen geändert.It's possible that channel configuration parameters, such as the bot's username and password have been set incorrectly or have changed externally. Beispiel: Bei einem Bot wurde für eine bestimmte Seite der Facebook-Kanal konfiguriert, und die Seite wurde später gelöscht.For example, a bot was configured with the Facebook channel for a particular page and the page was later deleted. Die einfachste Lösung besteht darin, den Kanal zu entfernen und die Kanalkonfiguration erneut auszuführen.The simplest solution is remove the channel and redo the channel configuration anew.

Konfigurationsanleitungen für Kanäle, die von Bot Framework unterstützt werden, finden Sie unter folgenden Links:The links below provide instructions for configuring channels supported by the Bot Framework:

Kanalspezifisches VerhaltenChannel-specific behavior

Die Implementierung einiger Features kann sich von Kanal zu Kanal unterscheiden.Implementation of some features can differ by channel. So unterstützen beispielsweise nicht alle Kanäle adaptive Karten.For example, not all channels support Adaptive Cards. Die meisten Kanäle unterstützen Aktionen (Schaltflächen), diese werden aber kanalspezifisch gerendert.Most channels support Actions (buttons), but they are rendered in a channel-specific way. Wenn Sie Unterschiede in der Funktionsweise einiger Nachrichtentypen in verschiedenen Kanälen feststellen, lesen Sie den Artikel Referenz zu Kanälen.If you see differences in how some message types work in different channels, consult the channels reference article.

Im Anschluss finden Sie einige zusätzliche Links, die bei einzelnen Kanälen hilfreich sein können:Below are some additional links that can help with individual channels:

KanalausfallChannel outage

Bei einigen Kanälen kann es bisweilen zu Dienstunterbrechungen kommen.Occasionally, some channels might have an interruption of service. Solche Ausfälle dauern in der Regel nicht lang.Usually, such outages don't last long. Sollten Sie jedoch einen Ausfall vermuten, konsultieren Sie die Website oder die sozialen Medien des Kanals.However, if you suspect an outage, consult the channel's web site or social media.

Sie können auch einen Testbot (etwa einen einfachen Echobot) erstellen und einen Kanal hinzufügen, um zu ermitteln, ob ein Kanal ausgefallen ist.Another way to determine if a channel has an outage is to create a test bot (such as a simple Echo Bot) and add a channel. Wenn der Testbot mit einigen Kanälen funktioniert, mit anderen aber nicht, deutet dies darauf hin, dass das Problem nicht auf Ihren Produktionsbot zurückzuführen ist.If the test bot works with some channels but not others, that would indicate that the problem is not in your production bot.

Zusätzliche RessourcenAdditional resources

Sehen Sie sich die Anweisungen zum Debuggen eines Bots sowie die anderen Artikel zum Debuggen in diesem Abschnitt an.See how-to debug a bot and the other debugging articles in that section.