A2A 도구

A2A 도구 (A2A Tool)

A2A(Agent-to-Agent) 프로토콜로 네트워크상의 원격 에이전트에 연결하는 방법을 설명해요. 같은 구성에 없는 원격 에이전트와도 대화할 수 있어요.

출처: 문서

본문

A2A 도구는 A2A(Agent-to-Agent) 프로토콜로 노출된 원격 에이전트에 연결해요. handoff가 같은 구성에서 선언한 로컬 에이전트만 겨냥하는 것과 달리, a2a는 네트워크상에서 실행 중인 에이전트에게 다가가요.

구성

toolsets:
  - type: a2a
    url: "http://localhost:8080/a2a"
    # 선택: 커스텀 도구 이름 (기본은 URL / 에이전트 카드 이름의 정규화된 형태)
    name: research_agent
    # 선택: 커스텀 HTTP 헤더 (보통 인증용)
    headers:
      Authorization: "Bearer ${env.A2A_TOKEN}"
      X-Tenant: "acme"

위에 보이는 Authorization 헤더는 docker agent serve a2a --auth-token으로 서빙되는 엔드포인트에 인증해 줘요.

속성

속성 타입 필수 설명
url string ✓ A2A 서버 엔드포인트 URL(scheme 포함)
name string ✗ 원격 에이전트용으로 등록되는 도구 이름. 기본은 서버의 에이전트 카드에서 파생된 이름
headers map[string]string ✗ 모든 요청에 함께 보내는 추가 HTTP 헤더(Authorization, 테넌트 선택, 트레이싱 등에 유용)

팁 더 보기 A2A 프로토콜과 에이전트를 A2A 엔드포인트로 서빙하는 전체 내용은 A2A 프로토콜 문서를 참고하세요.

더 알아보기 (Learn more)