Служба приложений как средство OpenAPI в агенте Foundry

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

Обзор

Спецификации OpenAPI описывают ИНТЕРФЕЙСы REST API в стандартном формате, доступном для чтения компьютера. Служба агента Foundry может использовать эти спецификации для автоматического обнаружения и активации возможностей вашего веб-приложения в качестве инструментов внутри агентов ИИ. Такой подход позволяет:

  • Использование существующих API: преобразование текущих конечных точек REST в средства, доступные для искусственного интеллекта, без изменений кода
  • Поддержание стандартов API: использование отраслевых спецификаций OpenAPI, которые обслуживают как человеческих пользователей, так и пользователей искусственного интеллекта
  • Включение быстрой интеграции. Добавление новых возможностей для агентов просто путем обновления спецификации OpenAPI
  • Сохранение бизнес-логики: сохраняйте существующий код приложения, безопасность и шаблоны доступа к данным без изменений
  • Масштабирование с помощью управляемых служб. Использование встроенной масштабируемости и надежности службы агента Foundry

Этот шаблон особенно мощный, так как большинство современных веб-приложений уже предоставляют REST API для их основных функциональных возможностей. Задокументируя эти API с помощью спецификаций OpenAPI, вы сразу же сделаете их доступными в виде стандартных блоков для интеллектуальных агентов.

Когда следует использовать средства OpenAPI

Рассмотрите возможность предоставления приложения Службы приложений в качестве средства OpenAPI для агентов Foundry, когда:

  • У вас есть интерфейсы REST API: приложение уже предоставляет четко определенные конечные точки HTTP.
  • Требуется быстрая разработка агентов: необходимо быстро создавать функциональные агенты с минимальным пользовательским кодом.
  • Вам нужны декларативные определения инструментов: вы предпочитаете описывать возможности с помощью спецификаций, а не программирования.
  • Вы хотите поддерживать несколько агентов: один и тот же API может обслуживать несколько сценариев агента с разными оркестрациями.
  • Вам требуются четкие контракты API: спецификации OpenAPI предоставляют документацию и проверку для агентов и разработчиков.

Этот подход особенно хорошо подходит для бизнес-приложений, внутренних инструментов и архитектур микрослужб, где REST API образуют естественную границу между компонентами.

Как средства OpenAPI работают с агентами

Интеграция следует этому простому процессу.

  1. Определите свой API: создайте или сгенерируйте спецификацию OpenAPI для конечных точек REST службы приложений
  2. Регистрация в качестве инструмента: добавьте API в службу агента Foundry, указав расположение спецификации OpenAPI
  3. Обнаружение агента: агент автоматически понимает доступные операции, параметры и форматы ответа.
  4. Вызов среды выполнения. Когда пользователи взаимодействуют с агентом, он вызывает конечные точки службы приложений по мере необходимости.
  5. Обработка результатов: агент интерпретирует ответы API и включает результаты в беседу

Служба приложений обеспечивает встроенную поддержку шаблонов проверки подлинности, необходимых для вызова безопасного средства, включая управляемые удостоверения и интеграцию идентификатора Microsoft Entra ID.

Начните с учебных материалов

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

  • Last updated on