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

Создание рабочих процессов хостированного агента в Visual Studio Code (предварительная версия)

Создавайте, тестируйте и развертывайте рабочие процессы Hosted Foundry Agent с помощью расширения Microsoft Foundry для Visual Studio Code. Размещенные рабочие процессы позволяют нескольким агентам работать в последовательности, каждый из которых имеет собственную модель, инструменты и инструкции.

Перед началом работы создайте агента в службе агентов Foundry с использованием расширения. Затем можно добавить размещенные рабочие процессы в этот агент.

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

Предпосылки

  • проект Foundry с развернутой моделью или ресурсом Azure OpenAI.
  • Расширение Microsoft Foundry для Visual Studio Code установлено.
  • Управляемое удостоверение проекта с назначенными ролями Azure ИИ User и AcrPull. Также назначьте роль acrPull управляемому удостоверению проекта Foundry, в котором планируется развернуть хост-агент.
  • Поддерживаемый регион для размещенных агентов.
  • Python 3.10 или более поздней версии.
  • .NET 9 SDK или более поздней версии.

Создание рабочего процесса для размещенного агента

Расширение Foundry для Visual Studio Code можно использовать для создания рабочих процессов управляемых агентов. Размещенный рабочий процесс агента — это последовательность агентов, которые работают вместе для выполнения задачи. Каждый агент в рабочем процессе может иметь собственную модель, средства и инструкции.

  1. Откройте палитру команд (CTRL+SHIFT+P).

  2. Выполните следующую команду: >Microsoft Foundry: Create a New Hosted Agent.

  3. Выберите язык программирования.

  4. Выберите папку, в которой нужно сохранить новый рабочий процесс.

  5. Введите имя проекта рабочего процесса.

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

Установка зависимостей

Установите необходимые зависимости для проекта размещенного агента. Зависимости зависят от языка программирования, выбранного при создании project.

  1. Создайте виртуальную среду.

     python -m venv .venv

  2. Включите виртуальную среду.

    # PowerShell
./.venv/Scripts/Activate.ps1

# Windows cmd
.venv\Scripts\activate.bat

# Unix/MacOS
source .venv/bin/activate

  3. Установите следующий пакет:

    pip install azure-ai-agentserver-agentframework

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

    dotnet restore

Локальное выполнение размещенного рабочего процесса

Пример проекта рабочего процесса создает .env файл с необходимыми переменными среды. Создайте или обновите env-файл с помощью учетных данных Foundry:

AZURE_AI_PROJECT_ENDPOINT=https://<your-resource-name>.services.ai.azure.com/api/projects/<your-project-name>

AZURE_AI_MODEL_DEPLOYMENT_NAME=<your-model-deployment-name>

Это важно

Никогда не закрепляйте файл .env в систему управления версиями. Добавьте его в .gitignore файл.

Аутентификация хостингового агента

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

  • Azure CLI (az login)
  • Вход в учетную запись Visual Studio Code
  • вход в учетную запись Visual Studio
  • Переменные среды для субъекта-службы (AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET)

Подтвердите проверку подлинности локально, выполнив команды Azure CLI az account show или az account get-access-token перед выполнением примера.

Размещенный агент можно запустить в интерактивном режиме или в режиме контейнера.

Запуск размещенного агента в интерактивном режиме

Нажмите клавишу F5 в VS Code, чтобы начать отладку. Кроме того, можно использовать меню отладки VS Code:

  1. Откройте представление "Запуск и отладка " (CTRL+SHIFT+D/ CMD+SHIFT+D)
  2. Выберите "Отладка локального HTTP-сервера рабочего процесса" в раскрывающемся списке
  3. Нажмите зеленую кнопку "Начать отладку " (или нажмите клавишу F5)

Это приведет к следующему:

  1. Запуск HTTP-сервера с включенной отладкой
  2. Откройте инспектор агента AI Toolkit для интерактивного тестирования
  3. Позволяет задавать точки останова и проверять выполнение рабочего процесса в режиме реального времени.

Запуск размещенного агента в режиме контейнера

Подсказка

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

Чтобы запустить размещенный агент в режиме контейнера:

  1. Откройте палитру команд кода Visual Studio и выполните команду Microsoft Foundry: Open Container Agent Playground Locally.
  2. Выполните main.py, чтобы инициализировать размещённый контейнеризованный агент.
  3. Отправьте запрос агенту через интерфейс игровой площадки. Например, введите запрос, например: "Создайте лозунг для нового электрического внедорожника, который доступен и весело ездить".
  4. Просмотрите ответ агента в интерфейсе детской площадки.

Пример рабочего процесса проект создает .env файл с необходимыми переменными среды. Создайте или обновите env-файл с помощью учетных данных Foundry:

  1. Настройте переменные среды на основе операционной системы:

    $env:AZURE_AI_PROJECT_ENDPOINT="https://<your-resource-name>.services.ai.azure.com/api/projects/<your-project-name>"
$env:AZURE_AI_MODEL_DEPLOYMENT_NAME="your-deployment-name"

Аутентификация хостингового агента

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

  • Azure CLI (az login)
  • вход в учетную запись в Visual Studio Code
  • вход в учетную запись Visual Studio
  • Переменные среды для субъекта-службы (AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET)

Подтвердите проверку подлинности локально, выполнив команды Azure CLI az account show или az account get-access-token перед выполнением примера.

Размещенный агент можно запустить в интерактивном режиме или в режиме контейнера.

Запуск размещенного агента в интерактивном режиме

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

dotnet restore
dotnet build
dotnet run

Запуск размещенного агента в режиме контейнера

