Отладка бота sdk-first

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

В этой статье описывается отладка бота с помощью интегрированной среды разработки, например Visual Studio или Visual Studio Code, и эмулятора Bot Framework. Используйте эти методы для локальной отладки бота. В этой статье используется эхо-бот, например созданный в кратком руководстве по созданию бота .

Примечание.

В этой статье предполагается, что вы используете Bot Framework Emulator для отправки сообщений в бот и получения их от бота во время отладки. Если вы ищете другие способы отладки бота с помощью эмулятора Bot Framework, ознакомьтесь со статьей "Отладка" с помощью эмулятора Bot Framework.

Примечание.

Пакеты SDK для JavaScript, C# и Python для Bot Framework по-прежнему будут поддерживаться, однако пакет SDK java отменяется с окончательной долгосрочной поддержкой, заканчивающейся в ноябре 2023 года.

Существующие боты, созданные с помощью пакета SDK для Java, будут продолжать функционировать.

Для создания нового бота рекомендуется использовать Power Virtual Agent и ознакомиться с выбором подходящего решения чат-бота.

Дополнительные сведения см. в статье "Будущее создания бота".

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

Установка точек останова C# в Visual Studio Code

В Visual Studio Code можно установить точки останова и запустить бот в режиме отладки для пошагового выполнения кода. Чтобы задать точки останова в Visual Studio Code, сделайте следующее:

  1. Запустите Visual Studio Code и откройте папку проекта бота.

  2. При необходимости задайте точки останова. Чтобы задать точку останова, наведите указатель мыши на столбец слева от номеров строк. Появится красная точка. Если вы выберете ее, вы зададите точки останова. Если выбрать ее снова, точки останова будут удалены.

    Снимок экрана: точка останова C#, установленная в Visual Studio Code.

  3. В строке меню выберите "Выполнить", а затем "Начать отладку". Бот запустится в режиме отладки из терминала в Visual Studio Code.

  4. Запустите эмулятор Bot Framework и подключитесь к боту, как описано в описании отладки с помощью эмулятора Bot Framework.

  5. В эмуляторе отправьте боту сообщение (например, отправьте сообщение "Привет"). Выполнение останавливается на строке, в которой установлена точка останова.

    Снимок экрана бота C# в Visual Studio Code, приостановленный в точке останова.

Установка точек останова C# в Visual Studio

В Visual Studio можно задать точки останова и запустить бота в режиме отладки для пошагового выполнения кода. Чтобы задать точки останова в Visual Studio, сделайте следующее:

  1. Перейдите к папке ботов и откройте файл SLN. При этом откроется решение в Visual Studio.

  2. В строке меню выберите "Сборка" и выберите "Создать решение".

  3. В обозревателе решений выберите файл CS и задайте требуемые точки останова. Этот файл определяет логику основного бота. Чтобы задать точку останова, наведите указатель мыши на столбец слева от номеров строк. Появится небольшая точка. Если вы выберете ее, вы зададите точки останова. Если выбрать ее снова, точки останова будут удалены.

    Снимок экрана: точка останова C# в Visual Studio.

  4. В меню выберите "Отладка", а затем "Начать отладку". На этом этапе бот функционирует локально.

  5. Запустите Bot Framework Emulator и подключитесь к боту, как описано выше.

  6. Из эмулятора отправьте боту сообщение, например "Привет". Выполнение останавливается на строке, в которой установлена точка останова.

    Снимок экрана бота C# в Visual Studio, приостановленный в точке останова.

Дополнительные ресурсы

Следующие шаги