Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
ОБЛАСТЬ ПРИМЕНЕНИЯ: ПАКЕТ SDK версии 4
В этой статье описывается отладка бота с помощью интегрированной среды разработки, например Visual Studio или Visual Studio Code, и эмулятора Bot Framework. Используйте эти методы для локальной отладки бота. В этой статье используется эхо-бот, например созданный в кратком руководстве по созданию бота .
Примечание.
В этой статье мы используем Bot Framework Emulator для отправки и получения сообщений от бота во время отладки. Если вы ищете другие способы отладки бота с помощью эмулятора Bot Framework, ознакомьтесь со статьей "Отладка" с помощью эмулятора Bot Framework.
Примечание.
Чтобы создавать агенты с помощью выбранной службы ИИ, оркестрации и знаний, рекомендуется использовать пакет SDK для агентов Microsoft 365. Пакет SDK для агентов поддерживает C#, JavaScript или Python. Дополнительные сведения о пакете SDK для агентов см. в aka.ms/agents. Если вы ищете платформу агента на основе SaaS, рассмотрите microsoft Copilot Studio. Если у вас есть существующий бот, созданный с помощью пакета SDK Bot Framework, вы можете обновить бота до пакета SDK для агентов. Вы можете ознакомиться с основными изменениями и обновлениями в руководстве по миграции с Bot Framework SDK на SDK для агентов. Запросы на поддержку пакета SDK Bot Framework больше не будут обслуживаться с 31 декабря 2025 г.
Предварительные требования
- Скачайте и установите Bot Framework Emulator.
- Скачайте и установите Visual Studio Code или Visual Studio.
Установка точек останова C# в Visual Studio Code
В Visual Studio Code можно установить точки останова и запустить бот в режиме отладки для пошагового выполнения кода. Чтобы задать точки останова в Visual Studio Code, сделайте следующее:
Запустите Visual Studio Code и откройте папку проекта бота.
При необходимости задайте точки останова. Чтобы задать точку останова, наведите указатель мыши на столбец слева от номеров строк. Появится красная точка. Если вы выберете точку, будет установлена точка останова. Если выбрать точку снова, точка останова будет удалена.
В строке меню выберите "Выполнить", а затем "Начать отладку". Бот запустится в режиме отладки из терминала в Visual Studio Code.
Запустите эмулятор Bot Framework и подключитесь к боту, как описано в описании отладки с помощью эмулятора Bot Framework.
В эмуляторе отправьте боту сообщение (например, отправьте сообщение "Привет"). Выполнение останавливается на строке, в которой установлена точка останова.
Установка точек останова C# в Visual Studio
В Visual Studio можно задать точки останова и запустить бота в режиме отладки для пошагового выполнения кода. Чтобы задать точки останова в Visual Studio, сделайте следующее:
Перейдите к папке ботов и откройте файл SLN. При этом откроется решение в Visual Studio.
В строке меню выберите "Сборка" и выберите "Создать решение".
В обозревателе решений выберите файл CS и задайте требуемые точки останова. Этот файл определяет логику основного бота. Чтобы задать точку останова, наведите указатель мыши на столбец слева от номеров строк. Появится небольшая точка. Если вы выберете точку, будет установлена точка останова. Если выбрать точку снова, точка останова будет удалена.
В меню выберите "Отладка", а затем "Начать отладку". На этом этапе бот функционирует локально.
Запустите Bot Framework Emulator и подключитесь к боту, как описано выше.
Из эмулятора отправьте боту сообщение, например "Привет". Выполнение останавливается на строке, в которой установлена точка останова.
Дополнительные ресурсы
- Устраняйте проблемы с конфигурацией бота и просматривайте другие статьи по устранению неполадок в этом разделе.
- Отладка с помощью эмулятора.