Google Agents CLI — 코딩 에이전트를 에이전트 빌더로 만드는 메타 도구

Google이 Cloud Next에서 공개한 agents-cli는 Gemini CLI, Claude Code, Codex 같은 코딩 에이전트에게 Google Cloud 기반 AI 에이전트를 설계하고 배포하는 전문 역량을 주입하는 CLI 도구다.

핵심 개념: 메타 에이전트 레이어

에이전트 그 자체가 아니라, 에이전트를 만드는 에이전트의 실력을 끌어올리는 레이어에 해당한다. Google의 ADK(Agent Development Kit)를 기반으로 하며, 프로젝트 생성부터 평가, 배포, 엔터프라이즈 등록까지 에이전트 개발의 전체 생명주기를 하나의 CLI로 다룬다.

이 도구가 겨냥하는 지점은 SDK 코드 작성이 아니다. 수십 가지 컴포넌트 중 어떤 것을, 어떤 순서로, 어떤 설정으로 조합해야 하는지 판단하는 일이 실제 병목이라는 인식에서 출발한다.

설치 및 요구사항

uvx google-agents-cli setup

• Python 3.11 이상
• uv (Python 패키지 매니저)
• Node.js

7종 스킬 주입 방식

코딩 에이전트에 7종의 “스킬”을 주입하는 방식으로 동작한다:

스킬	역할
워크플로우 설계	에이전트 작업 흐름 설계
ADK 코드 작성	Agent Development Kit 코드 생성
프로젝트 스캐폴딩	프로젝트 뼈대 자동 생성
평가	LLM-as-judge 방식 포함
배포	Agent Runtime, Cloud Run, GKE
Gemini Enterprise 퍼블리싱	모델 배포 채널
관측성 (Observability)	로그와 트레이스로 시스템 상태 파악

도구 연결 (Tool Wiring)

• MCP (Model Context Protocol) — 모델이 외부 도구를 호출하는 표준
• A2A (Agent-to-Agent) — 에이전트 간 통신 프로토콜
• 커넥터 지원

주요 특징

플랫폼 비종속성

특정 코딩 에이전트에 종속되지 않는다. Gemini CLI, Claude Code, Codex 어디든 스킬만 주입하면 동작하므로 개발자의 도구 선택권을 침해하지 않는다.

Discovery-First 설계

“무엇을 했는지”뿐 아니라 “왜 그렇게 결정했는지”를 코딩 에이전트가 함께 설명하도록 설계되어, 팀원의 플랫폼 이해도도 함께 올라가는 구조를 지향한다.

문서 수렴

MCP 문서, ADK 문서, gcloud 문서, Runtime 문서 등 네 곳 이상에 흩어진 정보를 하나의 도구로 수렴시킨다.

기존 프로젝트 확장

scaffold enhance 명령으로 기존 에이전트 프로젝트에 배포 설정과 CI/CD 파이프라인을 사후 추가할 수 있다.

한계 및 주의사항

• Pre-GA 단계 — 정식 출시 전이므로 프로덕션 도입 시 주의 필요
• .whl 파일 배포만 — 사전 빌드된 Python 패키지로만 배포되어 오픈소스 커뮤니티의 직접적인 코드 기여 제한
• Google Cloud 의존도 — 멀티클라우드나 비-Google 스택 환경에서는 적용 범위 제한적
• 단일 도구 의존 리스크 — 여러 문서를 하나의 도구로 수렴시키는 만큼 의존도가 높아질 수 있음

moc-ai-agents-orchestration와의 관계

이 도구는 moc-ai-agents-orchestration의 핵심 과제인 “에이전트 조합의 병목 해소”를 직접적으로 해결하는 도구로 볼 수 있다. 코딩 에이전트에게 숙련된 플랫폼 엔지니어 수준의 판단을 내재화함으로써, 조합 추측의 불확실성을 줄인다.