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

Среды в наборе средств агентов Microsoft 365

Microsoft 365 Agents Toolkit (ранее известный как Набор средств Teams) предоставляет способ запуска и тестирования приложения в различных целевых объектах для развертывания, например для разработки, промежуточного хранения, рабочей среды или локально на вашем компьютере. Для этого набор средств агентов включает необязательный набор функций, которые оркеструют конфигурацию этих различных целевых объектов с помощью информации в файлах среды. Файлы среды представляют коллекцию всех ресурсов целевого объекта развертывания. Шаблоны проектов Набора средств агентов включают две группировки среды по умолчанию: одну для запуска приложения на компьютере с именем local, а другую для размещения в другом месте с именем dev. Вы можете переименовать среду dev и добавить другую среду с помощью окна Среды или вручную с новым .env.{environment-name} файлом. Вы не можете переименовать локальную среду.

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

Использование файлов среды с набором средств агентов

Набор средств агентов использует соглашение об именовании для файлов среды, таких как : .env.{environment-name}. Используя команды жизненного цикла набора средств (подготовка, развертывание или публикация), необходимо указать имя среды. Имя среды должно совпадать со значением, выбранным при {environment-name} создании файла среды.

Примечание.

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

Расположение файла среды

По умолчанию набор средств агентов не загружает переменные env и просто продолжает выполнять действия и записывать выходные данные в ./env/.env.dev. Если environmentFolderPath параметр не определен, агенты Toolkit не загружает переменные среды из .env файла и выполняет действия, предполагая, что env является разработчиком. Выходные данные записываются в ./env/.env.dev.

Локальные среды

Для создания приложения Microsoft Teams определенные ресурсы, такие как регистрация приложений и клиент Teams, размещаются в облаке. Однако другие ресурсы, такие как логика приложения, могут размещаться локально, чтобы упростить тестирование изменений во время разработки приложения. Все шаблоны проектов и примеры набора средств агентов настраиваются в local среде. Локальная среда содержит ./env/.env.local файлы и ./env/.env.local.user помогает запускать приложение на локальном веб-сервере. При использовании Visual Studio Code (VS Code) и Visual Studio (VS) шаблоны проектов и примеры настраиваются для поддержки отладки с точками останова.

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

Создание среды вручную в Visual Studio Code

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

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

Чтобы создать новую среду, выполните следующие действия:

  1. Откройте проект приложения Teams в Visual Studio Code.

  2. Щелкните значок Microsoft 365 Agents Toolkit на панели действий Visual Studio Code.

  3. + Щелкните значок в разделе СРЕДА.

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

  4. Введите имя среды и нажмите клавишу ВВОД.

    Снимок экрана: где ввести имя среды.

Нацеливание на среду

Если у вас есть несколько сред и выбрать пункты меню Рабочая среда, разработка или локальное меню, набор средств агентов предложит выбрать целевую среду.

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

См. также