Поделиться через

Отладка бота из любого канала с помощью туннеля

  • Статья

ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4

Хотя бот находится в разработке, вы можете использовать интегрированную среду разработки и эмулятор Bot Framework для локального чата с ботом и проверять сообщения, которые бот отправляет и получает. Если бот находится в рабочей среде, вы можете отлаживать бота из любого канала с помощью туннеля. Простое подключение бота к нескольким каналам — это ключевая функция, доступная в Bot Framework.

В этой статье описывается, как локально отлаживать бота с помощью туннеля и C# EchoBot в канале, подключенном к боту. В этой статье в качестве примера канала используется Microsoft Teams .

Необходимые компоненты

Настройка туннеля

Dev Tunnels — это кроссплатформенное приложение, которое может создать URL-адрес туннелирования или пересылки, чтобы интернет-запросы достигли локального компьютера. Используйте devtunnel для пересылки сообщений из внешних каналов в Интернете непосредственно на локальный компьютер, чтобы разрешить отладку, а не стандартную конечную точку обмена сообщениями, настроенную в портал Azure.

  1. Откройте терминал с доступом к devtunnel CLI.

  2. Выполните devtunnel с помощью следующей команды, чтобы создать новый туннель.

    devtunnel host -a -p 3978

    Примечание.

    Указанный порт — это порт, на котором работает бот. Вы можете использовать любой порт localhost, который вы хотите.

  3. При запуске devtunnel скопируйте и сохраните общедоступный URL-адрес пересылки для дальнейшего использования.

    URL-адрес пересылки devtunnel

Настройка на портале Azure

Во время выполнения devtunnel войдите в портал Azure и просмотрите параметры бота, чтобы выполнить некоторую настройку.

  1. Выберите ресурс бота, подключенный к локальному боту.

  2. Найдите параметры и конфигурацию. Скопируйте и вставьте URL-адрес перенаправления devtunnel в поле конечной точки обмена сообщениями. Убедитесь, что вы поддерживаете "/api/messages" в конце URL-адреса.

    Конечная точка обмена сообщениями

  3. Выберите Применить.

Тест

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

Локально можно задать точки останова в Visual Studio. Расширение текстового свойства из входящего объекта действия вы увидите, что сообщение, отправленное ботом из команд, перехватывается локально для отладки.

Задание точек останова

Отсюда можно выполнить отладку обычно и выполнить код пошаговые инструкции. Используйте это для отладки бота из любого канала.

Дополнительная информация: