A2A 프로토콜 스펙 — 계층 구조와 핵심 개념
A2A 프로토콜 스펙
A2A 스펙은 독립적이고 불투명한 AI 에이전트 시스템 간의 통신·상호운용을 위한 공개 표준입니다. 최신 릴리스는 1.0.0 입니다.
목표와 원칙
- 상호운용 — 서로 다른 에이전트 시스템 사이의 통신 격차를 메웁니다.
- 비동기 우선(Async First) — 길게 실행되는 작업과 사람이 개입하는(human-in-the-loop) 시나리오를 기본 지원합니다.
- 단순 — HTTP, JSON-RPC 2.0, Server-Sent Events 같은 검증된 표준을 재사용합니다.
- 엔터프라이즈 준비 — 인증·권한·보안·프라이버시·트레이싱을 기업 관행에 맞춥니다.
- 불투명 실행 — 에이전트는 내부 생각·계획·도구 구현을 공유하지 않고 선언된 능력과 교환된 정보로 협업합니다.
세 가지 계층
스펙은 세 계층으로 구성됩니다:
- L1: 정식 데이터 모델(Canonical Data Model) — 모든 구현이 이해해야 하는 핵심 데이터 구조·메시지 형식.
Task,Message,AgentCard,Part,Artifact,Extension등. 프로토콜 버퍼 메시지로 정의합니다. - L2: 추상 연산(Abstract Operations) — A2A 에이전트가 지원해야 할 근본 능력. 메시지 보내기(
SendMessage), 스트리밍(SendStreamingMessage),GetTask/ListTasks/CancelTask,GetAgentCard등. - L3: 프로토콜 바인딩(Protocol Bindings) — 추상 연산과 데이터 구조를 JSON-RPC, gRPC, HTTP/REST 같은 구체 프로토콜에 매핑.
이 계층화 덕분에 핵심 의미론은 바인딩을 가로질러 일관되고, 데이터 모델을 바꾸지 않고 새 바인딩을 추가할 수 있습니다.
핵심 용어
- Agent Card — A2A 서버가 발행하는 JSON 메타데이터로, 정체·능력·스킬·서비스 엔드포인트·인증 요구사항을 기술.
- Task — A2A 가 관리하는 작업의 기본 단위. 고유 ID 로 구분되고 상태 머신을 따라 진행.
- Message / Part / Artifact — 클라이언트-원격 에이전트 사이의 대화 턴, 내용의 최소 단위, 그리고 작업 결과로 생성된 출력물.
버전 협상
클라이언트는 각 요청에 A2A-Version 헤더(예: A2A-Version: 1.0)를 실어 호환성을 보장합니다.