Подсказка

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

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

  1. Откройте палитру команд кода Visual Studio и выполните команду Microsoft Foundry: Open Container Agent Playground Locally.
  2. Выполните следующую команду, чтобы инициализировать контейнеризованный размещенный агент. 
    dotnet restore
dotnet build
dotnet run
  3. Отправьте запрос агенту через интерфейс игровой площадки. Например, введите запрос, например: "Создайте лозунг для нового электрического внедорожника, который доступен и весело ездить".
  4. Просмотрите ответ агента в интерфейсе детской площадки.

Визуализация выполнения процесса облачного агента

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

Включите визуализацию в рабочих процессах, добавив следующий фрагмент кода:

from agent_framework.observability import setup_observability
setup_observability(vs_code_extension_port=4319) # Default port is 4319

Добавьте следующую ссылку на csproj-файл:

<ItemGroup>
    <PackageReference Include="OpenTelemetry" Version="1.12.0" />
    <PackageReference Include="OpenTelemetry.Exporter.Console" Version="1.12.0" />
    <PackageReference Include="OpenTelemetry.Exporter.OpenTelemetryProtocol" Version="1.12.0" />
    <PackageReference Include="System.Diagnostics.DiagnosticSource" Version="9.0.10" />
</ItemGroup>

Обновите программу, чтобы включить следующий фрагмент кода:

using System.Diagnostics;
using OpenTelemetry;
using OpenTelemetry.Logs;
using OpenTelemetry.Metrics;
using OpenTelemetry.Resources;
using OpenTelemetry.Trace;

var otlpEndpoint =
    Environment.GetEnvironmentVariable("OTLP_ENDPOINT") ?? "http://localhost:4319";

var resourceBuilder = OpenTelemetry
    .Resources.ResourceBuilder.CreateDefault()
    .AddService("WorkflowSample");

var s_tracerProvider = OpenTelemetry
    .Sdk.CreateTracerProviderBuilder()
    .SetResourceBuilder(resourceBuilder)
    .AddSource("Microsoft.Agents.AI.*") // All agent framework sources
    .SetSampler(new AlwaysOnSampler()) // Ensure all traces are sampled
    .AddOtlpExporter(options =>
    {
        options.Endpoint = new Uri(otlpEndpoint);
        options.Protocol = OpenTelemetry.Exporter.OtlpExportProtocol.Grpc;
    })
    .Build();

Мониторьте и визуализируйте рабочий процесс агента хостинга.

Чтобы отслеживать и визуализировать выполнение размещенного рабочего процесса агента в режиме реального времени:

  1. Откройте палитру команд (CTRL+SHIFT+P).

  2. Выполните следующую команду: >Microsoft Foundry: Open Visualizer for Hosted Agents.

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

Конфликты портов

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

  1. В левой боковой панели VS Code выберите значок шестеренки, чтобы открыть меню параметров.
  2. Выберите Extensions>Microsoft Foundry Configuration.
  3. Найдите параметр Hosted Agent Visualization Port и измените его на доступный номер порта.
  4. Перезапустите VS Code, чтобы применить изменения.

Изменение порта в коде

Измените порт визуализации, задав FOUNDRY_OTLP_PORT переменную среды. Обновите порт наблюдаемости в workflow.py файле соответствующим образом.

Например, чтобы изменить порт на 4318, используйте следующую команду:

  export FOUNDRY_OTLP_PORT=4318

Обновите номер порта в workflow.py конфигурации наблюдаемости:

  setup_observability(vs_code_extension_port=4318)

Подсказка

Чтобы включить дополнительные сведения об отладке, добавьте enable_sensitive_data=True параметр в функцию setup_observability .

Для любых конфликтов портов измените порт визуализации, задав FOUNDRY_OTLP_PORT переменную среды. Обновите конечную точку OTLP в программе соответствующим образом.

Например, чтобы изменить порт на 4318, используйте следующую команду:

  $env:FOUNDRY_OTLP_PORT="4318"

В программе обновите конечную точку OTLP, чтобы использовать новый номер порта:

var otlpEndpoint =
    Environment.GetEnvironmentVariable("OTLP_ENDPOINT") ?? "http://localhost:4318";

Разверните размещенного агента

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

Это важно

Убедитесь, что вы предоставляете необходимые разрешения для развертывания размещенных агентов в рабочей области Foundry, как указано в предварительных требованиях. Возможно, вам потребуется работать с администратором Azure, чтобы получить необходимые назначения ролей.

  1. Откройте палитру команд кода Visual Studio и выполните команду Microsoft Foundry: Deploy Hosted Agent.
  2. Настройте параметры развертывания, выбрав целевую рабочую область, указав файл агента контейнера (container.py) и определив все другие параметры развертывания по мере необходимости.
  3. После успешного развертывания размещенный агент появится в Hosted Agents (Preview) разделе дерева расширения Microsoft Foundry.
  4. Выберите развернутого агента, чтобы получить доступ к подробным сведениям и протестировать функциональность с помощью интегрированного интерфейса песочницы.
  1. Откройте палитру команд кода Visual Studio и выполните команду Microsoft Foundry: Deploy Hosted Agent.
  2. Настройте параметры развертывания, выбрав целевую рабочую область, указав файл агента контейнера (<your-project-name>.csproj) и определив все другие параметры развертывания по мере необходимости.
  3. После успешного развертывания размещенный агент появится в Hosted Agents (Preview) разделе дерева расширения Microsoft Foundry.
  4. Выберите развернутого агента, чтобы получить доступ к подробным сведениям и проверить функциональность с помощью интегрированного интерфейса песочницы.

Связанный контент

  • Last updated on