AI Briefing

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가 자동으로 만들었습니다. 원문의 주장과 맥락은 원문에서 확인해 주세요. 저작권은 원저작자에게 있습니다.

AI 처리 방식을 확인하거나, 요약 오류와 출처 표기 문제, 삭제 요청을 문의 · 건의로 알려주세요.