Импорт API агента A2A

ОБЛАСТЬ ПРИМЕНЕНИЯ: Разработчик | Базовый | Базовая версия 2 | Стандартный | Стандартная версия 2 | Премиум | Премиум версия 2

Управление API поддерживает управление API-интерфейсами агента ИИ, совместимыми с спецификацией протокола Agent2Agent (A2A). Протокол A2A — это стандарт открытого клиентского сервера, который позволяет различным системам агентов ИИ взаимодействовать и работать вместе с помощью общей модели взаимодействия. Благодаря поддержке API агента A2A в службе управления API вы можете управлять API-интерфейсами агента и управлять ими вместе с другими типами API, включая API модели ИИ, инструменты MCP и традиционные API, такие как REST, SOAP и GraphQL.

Узнайте больше об управлении AI API в API Management.

Ключевые возможности

При импорте API агента A2A управление API предоставляет следующие возможности:

  • Управляет выполнением операций JSON-RPC с серверной частью A2A.
    • Обеспечивает управление и контроль трафика посредством политик.
    • Если включена наблюдаемость с помощью Application Insights, добавляются следующие атрибуты, специфичные для A2A, в соответствии с семантической конвенцией OpenTelemetry GenAI:
      • genai.agent.id — Задайте идентификатор агента, настроенный в параметрах API
      • genai.agent.name— Задайте имя API в параметрах API
  • Отображает карточку агента со следующими преобразованиями:
    • Заменяет имя узла именем узла экземпляра управления API.
    • Задает предпочтительный транспортный протокол JSON-RPC.
    • Удаляет все остальные интерфейсы в additionalInterfaces.
    • Переопределяет требования к безопасности, чтобы включить требование ключа подписки управления API.

Предпосылки

  • Существующий экземпляр системы управления API. Создайте его, если у вас его нет.

  • Существующий агент A2A с операциями JSON-RPC и агентской карточкой.

Импорт API агента A2A с помощью портала

Выполните следующие действия, чтобы импортировать API агента A2A в службу управления API.

  1. На портале Azure откройте экземпляр API Management.

  2. В меню слева в разделе API выберите API>+ Добавить API.

  3. Выберите плитку A2A агент.

    Снимок экрана: выбор значка API агента A2A на портале.

  4. В разделе карточки агента введите URL-адрес , указывающий на документ JSON карточки агента. Нажмите кнопку Далее.

  5. На странице "Создание API агента A2A " настройте параметры API.

    1. Если URL-адрес среды выполнения и идентификатор агента не настраиваются автоматически на основе карточки агента, укажите агенту URL-адрес выполнения операций JSON-RPC и идентификатор агента, используемый в трассировках OpenTelemetry, создаваемых этим агентом ( атрибутом).
    2. В разделе "Общие параметры API" введите отображаемое имя на ваше усмотрение в экземпляре API Management, а также при необходимости введите описание.
    3. В разделе URL-адрес введите базовый путь , который используется экземпляром службы управления API для доступа к API агента A2A. Управление API отображает базовый URL-адрес , который клиенты могут использовать для доступа к API JSON-RPC и URL-адрес карточки агента для доступа к карточке агента через управление API.

  6. Нажмите кнопку "Создать", чтобы создать API.

Снимок экрана: создание API, совместимого с агентом A2A на портале.

Настройка политик для API агента A2A

Настройте одну или несколько политик API Management, чтобы помочь управлять API агента A2A.

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

  1. На портале Azure откройте экземпляр API Management.
  2. В меню слева в разделе API выберите API агента A2A.
  3. В меню слева в разделе A2A выберите "Политики".
  4. В редакторе политик добавьте или измените политики, которые необходимо применить к API агента A2A. Политики определяются в формате XML.

Замечание

Управление API оценивает политики, настроенные в глобальной области (все API) перед политиками в области API агента A2A.

Настройка проверки подлинности ключа подписки

В параметрах API A2A можно настроить проверку подлинности ключа подписки с помощью управления API. Дополнительные сведения о проверке подлинности ключа подписки.

  1. Выберите API, созданный на предыдущем шаге.
  2. На странице "Параметры " в разделе "Подписка" выберите (включить) необходимую подписку.

Если включить проверку подлинности ключа подписки, клиенты должны включать действительный ключ подписки в параметр заголовка Ocp-Apim-Subscription-Key или subscription-key запроса при вызове API агента A2A или доступе к карточке агента.

Тестирование API агента A2A

Чтобы убедиться, что API агента A2A работает должным образом, вызовите серверную часть через управление API:

  1. Выберите API, созданный на предыдущем шаге.
  2. На странице обзора скопируйте базовый URL-адрес среды выполнения. Используйте этот URL-адрес для вызова API агента A2A с помощью управления API.
  3. Настройте тестовый клиент или используйте инструмент, такой как curl, чтобы отправить POST запрос агенту. Если включена проверка подлинности ключа подписки, включите в запрос допустимый заголовок ключа подписки или параметр запроса.

Подсказка

Аналогичным образом получите доступ к карточке агента через управление API, выполнив GET запрос на URL-адрес карточки агента , отображаемый на странице обзора API агента A2A.

Ограничения

  • Поддерживаются только API агента A2A на основе JSON-RPC.
  • Десериализация исходящих тел ответа не поддерживается.

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

  • Last updated on