다음을 통해 공유

A2A 에이전트 API 가져오기(미리 보기)

적용 대상: 기본 v2 | 표준 v2 | 프리미엄 v2

API Management는 A2A(Agent2Agent) 프로토콜 사양과 호환되는 AI 에이전트 API 관리를 지원합니다. A2A 프로토콜은 서로 다른 AI 에이전트 시스템이 공유 상호 작용 모델을 사용하여 통신하고 함께 작동할 수 있도록 하는 개방형 클라이언트 서버 표준입니다. API Management의 A2A 에이전트 API 지원을 사용하면 AI 모델 API, MCP(모델 컨텍스트 프로토콜) 도구 및 REST, SOAP 및 GraphQL과 같은 기존 API를 비롯한 다른 API 유형과 함께 에이전트 API를 관리하고 관리할 수 있습니다.

비고

이 기능은 미리 보기로 제공되며 몇 가지 제한 사항이 있습니다.

API Management에서 AI API를 관리하는 방법에 대해 자세히 알아봅니다.

주요 기능

A2A 에이전트 API를 가져올 때 API Management는 다음 기능을 제공합니다.

  • JSON-RPC 런타임 작업을 A2A 백 엔드로 중재합니다.
    • 정책을 사용하여 거버넌스 및 트래픽 제어를 사용하도록 설정합니다.
    • Application Insights를 통한 가시성을 사용하도록 설정하면 OpenTelemetry GenAI 의미 체계 규칙을 준수하기 위해 다음 A2A 관련 특성을 추가합니다.
      • genai.agent.id - API 설정에 구성된 에이전트 ID로 설정
      • genai.agent.name- API 설정에서 API 이름으로 설정
  • 다음 변환을 사용하여 에이전트 카드를 노출합니다.
    • 호스트 이름을 API Management 인스턴스의 호스트 이름으로 바꿉니다.
    • 기본 전송 프로토콜을 JSON-RPC로 설정합니다.
    • 에서 다른 모든 인터페이스를 제거합니다 additionalInterfaces.
    • API Management 구독 키 요구 사항을 포함하도록 보안 요구 사항을 다시 작성합니다.

필수 조건

포털을 사용하여 A2A 에이전트 API 가져오기

A2A 에이전트 API를 API Management로 가져오려면 다음 단계를 사용합니다.

  1. Azure Portal에서 API Management 인스턴스로 이동합니다.

  2. 왼쪽 메뉴의 API에서 API>+ API 추가를 선택합니다.

  3. A2A 에이전트 타일을 선택합니다.

    포털에서 A2A 에이전트 API 타일을 선택하는 스크린샷

  4. 에이전트 카드 아래에 에이전트 카드 JSON 문서를 가리키는 URL을 입력합니다. 다음을 선택합니다.

  5. A2A 에이전트 API 만들기 페이지에서 API 설정을 구성합니다.

    1. 에이전트 카드에 따라 런타임 URL 및 에이전트 ID 가 자동으로 구성되지 않은 경우 에이전트에 JSON-RPC 작업의 런타임 URL과 에이전트(gen_ai.agent.id 특성)에서 내보낸 OpenTelemetry 추적에 사용되는 에이전트 ID를 제공합니다.
    2. 일반 API 설정에서 API Management 인스턴스에 선택한 표시 이름을 입력하고 필요에 따라 설명을 입력합니다.
    3. URL에서 API Management 인스턴스가 A2A 에이전트 API에 액세스하는 데 사용하는 기본 경로를 입력합니다. API Management는 클라이언트가 JSON-RPC API에 액세스하는 데 사용할 수 있는 기본 URL 과 API Management를 통해 에이전트 카드에 액세스하는 에이전트 카드 URL 을 표시합니다.

  6. 만들기를 선택하여 API를 만듭니다.

포털에서 A2A 에이전트 호환 API를 만드는 스크린샷

A2A 에이전트 API에 대한 정책 구성

A2A 에이전트 API를 관리하는 데 도움이 되도록 하나 이상의 API Management 정책을 구성합니다.

A2A 에이전트 API에 대한 정책을 구성하려면 다음을 수행합니다.

  1. Azure Portal에서 API Management 인스턴스로 이동합니다.
  2. 왼쪽 메뉴의 API에서 A2A 에이전트 API를 선택합니다.
  3. 왼쪽 메뉴의 A2A에서 정책을 선택합니다.
  4. 정책 편집기에서 A2A 에이전트 API에 적용할 정책을 추가하거나 편집합니다. 정책은 XML 형식으로 정의됩니다.

비고

API Management는 A2A 에이전트 API 범위의 정책 앞에 전역(모든 API) 범위에서 구성된 정책을 평가합니다.

구독 키 인증 구성

A2A API 설정에서 필요에 따라 API Management를 통해 구독 키 인증을 구성할 수 있습니다. 구독 키 인증에 대해 자세히 알아봅니다.

  1. 이전 단계에서 만든 API를 선택합니다.
  2. 설정 페이지의 구독에서 필요한 구독을 선택합니다(사용).

구독 키 인증을 사용하도록 설정하는 경우 클라이언트는 A2A 에이전트 API를 호출하거나 에이전트 카드에 Ocp-Apim-Subscription-Key 액세스할 때 헤더 또는 subscription-key 쿼리 매개 변수에 유효한 구독 키를 포함해야 합니다.

A2A 에이전트 API 테스트

A2A 에이전트 API가 예상대로 작동하는지 확인하려면 API Management를 통해 백 엔드를 호출합니다.

  1. 이전 단계에서 만든 API를 선택합니다.
  2. 개요 페이지에서 런타임 기본 URL을 복사합니다. 이 URL을 사용하여 API Management를 통해 A2A 에이전트 API를 호출합니다.
  3. 테스트 클라이언트를 구성하거나 curl 과 같은 도구를 사용하여 에이전트에 POST 요청합니다. 구독 키 인증을 사용하는 경우 요청에 유효한 구독 키 헤더 또는 쿼리 매개 변수를 포함합니다.

팁 (조언)

마찬가지로 API Management를 통해 A2A 에이전트 API의 GET 페이지에 표시된 에이전트 카드 URL을 요청하여 에이전트 카드에 액세스합니다.

제한점

  • 이 기능은 현재 v2 계층의 API Management 인스턴스에서만 사용할 수 있습니다.
  • JSON-RPC 기반 A2A 에이전트 API만 지원됩니다.
  • 나가는 응답 본문의 역직렬화는 지원되지 않습니다.

관련 콘텐츠

  • Last updated on