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

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

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

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

Предпосылки

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

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

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

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

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

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

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

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

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

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

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

Замечание

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Планирование идентификации и доступов

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

Дополнительные сведения см. в разделе "Основные понятия удостоверений агента" в Microsoft Foundry.

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

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

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

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

Это важно

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

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

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

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

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

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

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

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

  • Last updated on