Проверка и отладка бота локально с помощью IDE

  • Статья

При тестировании бота необходимо учитывать как контексты, в которые вы хотите запустить бот, так и любые функции, которые вы добавляете в бот, для которой требуются данные, относящиеся к Microsoft Teams. Убедитесь, что выбранный вами метод тестирования бота соответствует его функциональным возможностям.

Тестирование путем отправки в Teams

Самый полный способ тестирования бота — создание пакета приложения и отправка его в Teams. Отправка пакета приложения в Teams — это единственный способ проверки всех функциональных возможностей бота во всех областях.

Существует два способа отправки приложения:

Примечание.

Чтобы изменить манифест и повторно отправить приложение, удалите бот перед отправкой измененного пакета приложения. Чтобы протестировать бота, включите отправку пользовательского приложения в Teams. См . раздел Включение отправки пользовательских приложений.

Не рекомендуется отправлять несколько приложений с разным содержимым под одинаковым идентификатором бота. Это может привести к непредсказуемому поведению бота. Удалите или удалите все предыдущие версии приложений, гарантируя отправку только последней версии. Если приложения используют один и тот же идентификатор бота, назначьте необходимые разрешения в пакете приложения. Кроме того, активируйте оба приложения в политике разрешений приложений и управляемых приложениях, чтобы они не блокировались. В этом случае могут возникнуть проблемы во время использования приложения.

Локальная отладка бота

Если вы размещаете свой бот локально во время разработки, вам нужно использовать службу туннелирования, например ngrok, чтобы протестировать своего бота. После скачивания и установки ngrok добавьте ngrok к пути и выполните следующую команду, чтобы запустить службу туннелирования:

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

Используйте конечную точку https, предоставленную ngrok, в манифесте приложения.

Примечание.

  • Если закрыть командное окно и перезапустить его, будет создан новый URL-адрес, и для дальнейшего использования бота вам потребуется обновить адрес его конечной точки.
  • Боты, созданные с помощью Microsoft Bot Framework, должны быть доступны через конечную точку https, однако конечная точка не предоставляется. Конечная точка связана только между Bot Framework и внутренним адресом.

Тестирование бота без отправки в Teams

Иногда необходимо протестировать бот, не устанавливая его как приложение в Teams. Мы предоставляем два метода для тестирования бота. Тестирование бота без его установки в качестве приложения может быть полезно, чтобы убедиться, что бот доступен и отвечает. Однако это не позволяет протестировать все возможности Microsoft Teams, добавленные в бот. Если вы хотите полностью протестировать свой бот, см. Тестирование загрузкой файлов .

Использование эмулятора бота

Bot Framework Emulator - классическое приложение, которое позволяет разработчикам тестировать и отлаживать боты локально или удаленно. Эмулятор помогает общаться с ботом в чате и проверять сообщения, отправляемые и получаемые ботом. Это полезно, чтобы убедиться, что бот доступен и отвечает на запросы. Однако эмулятор не позволяет протестировать какие-либо функции, связанные с Teams, которые вы добавляете в бот. Ответы бота не являются точным визуальным представлением о том, как они отображаются в Teams. Если вам нужно протестировать любой из них, лучше всего загрузить свой бот.

Дополнительные сведения см. в полных инструкциях по Эмулятору Bot Framework.

Общение с ботом напрямую по идентификатору

Важно!

  • Беседа с ботом по идентификатору предназначена только для тестирования на самом базовом уровне. Все функции, связанные с Teams, которые вы добавляете в бот, не работают.
  • С 31 января 2024 г. пользователи не могут общаться с ботами, которые не подключены к приложению Microsoft Teams, например ботам Azure, созданным с помощью Bot Framework или Power Virtual Agents. Мы рекомендуем создать новое приложение Teams, подключенное к Боту Azure, с помощью портала разработчика, опубликовать его в Teams и разрешить пользователям устанавливать приложение с помощью политик разрешений приложения. Если вы хотите протестировать приложение, вы можете назначить пользователям политику настройки приложения , которая позволяет отправлять пользовательские приложения и общаться с ботом Azure через прямую ссылку на чат.

Инициируйте беседу с ботом, используя его идентификатор. При добавлении бота с помощью одного из этих методов он не может быть доступен в беседах канала, и вы не можете воспользоваться другими возможностями приложения Teams, такими как вкладки или расширения сообщений. Инициируйте беседу одним из следующих способов:

  • На странице панели мониторинга бота в разделе Каналы нажмите кнопку Добавить в Microsoft Teams. Teams запускает личный чат с ботом.

  • Прямая ссылка на идентификатор приложения бота в Teams:

    1. Перейдите враздел Сведенияо панели мониторинга> бота и скопируйте идентификатор приложения Майкрософт для бота.

      Снимок экрана: идентификатор приложения Майкрософт на странице сведений.

    2. Откройте Microsoft Teams, в области Чат щелкните значок Новый чат . В поле Для: введите идентификатор приложения Майкрософт бота.

      Снимок экрана: значок

      Идентификатор приложения должен разрешаться в имя бота.

    3. Выберите бота и отправьте сообщение, чтобы инициировать беседу. Кроме того, можно вставить идентификатор приложения бота в поле поиска в левом верхнем углу Teams. На странице результатов поиска перейдите на вкладку Люди, чтобы увидеть свой бот и начать с ним общение.

Примечание.

Чтобы Teams ссылались на идентификатор приложения бота, включите отправку пользовательского приложения.

Бот получает событие conversationUpdate при добавлении ботов в команду без сведений о команде в объекте channelData.

Блокировка бота в личном чате

Пользователи могут запретить боту отправлять сообщения в личных чатах. Они могут переключить это значение, щелкнув бота правой кнопкой мыши в канале чата и выбрав Блокировать беседу бота. Это означает, что ваши боты продолжают отправлять сообщения, однако пользователь не получает их.

Снимок экрана: параметр беседы бота блокировки в личном чате.

Удаление бота из группы

Пользователи могут удалить бота, щелкнув значок корзины в списке ботов в представлении команды. Это только удаляет бота из использования этой командой. Отдельные пользователи по-прежнему могут взаимодействовать в личном контексте. Пользователи не могут удалять или отключать боты в личном контексте.

Отключение бота в Teams

Чтобы запретить боту получать сообщения, перейдите на панель мониторинга бота и измените канал Teams. Снимите флажок Включить в Microsoft Teams. Это не позволяет пользователям взаимодействовать с ботом, однако его по-прежнему можно обнаружить, и пользователи могут добавить его в Teams.

Удаление бота из Teams

Чтобы полностью удалить свой бот из Teams, перейдите на панель мониторинга ботов и измените канал Teams. В нижней части страницы нажмите кнопку Удалить. Удаление бота из Teams не позволяет пользователям обнаруживать бота, добавлять его и взаимодействовать с ним. Удаление бота из Teams не приводит к удалению бота из экземпляров Teams другого пользователя, однако он также перестает работать для них.

См. также