Примечание
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Процесс отладки включает .vscode/launch.json
файлы и .vscode/tasks.json
для настройки отладчиков в Microsoft Visual Studio Code. Visual Studio Code запускает отладчик Node и отладчик браузера, а Microsoft Edge или Google Chrome запускает новый экземпляр браузера.
Рабочий процесс отладки выглядит следующим образом:
launch.json
Файл настраивает отладчик в Visual Studio Code.Visual Studio Code запускает составной preLaunchTask, Запустите приложение Teams локально в
.vscode/tasks.json
файле.Затем Visual Studio Code запускает отладчики, указанные в конфигурациях составной команды, например Прикрепить к боту, Прикрепить к серверу, Прикрепить к интерфейсу и Запустить бот.
Отладчик браузера Microsoft Edge или Google Chrome запускает новый экземпляр браузера и открывает веб-страницу для загрузки клиента Microsoft Teams.
Проверка предварительных требований
Корпорация Майкрософт проверяет следующие предварительные требования в процессе отладки:
Microsoft 365 Agents Toolkit (ранее известный как Набор средств Teams) проверяет, установлен ли Node.js. Если Node.js не установлен, отладка завершается.
Набор средств агентов проверяет, соответствует ли версия Node.js версиям, определенным в
package.json
файле. Если версия не совпадает, набор средств агентов отображает предупреждающее сообщение в выходном канале.Набор средств агентов предложит войти в учетную запись Microsoft 365, если вы не вошли в систему с помощью действительных учетных данных.
Передача пользовательских приложений для клиента разработчика включена, чтобы предотвратить завершение локальной отладки.
Если Ngrok не установлен или версия не соответствует требованию, набор средств агентов устанавливает пакет
[email protected]
npm Ngrok в~/.fx/bin/ngrok
. Ngrok binary версии 2.3 применим к расширению бота и сообщений и управляется пакетом npm Ngrok в/.fx/bin/ngrok/node modules/ngrok/bin
.Примечание.
Шаблоны проектов набора средств агентов используют пакет npm [email protected], который содержит версию 2.3.40. Дополнительные сведения о том, как получить действительную лицензию, см. в разделе ngrok.
Если Функции Azure Core Tools версии 4 не установлен или версия не соответствует требованию, набор средств агентов устанавливает пакет
azure-functions-core-tools@3
npm Функции Azure Core Tools для Windows и macOS в~/.fx/bin/func
. Пакет npm для Функции Azure Core Tools в~/.fx/bin/func/node_modules/azure-functions-core-tools/bin
управляет двоичным файлом Функции Azure Core Tools. Для Linux локальная отладка прекращается.Если пакет SDK для .NET Core не установлен или версия не соответствует требованию, набор средств агентов устанавливает пакет SDK для .NET Core для Windows и macOS в
~/.fx/bin/dotnet
. Версия пакета SDK для .NET Core применима для Функции Azure. Для Linux локальная отладка прекращается.В следующей таблице перечислены версии .NET Core.
Платформа Программное обеспечение Windows, macOS (x64) и Linux 3.1 (рекомендуется), 5.0, 6.0 macOS (arm64) 6.0 Если сертификат разработки для localhost не установлен для вкладки в Windows или macOS, набор средств агентов предложит установить его.
Если расширения привязки Функции Azure не установлены, набор средств агентов устанавливает Функции Azure расширения привязки в
api/extensions.csproj
.Если пакеты npm не установлены, агенты Toolkit установит все пакеты npm, применимые к приложению tab, приложению бота, расширению сообщений и Функции Azure.
Набор средств агентов запускает Ngrok для создания http-туннеля для бота и расширения сообщений.
Если вкладка, бот, расширение сообщений и порты Функции Azure недоступны, локальная отладка завершается.
В следующей таблице перечислены порты, доступные для компонентов.
Компонент Порт Tab 53000 Бот или расширение для сообщений 3978 Инспектор узла для бота или расширения обмена сообщениями 9239 Функции Azure 7071 Инспектор узла для Функций Azure 9229
При нажатии кнопки Начать отладку (F5) выходной канал Набора средств агентов отображает ход выполнения и результат после проверки предварительных требований.
Дополнительные сведения см. в разделе Задача проверки предварительных требований.
Запуск локального туннеля
Для расширения бота и сообщений агенты Toolkit запускает локальную службу туннеля, чтобы сделать конечную точку обмена сообщениями бота общедоступной. Дополнительные сведения см. в разделе Запуск задачи локального туннеля.
Создание ресурсов отладки
Набор средств агентов выполняет жизненный цикл provision
, определенный в , m365agents.local.yml
чтобы создать ресурсы, связанные с приложением Teams, необходимые для отладки. Дополнительные сведения см. в разделе Подготовка задачи и доступных действий.
Сборка проекта
Набор средств агентов выполняет жизненный цикл deploy
, определенный в m365agents.local.yml
для сборки проекта. Дополнительные сведения см. в разделе Развертывание задачи и доступных действий.
Знакомство с исходным кодом приложения
Папки и файлы проекта можно просмотреть в разделе Обозреватель в Visual Studio Code после отладки. В следующей таблице перечислены файлы, связанные с отладкой.
Имя папки | Содержание | Тип конфигурации отладки |
---|---|---|
m365agents.local.yml |
Файл проекта набора средств агентов main для отладки. | Этот файл определяет жизненные циклы и действия, необходимые для отладки. |
env/.env.local |
Файл переменных среды для проекта Набора средств агентов. | Значения каждой переменной среды используются или создаются во время отладки. |
.localConfigs |
Файл переменных среды для кода приложения. | Значения каждой переменной среды создаются во время отладки. |
Дополнительные сведения о структуре папок проекта см. в разделе Проект Набора средств агентов.
См. также
Platform Docs