A2A, 공식 CLI 도구 공개
[A2A 알아보기 3편] A2A CLI: 클라이언트 코드 없이, 터미널에서 A2A 에이전트를 호출하고 띄우는 공식 명령줄 도구
·2026.09.14 15:30
핵심 내용
A2A 프로토콜용 공식 CLI가 공개되어 터미널에서 에이전트 호출, 서버 실행 및 관리가 가능해졌다.
1 / 2
자세히 보기
A2A 프로젝트가 A2A 프로토콜용 공식 명령줄 도구(CLI)를 공개했다. 이 도구는 기존 언어별 SDK나 커뮤니티 CLI의 비일관성을 해결하기 위해 개발되었으며, 현재 v0.2.0 릴리스 단계에 있다.
주요 기능 및 사용법
- 에이전트 호출:
send명령으로 동기 대기 또는--stream옵션을 통해 실시간 스트리밍으로 메시지를 전송할 수 있다.--async를 사용하면 비동기 실행 후task get --wait으로 상태를 추적할 수 있다. - 서버 모드:
server명령을 통해 Echo(메시지 반사), Proxy(요청 전달 및 로깅), Exec(표준 입출력 기반 에이전트화) 등 3가지 모드의 A2A 서버를 실행할 수 있다. - 출력 및 인증: 텍스트, JSON, JSONL 형식 출력을 지원하며, 자격 증명은
.env파일이나 환경 변수로 관리한다.
주의사항 및 제한
- 종료 코드: CLI의 종료 코드는 작업의 기술적 성공 여부만 나타내며, 태스크의 비즈니스 로직 실패(FAILED, REJECTED 등)는 종료 코드 0으로 반환될 수 있으므로 출력 상태를 직접 확인해야 한다.
- 운영 부적합: 현재 프로젝트는 알파 단계이며 명세가 비준 전 상태이므로, 운영 환경보다는 개발, 디버깅, 자동화 테스트 용도로 사용하는 것이 권장된다.
- 라이선스: Apache License 2.0으로 개인 및 상업적 사용이 가능하다.
이 한국어 요약은 AI가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.