Использование и перенос декларативных рабочих процессов агента с помощью Microsoft Foundry Toolkit

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

Это важно

Декларативные рабочие процессы в Microsoft Foundry доступны в предварительной версии и будут выведены из эксплуатации 1 декабря 2026 года. Используйте Microsoft Agent Framework для разработки новых рабочих процессов. Этот вывод из эксплуатации не влияет на оркестрацию на основе кода в размещаемых агентах. См. руководство по миграции рабочих процессов для поддерживаемых путей миграции.

Prerequisites

Просмотр декларативного рабочего процесса агента

Найдите рабочий процесс в консолидированном списке агентов проекта.

  1. В представлении Набора средств Foundry в разделе "Мои ресурсы" подтвердите выбранный проект Foundry.
  2. Выберите агенты и перейдите на вкладку "Рабочий процесс ".
  3. Выберите имя рабочего процесса, чтобы открыть свою игровую площадку.
  4. Используйте селектор версий, чтобы выбрать сохраненную версию, которую вы хотите проверить.

На игровой площадке показан график рабочего процесса и область беседы. Граф доступен только для чтения. Чтобы изменить определение, используйте экспортированный YAML или портал Foundry.

Изменение существующего определения рабочего процесса

Экспортируйте определение перед изменением или переносом его. Сохраните копию исходного YAML, чтобы сравнить ее с изменениями.

  1. Откройте существующий рабочий процесс на портале Foundry.
  2. В конструкторе рабочих процессов перейдите в представление YAML и скопируйте или экспортируйте определение. Дополнительные сведения см. в разделе "Экспорт определения рабочего процесса".
  3. Сохраните определение в вашей локальной рабочей области с именем, заканчивающимся на .workflow.yaml, например support.workflow.yaml.
  4. Откройте файл в Visual Studio Code и измените YAML.
  5. Сохраните файл. Изменения локального файла не обновляют рабочий процесс в Foundry.

Сохранение новой версии существующего рабочего процесса

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

  1. Убедитесь, что проект исходного рабочего процесса выбран в Средстве Foundry.
  2. .workflow.yaml Открыв файл, выберите "Развернуть" на панели инструментов редактора.
  3. В поле Введите имя рабочего процесса введите имя существующего рабочего процесса.
  4. Дождитесь уведомления об успешном развертывании.
  5. Снова откройте рабочий процесс в разделе Агенты> и выберите новую версию.

При развертывании с существующим именем рабочего процесса создается новая версия. Другое имя создает отдельный рабочий процесс; Не используйте этот путь для запуска разработки новых рабочих процессов.

Тестирование рабочего процесса на игровой площадке

Проверьте сохраненную версию, которую планируете поддерживать или перенести. Используйте те же запросы позже, чтобы сравнить перенесенную реализацию.

  1. Откройте игровую площадку рабочего процесса и выберите требуемую версию.
  2. На вкладке "Детская площадка" выберите "Создать ", чтобы начать новый сеанс игровой площадки.
  3. Введите запрос для проверки процесса и отправьте его.
  4. Просмотрите ответ и график выполнения. Убедитесь, что ожидаемые агенты, ветви и шаги выполняются.
  5. Повторите это с запросами, которые задействуют разные ветви, случаи с отсутствующими входными данными и любые шаги утверждения в вашем рабочем процессе.

На детской площадке выполняется сохраненный рабочий процесс Foundry. Он не запускает ни несохранённые изменения в локальном YAML-файле, ни код, который генерирует Copilot.

Преобразование рабочего процесса YAML в код Agent Framework

Используйте действие генерации кода в песочнице, чтобы попросить GitHub Copilot преобразовать выбранное определение рабочего процесса. Созданный код — это отправная точка, которую необходимо проверить и протестировать.

  1. На игровой площадке рабочего процесса выберите версию для миграции.
  2. Выберите "Создать код".
  3. Выберите Python или C#.
  4. Просмотрите запрос на преобразование в Copilot Chat и следуйте инструкциям по созданию кода.
  5. Просмотрите созданный проект, зависимости, подключения модели, средства и конфигурацию проверки подлинности.
  6. Сравните его оркестрацию с экспортируемым YAML. Проверьте ветвление, переменные, вызовы агента и этапы утверждения человеком.
  7. Запустите код локально и протестируйте его с помощью запросов, используемых для исходного рабочего процесса. Используйте Agent Inspector, чтобы проверить выполнение.
  8. Если код ведет себя должным образом, следуйте инструкциям по созданию размещенных агентов , чтобы подготовить поддерживаемый проект размещенного агента, развернуть его и проверить развернутую версию.

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

О других вариантах миграции, в том числе о декларативном YAML для Agent Framework, Azure Logic Apps и прямых подключениях A2A, см. руководство по миграции рабочих процессов.

Связанные материалы

Используйте следующие руководства, чтобы выбрать и завершить миграцию:

  • Last updated on