Устранение неполадок, связанных с конфигурацией бота
ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4
При выполнении бота могут возникать ошибки разных типов, например он может не отвечать на запросы, создавать исключения или работать не во всех подключенных каналах. При устранении неполадок с ботом прежде всего проверьте его работу в веб-чате. Это позволит понять, с чем связана проблема: с самим ботом (если он не работает ни в одном канале) или только с определенным каналом (если бот успешно работает в некоторых каналах и не работает в других).
Тест в веб-чате
- Откройте ресурс бота в портал Azure.
- Откройте панель Test in Web Chat (Тестирование в веб-чате).
- Отправьте боту сообщение.
Если бот не отвечает ожидаемым выходным данным, перейдите к боту не работает в Веб-чат. В противном случае перейдите к разделу Бот работает в веб-чате, но не работает в других каналах.
Бот не работает в Веб-чат
Существует множество причин, по которым бот не работает. Скорее всего, приложение бота отключено и не может получать сообщения, или бот получает сообщения, но не отвечает. Причины могут быть следующими:
- Бот находится вниз и не может быть достигнут.
- бот аварийно завершает работу;
- неправильно указана конечная точка бота;
- Бот успешно получает сообщения, но не может отвечать.
Чтобы определить, работает ли бот, сделайте следующее.
- Откройте панель Обзор.
- Скопируйте значение Messaging endpoint (Конечная точка обмена сообщениями) и вставьте его в адресную строку браузера.
Если эта конечная точка возвращает ошибку HTTP 404 или 405, значит бот доступен и может отвечать на сообщения. Чтобы выяснить причину длительного ожидания, см. сведения о превышении времени ожидания и завершении работы с ошибкой HTTP 5xx.
Если конечная точка возвращает сообщение об ошибке "This site can't be reached" (Этот сайт недоступен) или "Не удается открыть эту страницу", значит бот не работает и его следует развернуть повторно.
Бот работает в веб-чате, но не работает в других каналах.
Если бот успешно работает веб-чате, но не может работать в каких-либо других каналах, проверьте следующие возможные причины.
Проблемы с конфигурацией канала
Вполне возможно, что параметры конфигурации канала (например, имя пользователя и пароль бота) заданы неправильно или изменились во внешней среде. Например, бот настроен на взаимодействие с определенной страницей Facebook, которая позднее была удалена. Самым простым решением является удаление канала и повторное изменение конфигурации канала.
Список поддерживаемых каналов и инструкций по настройке каждого из них см. в списке каналов в Подключение бота в каналы.
Особое поведение для канала
Возможно, в реализации разных каналов различаются некоторые функции. Например, сейчас не все каналы поддерживают адаптивные карточки. Большинство каналов поддерживают действия (кнопки), но они отображаются в конкретном канале. Заметив различия в поведении определенных типов сообщений в разных каналах, ознакомьтесь со сведениями в статье Разделенные на категории действия по каналам.
Ниже приведены ссылки, которые могут помочь с отдельными каналами:
- Add bots to Microsoft Teams apps (Добавление ботов в приложения Microsoft Teams)
- Facebook: введение в платформу Messenger
- Сведения о Skype для разработчиков
- Slack: включение взаимодействия с ботами
Сбой канала
В некоторых случаях может прерываться обслуживание отдельных каналов. Обычно такие простои не продолжаются долго. Но если вы считаете, что произошел сбой канала, проверьте сведения на веб-сайте этого канала или в социальных сетях.
Есть еще один способ быстро проверить наличие сбоев в канале: создайте тестовый бот (например, простейший повторитель сообщений) и добавьте в него проблемный канал. Если тестовый бот работает с некоторыми каналами, но не с другими, проблема не в рабочем боте.
Дополнительные сведения
См. инструкции по отладке бота и другие статьи об отладке в этом разделе.