A2A에이전트 간 프로토콜 · Agent2Agent Protocol
서로 다른 팀 · 프레임워크가 만든 AI 에이전트끼리 일을 맡기고 결과를 받도록, 능력 소개서(Agent Card) · 작업(Task) · 메시지 · 산출물(Artifact)과 상태 · 전송 방식을 정한 공개 프로토콜이다. 상대 에이전트의 내부 계획 · 메모리 · 도구는 드러내지 않고 주고받은 메시지와 산출물로만 협업한다.
1요약
- A2A 는 클라이언트 에이전트가 원격 에이전트의 Agent Card(
/)를 읽고 Task · Message · Artifact 로 일을 맡기는 규약이다 — 2025-06 리눅스 재단 프로젝트가 된 뒤 현행은 1.0(2026-03 · 1.0.1 = 2026-05)이고, 멀티 에이전트 구성에서 «다른 팀이 만든 에이전트에 일 넘기기»가 이 위에서 돈다.. well-known/ agent-card. json - 상대 에이전트를 도구 함수 하나로 감싸면 몇 시간 걸리는 일 · 중간에 되묻는 일을 담을 방법이 없다 — A2A 는 작업 상태를 9개로 정해 끝 상태 넷(완료 · 실패 · 취소 · 거절)과 중단 상태 둘(입력 필요 · 인증 필요)을 가른다(A2A 명세 1.0 4.1.3).
- 「위임이 안 된다」는 어느 단계에서 멈췄는가로 가른다 — 카드를 못 받으면 발견, 401 · 403 이면 인증,
-32005면 형식 협상, 작업이 입력 필요에 서 있으면 클라이언트의 답 누락,-32001·-32002면 작업 id · 상태 규칙이다.
2등장 배경
출장 지원 에이전트가 다른 팀이 만든 숙소 예약 에이전트에 일을 넘기려 하면, 두 팀이 쓰는 에이전트 프레임워크가 달라 짝마다 전용 API 를 새로 짰다. 상대를 도구 함수로 감싸 부르면 한 번 묻고 한 번 답하는 꼴이 되어 «후보 둘 중 고르라»는 되물음이나 진행 상황을 보낼 방법이 없었고, 상대의 내부 프롬프트 · 도구를 알아야 붙일 수 있었다.
2025-04 한 클라우드 회사가 A2A 를 공개했고, 2025-06-23 리눅스 재단이 명세 · SDK 를 넘겨받아 공급자 중립 프로젝트로 출범시켰다(리눅스 재단 A2A 발표). 0.2.2(2025-06)에서 JSON-RPC 에 더해 gRPC · REST 정의가, 0.3.0(2025-07)에서 카드 주소 변경(agent.json → agent-card.json)과 카드 서명이 들어왔고, 1.0.0(2026-03)은 프로토콜 정의와 전송 바인딩을 나누고 ListTasks 를 더했다(A2A 릴리스 기록).
지금은 MCP 가 에이전트 ↔ 도구 · 데이터를, A2A 가 에이전트 ↔ 에이전트를 맡는다는 분담이 명세 부록 B 에 적혀 있다 — A2A 서버 에이전트가 맡은 작업을 하려고 안에서 MCP 로 도구를 부르는 식이다. 네 프로토콜을 견준 Ehtesham 외(2025)도 도구 접근 = MCP, 협업 작업 = A2A 순으로 쓰임을 나눴다.
3쉽게 이해하기 — 출장 뷔페 업체에 맡기는 행사 기획자
행사 기획자가 회사 행사의 식사를 출장 뷔페 업체에 맡긴다. 업체 안내 책자에서 차릴 수 있는 메뉴와 주문 창구 · 결제 확인 방법을 보고 주문하면, 업체가 주문 번호를 주고 「한식과 양식 중 어느 쪽인가요」 하고 전화로 되묻는다. 기획자가 답하면 업체는 도매상에서 재료를 사 와 주방에서 차리고, 음식과 명세서를 상자에 담아 보낸다. 기획자는 업체 주방 안을 보지 못하고, 주문 번호와 납품 상자로만 일을 주고받는다.
그림 1 · 기획자는 안내 책자로 업체를 고르고 주문 번호로 일을 이어 가며, 업체 주방과 도매상은 보지 않은 채 납품 상자만 받는다.
그림 2 · 안내 책자의 메뉴 · 연락 방법 · 주문 창구 · 신원 확인 칸은 Agent Card 의 skills · capabilities · supportedInterfaces · security 필드와 하나씩 짝을 이룬다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 행사 기획자 | 클라이언트 에이전트 | 사용자 요청을 받아 원격 에이전트에 작업을 맡긴다 |
| 업체 안내 책자 | Agent Card | 이름 · skills · 지원 바인딩 · 인증 방식을 정해진 주소에 게시한다 |
| 주문 번호 | Task id | 원격 에이전트가 만들고, 이어 보내는 메시지마다 같은 값을 싣는다 |
| 행사 이름 | contextId | 관련 작업 · 메시지 여러 건을 한 대화로 묶는다 |
| 확인 전화 | 입력 필요 상태 | 작업을 멈추고 클라이언트의 다음 메시지를 기다린다 |
| 닫힌 주방 | 불투명 실행 | 내부 계획 · 메모리 · 도구 구현은 밖에 내보내지 않는다 |
| 도매상 | MCP 로 부르는 도구 | 원격 에이전트가 작업을 하려고 안에서 부른다 |
| 납품 상자 | Artifact | Part(글 · 파일 · 데이터)로 결과를 담아 돌려준다 |
⚠ 비유가 맞지 않는 곳: 뷔페 업체는 전화로 아무 때나 연락하지만, A2A 원격 에이전트는 클라이언트가 연 스트림이나 클라이언트가 등록한 웹훅 주소로만 알린다. 또 주문을 마친 뒤 같은 주문 번호로 추가 주문을 할 수 없다 — 끝난 작업은 메시지를 더 받지 않고, 새 작업을 만들어 앞 작업을 가리킨다.
4구조 — 카드 · 바인딩 · 작업 객체
A2A 의 객체는 바인딩과 따로 정의되고, 같은 Task · Message 를 JSON-RPC 2.0 · gRPC · HTTP+JSON 가운데 카드가 밝힌 바인딩으로 실어 나른다(A2A 명세 1.0 9 ~ 11절). 원격 에이전트 안의 LLM · 메모리 · MCP 연결은 이 프로토콜 바깥이다.
그림 3 · 클라이언트는 카드와 바인딩 하나만 알면 되고, 원격 에이전트 안의 계획 · 메모리 · MCP 도구 호출은 프로토콜 밖에 닫혀 있다.
| 요소 | 맡는 일 | 값 · 근거 |
|---|---|---|
| Agent Card | 능력 · 주소 · 인증 알림 | https: · 필수 필드 8개(name · skills · supportedInterfaces · capabilities 등)(A2A 명세 1.0 8.2 · 4.4.1) |
| AgentSkill | 맡길 수 있는 일 한 가지 | 필수 id · name · description · tags(4.4.5) |
| Task | 일 한 건의 상태 · 결과 | id(서버가 만듦) · contextId · status · artifacts · history(4.1.1 · 3.4.2) |
| Message | 한 차례 주고받는 말 | role = USER · AGENT · parts · taskId · referenceTaskIds(4.1.4) |
| Part | 내용 조각 | text · raw · url · data 중 정확히 하나 + mediaType(4.1.6) |
| Artifact | 작업이 낸 결과물 | artifactId · parts 1개 이상(4.1.7) |
| 전달 방식 | 진행 상황을 받는 길 | 폴링 · 스트리밍(SSE) · 푸시 알림(3.5.1) |
| 보안 체계 | 누가 맡겼나 증명 | API 키 · HTTP 인증 · OAuth 2 · OpenID Connect · 상호 TLS(4.5) |
🔑 MCP 는 상대를 «도구로 열어» 이름과 인자로 부르고, A2A 는 상대를 «닫힌 동료로 두고» 작업과 결과만 주고받는다 — 그래서 A2A 에는 도구 스키마 대신 작업 상태와 산출물이 있다.
5동작 — 숙소 예약 위임 한 건
Python 모의 실행으로 직접 확인했다(실제 LLM 호출 없음 · 메시지 모양 = A2A 명세 1.0). 주소 hotel.example · 숙소 후보 · 금액 · 예약 번호는 설명용 가정 값이다.
- 출장 지원 에이전트(클라이언트)가
GET https:으로 카드(680바이트)를 받아 skill 2개(/ / hotel. example/ . well-known/ agent-card. json hotel-search·hotel-book) ·streaming: true·pushNotifications: false· Bearer 인증을 읽는다. - 사용자 요청 「부산 11-20 1박, 5만 원 이하」를
SendStreamingMessage(m-1 ·ROLE_USER· text Part)로 보낸다 —taskId가 없으니 원격이task-0001·ctx-0001을 만든다(3.4.2). - SSE 이벤트 3개가 온다 —
task(SUBMITTED) →statusUpdate(WORKING) →statusUpdate(INPUT_REQUIRED · 「H1 48,000원 · H2 46,000원 중 선택」) · 이 모의 서버는 중단 상태에서 이 스트림을 닫는다. - 클라이언트가 사용자에게 묻고, 고른 「H2」를 같은
taskId·contextId를 실은 m-2 로 다시 보낸다(3.4.3). - 이벤트 3개가 이어진다 — WORKING →
artifactUpdate(a-1 · data Part{hotel H2, price 46000, confirm BK-7731}·application/json) → COMPLETED. GetTask(historyLength=은 COMPLETED · 기록 메시지 2개 · Artifact 1개를 돌려준다.10) - 뒤늦게 보낸
CancelTask는 끝 상태라-32002 TaskNotCancelableError로 거절된다 — 합계 = 요청 5건(카드 1 · 스트림 2 · 조회 1 · 취소 1) · 스트림 이벤트 6개.
그림 4 · 되묻기 한 번은 새 작업이 아니라 같은 taskId 의 두 번째 메시지이고, 끝난 작업의 취소는 -32002 로 거절된다.
작업 상태 9개(TASK_STATE_UNSPECIFIED 포함)는 진행 둘 · 중단 둘 · 끝 넷으로 나뉜다(4.1.3). 중단 상태는 같은 taskId 의 다음 메시지로 이어 가고, 끝 상태 작업은 메시지를 더 받지 않으므로 이어 할 일은 새 작업을 만들어 referenceTaskIds 로 앞 작업을 가리킨다(3.1.1 · 4.1.4).
그림 5 · 중단 상태는 같은 작업으로 돌아오는 고리이고, 끝 상태 넷에서 나가는 화살은 없다 — 이어 할 일은 새 작업이 맡는다.
🔑 되묻기는 새 작업이 아니라 같은 작업의 다음 메시지다 — taskId 를 비우고 답하면 원격은 새 작업을 만들어 앞의 후보 목록을 잃는다.
6비교 — 바로 응답 · 폴링 · 스트리밍 · 푸시 알림
MCP · 앱 전용 연동과 A2A 의 짝 비교는 MCP 에서 다루므로, 여기서는 A2A 안에서 진행 상황을 받는 네 길을 견준다(3.2.2 · 3.5.1).
| 기준 | 바로 응답 | 폴링 | 스트리밍 | 푸시 알림 |
|---|---|---|---|---|
| 부르는 법 | SendMessage(기본 = 끝 · 중단 상태까지 기다림) | returnImmediately: true 뒤 GetTask 반복 | SendStreamingMessage · SSE | taskPushNotificationConfig 등록 · 웹훅 POST |
| 카드에 필요한 필드 | 없음 | 없음 | capabilities.streaming | capabilities. |
| 명세가 든 쓰임 | 짧은 작업 | 단순 연동 · 드문 갱신 · 방화벽 뒤 클라이언트 | 대화형 화면 · 실시간 진행 표시 | 서버 사이 연동 · 오래 걸리는 작업 |
| 연결이 끊기면 | 다시 보냄 | 다음 GetTask | SubscribeToTask 로 다시 구독 | 원격이 다시 보냄 · 중복 가능 |
| 보안 주의 | 없음 | 없음 | 연결 동안 토큰 유효 | 웹훅 인증 필수 · SSRF 막기 · 멱등 처리(13.2) |
분석몇 초 안에 끝나는 일은 바로 응답, 사람 화면에 진행을 보이면 스트리밍, 몇 시간 걸리고 클라이언트가 계속 연결해 둘 수 없으면 푸시 알림을 고르고, 방화벽 때문에 들어오는 연결을 못 받으면 폴링으로 내려간다. 근거는 명세 3.5.1 의 쓰임 구분과, 푸시만 클라이언트 쪽에 들어오는 웹훅 주소를 열어 13.2 의 인증 · SSRF 의무가 따라온다는 점이다.
7실무 진단 — 멈춘 단계 가르기
분석위임이 실패하면 카드 → 인증 → 형식 협상 → 작업 상태 순으로 본다 — 앞 단계가 틀리면 뒤 단계 오류가 아예 나오지 않기 때문이다. 근거는 카드의 supportedInterfaces · security 를 읽어야 요청을 만들 수 있고(8.2 · 4.4.1), 작업 오류 -32001 ~ -32002 는 요청이 원격에 받아들여진 뒤에만 나온다는 점이다(5.4).
| # | 증상 | 의심 원인 | 단계 | 확인 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 카드 요청이 404 | 옛 주소 agent.json 사용 | 발견 | 요청 주소 · 원격 판 | 0.3.0 부터 /(A2A 릴리스 기록 · 8.2) |
| 2 | 401 · 403 | 카드가 요구한 인증 누락 | 인증 | 카드 securitySchemes · 요청 Authorization | 카드에 선언한 방식으로 증명(4.5 · 7.3) |
| 3 | -32005 | Part 형식을 원격이 못 받음 | 형식 협상 | mediaType ↔ defaultInputModes · acceptedOutputModes | ContentTypeNotSupportedError(5.4) |
| 4 | -32009 | 판 불일치 | 판 협상 | 요청의 A2A-Version 헤더 | 값이 비면 0.3 으로 해석(3.6) |
| 5 | 작업이 INPUT_ | 클라이언트가 답을 안 보냄 · taskId 를 비움 | 작업 상태 | 다음 메시지의 taskId · contextId | 같은 값으로 이어 보냄(3.4.3) |
| 6 | -32001 · -32002 | 없는 작업 id · 끝난 작업 취소 | 작업 상태 | GetTask 결과의 status | TaskNotFoundError · TaskNotCancelableError(5.4) |
| 7 | 같은 결과가 두 번 처리됨 | 푸시 중복 배달 | 전달 | 웹훅 기록의 taskId · 상태 | 클라이언트는 멱등 처리(13.2) |
1 ~ 4행은 요청과 카드를, 5 · 6행은 GetTask 결과를 보면 판정된다. 카드 자체가 바뀌었을 수 있으면 0.3.0 에서 들어온 카드 서명(8.4)을 확인한다 — Habler 외(2025)는 카드 위조를 A2A 위협의 첫 분야로 꼽았다.
8시험 대비
시험에서는 A2A 의 구성과 작업 상태를 쓰는 정의 · 특징형, MCP 와 무엇을 나눠 맡는지 묻는 비교형이 나올 수 있다. 정의형이면 «에이전트 ↔ 에이전트 · 불투명 실행»을 첫 문장에 두고 그림 3 · 5 를, 비교형이면 «MCP = 도구를 여는 규약 · A2A = 동료에게 맡기는 규약»과 부록 B 의 함께 쓰는 구성(원격 에이전트 안의 MCP)을 그린다.
- 개요 — 정의 · 등장(2025-04 공개 · 2025-06 리눅스 재단 · 1.0 = 2026-03) · 불투명 실행 원칙
- 구성 — 그림 3 클라이언트 · Agent Card · 바인딩 셋 · 원격 에이전트 + 요소 표(Task · Message · Part · Artifact)
- 동작 — 그림 4 카드 → 스트리밍 → 되묻기 → 같은 taskId 로 답 → Artifact → 완료
- 작업 상태 — 그림 5 진행 · 중단 · 끝 상태와 referenceTaskIds
- 전달 방식 — 바로 응답 · 폴링 · 스트리밍 · 푸시 비교와 고르는 기준
- MCP 와의 관계 · 보안 — 에이전트 ↔ 도구 / 에이전트 ↔ 에이전트 · 카드 서명 · 웹훅 인증 · 멱등 처리
꼭 쓸 키워드
Agent CardAgentSkillTaskcontextIdArtifactPart불투명 실행INPUT_REQUIREDSSE 스트리밍푸시 알림MCP
다른 답안과 차이를 내는 한 가지는 그림 5 다 — 중단 상태는 같은 작업으로 돌아오는 고리이고 끝 상태에서는 나가는 화살이 없다는 것을 보이면, «되묻기 = 같은 taskId · 후속 일 = 새 작업»이 한 장으로 설명된다.
9오해와 사실
- 오해A2A 는 MCP 를 대신하는 규약이다.사실명세 부록 B 는 MCP 를 에이전트 ↔ 도구 · 자원 연결로, A2A 를 에이전트끼리의 협업으로 나누고, A2A 서버 에이전트가 작업을 하려고 MCP 로 도구를 부르는 함께 쓰는 구성을 든다.
- 오해원격 에이전트의 생각 과정과 도구 목록을 받아야 협업할 수 있다.사실명세 1.2 의 불투명 실행 원칙에 따라 에이전트는 선언한 능력(카드의 skills)과 주고받은 메시지 · Artifact 로만 협업하며, 사례에서도 클라이언트는 원격의 검색 방법을 모른 채 예약 결과를 받았다.
- 오해끝난 작업에도 메시지를 더 보내 이어 갈 수 있다.사실끝 상태 작업은 메시지를 더 받지 않고(3.1.1) 취소도
-32002로 거절되므로, 후속 요청은 새 작업에referenceTaskIds를 달아 보낸다.
10핵심 정리
| 구분 | 만드는 쪽 | 담는 값 | 사례 값 | 대표 오류 | 막는 장치 |
|---|---|---|---|---|---|
| Agent Card | 원격 에이전트 | skills · capabilities · supportedInterfaces · security | 680바이트 · skill 2 | 옛 주소 404 · 위조 | agent-card.json · 카드 서명 |
| Task | 원격 에이전트 | id · contextId · status · history | task-0001 · ctx-0001 | -32001 없는 id | 서버가 만든 id 만 씀 |
| Message | 클라이언트 · 원격 | role · parts · taskId | m-1 · m-2 | taskId 를 비운 답 | 중단 상태는 같은 id 로 |
| Artifact | 원격 에이전트 | artifactId · parts | a-1 · BK-7731 | 형식 불일치 -32005 | acceptedOutputModes 협상 |
| 중단 상태 | 원격 에이전트 | INPUT_ | 후보 H1 · H2 선택 | 답 없이 멈춤 | 사용자에게 묻고 이어 보냄 |
| 끝 상태 | 원격 에이전트 | 완료 · 실패 · 취소 · 거절 | COMPLETED | 취소 -32002 | 새 작업 + referenceTaskIds |
| 전달 방식 | 클라이언트가 고름 | 바로 응답 · 폴링 · SSE · 웹훅 | SSE 이벤트 6개 | 푸시 중복 · SSRF | 웹훅 인증 · 멱등 처리 |
11참고 문헌
- 먼저 볼 문헌
- ★ Agent2Agent (A2A) Protocol Specification (latest · 1.0) — Agent Card · Task · Message · Part · 작업 상태 9개 · 오류 코드 · 전달 방식 셋을 처음 볼 때
- ★ a2aproject/A2A Releases (v0.2.2 · v0.3.0 · v1.0.0 · v1.0.1) — agent.json → agent-card.json · kind 삭제 · ListTasks 같은 판마다 바뀐 점을 볼 때
- ★ Building A Secure Agentic AI Application Leveraging A2A Protocol (Habler et al.) — Agent Card 관리 · 작업 무결성 · 인증 세 분야의 위협 분석을 볼 때
- ★ A survey of agent interoperability protocols: Model Context Protocol (MCP), Agent Communication Protocol (ACP), Agent-to-Agent Protocol (A2A), and Agent Network Protocol (ANP) (Ehtesham et al.) — MCP · ACP · A2A · ANP 네 프로토콜의 쓰임 순서를 견줄 때
- 본문 근거
- Linux Foundation Launches the Agent2Agent Protocol Project to Enable Secure, Intelligent Communication Between AI Agents — Linux Foundation · 2025-06 ·
www.linuxfoundation.org/press/linux-foundation-launches-the-agent2agent-protocol-project-to-enable-secure-intelligent-communication-between-ai-agents· 확인 2026-11-13