Жизненный цикл разработки агента

Жизненный цикл разработки агента в Microsoft Foundry охватывает этапы от первоначального создания до мониторинга в производственной среде. В основе каждого агента лежит модель из каталога моделей Foundry, которая управляет формированием причин и ответов. Следуя этому жизненному циклу, вы можете создавать надежных агентов, выявлять проблемы на ранних стадиях и выпускать продукты с уверенностью. Используйте портал Foundry или код для создания, настройки и проверки поведения агента. Затем выполните итерацию, используя трассировку, оценку и мониторинг, чтобы улучшить качество и надежность. Когда вы будете готовы, опубликуйте вашего агента как приложение, чтобы поделиться им и интегрировать его в свои приложения.

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

Необходимые условия

Жизненный цикл на первый взгляд

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

  1. Выберите тип агента: начните с агента с подсказками, рабочего процесса или размещённого агента.
  2. Создайте агент и запустите тестирование: выполните итерацию на детской площадке или в коде.
  3. Добавьте средства и данные: подключите средства для извлечения и действий и проверьте конфигурацию перед сохранением.
  4. Сохраняйте изменения в виде версий: фиксируйте значимые вехи и сравнивайте версии.
  5. Отладка с помощью трассировки: используйте трассировку для подтверждения вызовов инструментов, задержки и сквозного поведения. Дополнительные сведения см. в обзоре трассировки агента.
  6. Оценка качества и безопасности. Выполнение повторяемых вычислений для перехвата регрессий перед публикацией. Концептуальное руководство см. в разделе "Оценщики агентов".
  7. Публикация и интеграция: публикация стабильной конечной точки и его интеграция в приложение. Инструкции см. в разделе Agent в приложениях Microsoft Foundry.
  8. Мониторинг и итерация: контроль производительности и качества в рабочей среде, с последующим обновлением и повторной публикацией по мере необходимости. Инструкции см. в разделе "Мониторинг агентов".

Типы агентов в Microsoft Foundry

Существует три типа агентов:

  • На основе запроса: агент на основе запроса — это декларативно определенный один агент, который объединяет модель Foundry, инструкции, инструменты и запросы естественного языка на управление поведением. Расширьте его, подключив инструменты для расширения знаний и памяти. Редактировать, управлять версиями, тестировать, оценивать, мониторить и публиковать агентов, использующих подсказки, в песочнице Агентов на портале Foundry.

  • Рабочий процесс. Используйте рабочие процессы для создания более сложного рабочего процесса, который управляет последовательностью действий или координирует несколько агентов. Рабочие процессы имеют собственный интерфейс на портале, но применяется тот же жизненный цикл. Для получения подробной информации см. раздел Создание рабочего процесса в Microsoft Foundry.

  • Размещенные (предварительная версия): размещенные агенты — это контейнеризованные агенты, которые вы создаете в коде с помощью поддерживаемых платформ или пользовательского кода. Служба Foundry Agent развертывает этих агентов и управляет ими. В пользовательском интерфейсе создания агента вы не редактируете размещенные агенты, но по-прежнему можете вызывать, оценивать, отслеживать и публиковать их. Дополнительные сведения см. в разделе "Что такое размещенные агенты?"

Создайте агенты и рабочие процессы на основе запросов на портале Foundry или собственной среде разработки с помощью ИНТЕРФЕЙСА командной строки, пакета SDK или REST API. Дополнительные сведения см. в кратком руководстве.

Создание агента на основе запроса

Если вы уже знаете, какой агент вы хотите создать, назовите его, а затем начните настраивать инструкции и средства модели.

Примечание

После того как вы назовёте агента, вы не можете изменить имя. В коде вы ссылаетесь на вашего агента по <agent_name>:<version>.

Разработка агентов в коде

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

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

Основные возможности жизненного цикла разработки агента

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

Сохранение изменений в виде версий

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

Управление версиями агента предоставляет следующие возможности для управления конфигурациями агентов и итерациями. Эта система гарантирует, что все изменения отслеживаются, тестируются и сравниваются между версиями.

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

  • Управление состоянием черновика: вы можете тестировать агентов в несохраненном состоянии для экспериментов. Если вы покидаете портал Foundry, вы теряете несохраненные изменения, поэтому часто сохраняете важные изменения.

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

  • Навигация журнала версий: доступ к журналу версий для любого агента, перейдите к любой конкретной версии и выполните следующие сравнения:

    Тип сравнения Описание
    Настройка агента Сравнение параметров конфигурации между версиями с помощью раскрывающегося списка версий
    Выходные данные чата Анализ различий ответов между версиями агента с использованием идентичных входных данных
    Определение YAML Просмотр различий между определениями агента

Добавление инструментов

Сделайте агент более мощным, предоставляя ему знания (определенные файлы или индексы) или позволяя ему выполнять действия (вызов внешних API). Средства доступны для большинства вариантов использования, от простых загрузок файлов до подключений серверов по пользовательскому протоколу контекста модели (MCP). Для более сложных средств может потребоваться настроить проверку подлинности или добавить подключения в рамках подключения их к агенту.

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

Отладка и проверка с помощью трассировки (предварительная версия)

При добавлении инструментов и итерации по предложениям используйте трассировку для проверки сквозного поведения:

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

Дополнительные сведения см. в Обзор трассировки агента.

Оценка качества и безопасности (предварительная версия)

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

Мониторинг после публикации

После публикации приложения агента обработайте его как рабочее программное обеспечение:

  • Следите за качеством и безопасностью сигналов.
  • Просмотрите трассировки при изменении поведения.
  • Обновление и повторная публикация при устранении проблем или внесении улучшений.

Инструкции см. в разделе "Агенты трассировки".

Планирование идентификации и разрешений

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

Дополнительные сведения см. в разделе понятия идентификации агента в Microsoft Foundry.

Безопасность и доступ

Относитесь к конфигурации агента как к коду приложения. Защита секретов и разрешений на протяжении всего жизненного цикла:

Публикация агента или рабочего процесса

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

Важно

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

Распространенные ошибки разработки агентов

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

Связанное содержимое

Дополнительные сведения о типах агентов:

Настройка и расширение агентов:

Публикация и мониторинг агентов:

Отладка и оценка:

  • Last updated on