A2A Protocol이 1.0이 되면서 바뀐 것들, 그리고 0.3 구현체를 옮기려면

Context

A2A Protocol 0.3은 proto 파일이 정규 스펙이 아니었고 단일 바인딩만 지원했다. Part 구조에서 kind 판별자를 사용해 타입을 결정하는 방식이 있었다. AgentCard가 하나의 버전과 바인딩만 광고할 수 있었다.

Technical Solution

• Proto 파일을 정규 스펙으로 격상: 표준화된 인터페이스 정의 가능
• gRPC, HTTP, JSON-RPC 멀티 바인딩 지원: 동일 프로토콜에서 여러 통신 방식 동시 구현
• Part 구조 통합 및 필드 존재 여부로 타입 결정: kind 판별자 제거로 구조 단순화
• supportedInterfaces[] 배열을 AgentCard에 도입: 여러 버전과 바인딩 동시 광고
• Enum을 SCREAMING_SNAKE_CASE로 통일: 네이밍 규칙 표준화
• 스트리밍 이벤트 래퍼 구조 변경: 이벤트 처리 방식 개선
• 0.3 기반 구현체를 위한 6단계 마이그레이션 체크리스트 제공: 단계적 이전 전략 수립

Key Takeaway

주요 설계 변경은 필드 존재 여부 기반 타입 판별과 supportedInterfaces 배열 도입으로 타입 시스템 유연성을 높였다. SDK 미출시 상태에서의 마이그레이션 체크리스트 제공으로 사용자의 이전 경로 명확성을 확보했다.