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

Создание агента или приложения с помощью Microsoft 365 Agents Toolkit (прежнее название — Teams Toolkit) часто означает выполнение одного и того же проекта в разных целевых объектах, таких как локальные, разработчики или на игровой площадке. Среды сохраняют каждый целевой объект отдельно, при этом вы повторно используете одну и ту же структуру проекта и команды жизненного цикла. В наборе средств агентов in .env.<environment-name> хранятся файлы параметров среды. Каждый файл фиксирует переменные и выходные данные для этого целевого объекта, что позволяет подготавливать, развертывать и публиковать без перенастройки ресурсов каждый раз.

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

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

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

Примечание.

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

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

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

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

Создание агента или приложения Microsoft Teams включает как облачные, так и локальные ресурсы. Облачные ресурсы включают регистрацию приложений и клиент Teams, в то время как агент или логика приложения могут выполняться локально для ускорения разработки и тестирования. Все шаблоны набора средств агентов включают предварительно настроенную local среду с файлами ./env/.env.local и ./env/.env.local.user . Эта настройка позволяет запускать агент или приложение на локальном веб-сервере и отлаживать их с помощью точек останова в Visual Studio Code (для JavaScript, TypeScript, агента Или приложения Python) или Visual Studio (для агента или приложения CSharp).

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

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

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

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

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

  1. Откройте рабочую область агента Teams или проекта приложения в Visual Studio Code.

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

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

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

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

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

Выбор среды для удаленной сборки

При работе с несколькими средами необходимо выбрать целевую среду для сборки, отладки и предварительного просмотра агента или приложения в Microsoft Teams. Целевую среду можно выбрать непосредственно в параметрах сборки.

Выбор среды

Для разработки или любой другой настраиваемой среды:

  1. В разделе Жизненный цикл набора средств агентов выберите Подготовка для агента или приложения.

    Снимок экрана: раздел

  2. При появлении запроса выберите одну из доступных сред (например, dev или настраиваемую среду).

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

Набор средств агентов подготавливает агент или приложение для выбранной среды. Теперь вы можете создавать агент или приложение в выбранной среде.

Сборка в выбранной среде

После выбора среды набор средств агентов подготавливает агент или приложение для этой среды. Теперь вы можете выполнять сборку, отладку и запуск агента или приложения в выбранной среде.

  1. Щелкните значок Запуск и отладка на боковой панели Visual Studio Code.

  2. Выберите параметр отладки и предварительного просмотра удаленного агента или приложения в Microsoft Teams.

    Снимок экрана: выбор среды для создания агента или приложения.

Набор средств агентов создает агент или приложение в среде, для которой вы подготовили. Агент или приложение доступны для просмотра и тестирования в Teams.

См. также

  • Last updated on