AI 에이전트 프로토콜 개발자 가이드

개요

MCP, A2A, UCP, AP2, A2UI, AG-UI 등 6가지 AI 에이전트 프로토콜을 하나의 시나리오로 묶어 각 프로토콜이 해결하는 문제를 실전 코드와 함께 설명하는 가이드 (Reference 참고)

구글의 Agent Development Kit (ADK)를 활용하여 빈 LLM에서 출발,

프로토콜을 하나씩 추가하며, 재고 확인, 견적, 주문, 결제, 대시보드 렌더링까지 완성하는 구조

 

 

 

 

 

MCP (Model Context Protocol) - 도구, 데이터 연결

에이전트를 시스템과 데이터에 연결할 때 발생하는 첫 번째 장벽을 해결하는 프로토콜로,

각 API마다 커스텀 통합 코드를 작성하는 수작업을 제거

 

MCP 서버가 자신의 도구를 광고(advertise)하면 에이전트가 자동으로 디스커버리하는 구조로, 수백 개 서버에 단일 표준 연결 패턴 제공

 

MCP 서버는 해당 시스템을 만든 팀이 유지보수하므로, 에이전트 측에서 통합 코드를 작성하거나 업데이트 할 필요없이 항상 최신 도구 정의를 확보

 

 

 

 

 

A2A (Agent 2 Agent Protocol) - 에이전트 간 통신

MCP가 데이터 접근을 해결한 뒤 남는 전문성(expertise) 문제를 다루는 프로토콜로,

서로 다른 팀, 프레임워크, 서버에서 운영되는 원격 에이전트 간 표준 디스커버리, 통신 방법을 제공

 

각 A2A 에이전트는 `./well-known/agent-card.json`에 Agent Card를 게시해 이름, 능력, 엔드포인트를 공개하며,

키친 매니저 에이전트가 이를 패치해 런타임에 적절한 에이전트로 쿼리 라우팅

 

새로운 원격 에이전트 추가 시 URL만 추가하면 되므로 수동 코드 변경이나 재배포 불필요

 

 

 

 

 

UCP (Universal Commerc Protocol) - 상거래 표준화

공급 업체마다 다른 API를 가진 주문 프로세스를 통합하는 프로토콜로, 쇼핑 라이프 사이클을 모듈형 기능으로 표준화

 

강타입 요청 / 응답 스키마로 일관성을 유지하며, 하위 전송 계층이 REST, MCP, A2A, EP (브라우저 기반 임베디드 프로토콜) 중 어떤 것이든 동일한 패턴으로 동작

 

 

 

 

 

AP2 (Agent Payments Protocol) - 결제 인가, 감사 추적

UCP가 주문 대상과 공급 업체를 처리한다면 AP2는 누가 구매를 승인했는지와 감사 추적을 담당

UCP의 확장 (extension)으로 동작하여, 체크아웃 플로우에 암호화된 인가 증명 추가

 

 

 

 

 

A2UI (Agent to User Interface Protocol) - 동적 UI 구성

에이전트가 일반 텍스트 대신 대시보드, 주문 양식, 공급 업체 비교표 등을 동적으로 구성할 수 있게 하는 프로토콜

18개의 안전한 컴포넌트 프리미티브 (행, 열, 텍스트 필드 등)로 구성된 고정 카탈로그에서 선언적 JSON 형식으로 새로운 레이아웃 조합

 

UI 구조와 데이터를 분리하여, 컴포넌트 재전송 없이 데이터만 업데이트 가능

 

 

 

 

 

AG-UI (Agent-User Interaction Protocol) - 스트리밍 전달

에이전트는 기존 REST API와 달리 텍스트를 점진적으로 스트리밍하고, 응답 중간에 도구를 호출하고 사람의 입력을 기다리며 일시정지 하는 등 복잡한 상호작용 패턴을 가짐

 

AG-UI는 미들웨어로 동작하여 프레임워크 별 원시 이벤트를 표준화된 SSE 스트림으로 변환

프런트엔드는 타입 지정 이벤트만 수신하면 되고, 어떤 에이전트 프레임워크가 생성했는지 알 필요 없음

 

 

 

 

 

프로토콜 활용 팁

각 프로토콜이 해결하는 문제를 정확히 파악해야 아키텍처가 깔끔하게 유지됨

 

첫 날부터 6개 전부 필요하지 않으며, 대부분 MCP로 시작한 뒤 멀티 에이전트 통신, 상거래, 결제, 리치, UI, 스트리밍 등 요구사항 증가에 따라 점진적 추가

 

프로토콜로 빌드하기 전에 ADK 통합, 공식 SDK, 샘플 코드를 먼저 확인하여 직접 재구현하지 않도록 할 것

 

프로토콜들이 아직 성숙 중이지만, 잘 알려진 URL 디스커버리, 타입 지정 스키마, 표준 이벤트 스트림 등의 패턴을 일찍 채택하면 도구, 서비스, 에이전트 생태계와의 호환성 확보

 

 

 

 

 

 

Reference

https://news.hada.io/topic?id=27636

AI 에이전트 프로토콜 개발자 가이드 | GeekNews