Google Agents CLI – AI 코딩 에이전트를 Google Cloud 에이전트 빌더로 변환하는 CLI·스킬셋

무엇이 다른가
스킬 목록
설치
주요 CLI 명령어
누가 사용하면 좋은가
관련 문서
참고 자료

Google Agents CLI(agents-cli)는 Gemini CLI, Claude Code, Codex 같은 코딩 에이전트에 Google Cloud 전문 스킬을 주입해 ADK 에이전트를 스캐폴딩·평가·배포하는 공식 CLI 도구다. Google Cloud의 Gemini Enterprise Agent Platform을 직접 다루지 않아도, 코딩 에이전트가 CLI 명령어와 스킬을 통해 엔드투엔드 에이전트 개발 파이프라인을 대신 처리해 준다.

무엇이 다른가

agents-cli는 코딩 에이전트를 위한 도구이지, 코딩 에이전트 자체가 아니다. ADK(Agent Development Kit)가 에이전트 프레임워크라면, agents-cli는 코딩 에이전트에게 ADK 에이전트를 만들고·평가하고·배포하는 능력을 부여하는 레이어다.

구분	역할
Gemini CLI / Claude Code / Codex	코딩 에이전트 (자연어 → 코드)
ADK	에이전트 런타임 프레임워크
agents-cli	코딩 에이전트에게 ADK·Cloud 전문 스킬 제공

스킬 목록

agents-cli가 코딩 에이전트에 주입하는 7가지 전문 스킬:

스킬	역할
`google-agents-cli-workflow`	개발 라이프사이클, 코드 보존 규칙, 모델 선택
`google-agents-cli-adk-code`	ADK Python API — 에이전트·도구·오케스트레이션·콜백·상태
`google-agents-cli-scaffold`	프로젝트 스캐폴딩 — `create`, `enhance`, `upgrade`
`google-agents-cli-eval`	평가 방법론 — 메트릭, evalset, LLM-as-judge, 궤적 채점
`google-agents-cli-deploy`	배포 — Agent Runtime, Cloud Run, GKE, CI/CD, 시크릿
`google-agents-cli-publish`	Gemini Enterprise 등록
`google-agents-cli-observability`	관측 — Cloud Trace, 로깅, 서드파티 연동

설치

# CLI + 스킬 전체 설치
uvx google-agents-cli setup

# 스킬만 설치 (CLI는 코딩 에이전트가 처리)
npx skills add google/agents-cli

사전 요건: Python 3.11+, uv, Node.js

로컬 개발(스캐폴딩·실행·평가)은 Google Cloud 없이 AI Studio API 키만으로 가능하다. 배포와 클라우드 기능은 Google Cloud 프로젝트가 필요하다.

주요 CLI 명령어

agents-cli setup                        # CLI + 스킬 설치
agents-cli scaffold <name>              # 새 에이전트 프로젝트 생성
agents-cli scaffold enhance             # 기존 프로젝트에 배포·CI/CD·RAG 추가
agents-cli run "prompt"                 # 단일 프롬프트로 에이전트 실행
agents-cli eval run                     # 에이전트 평가 실행
agents-cli eval compare                 # 두 평가 결과 비교
agents-cli deploy                       # Google Cloud 배포
agents-cli publish gemini-enterprise    # Gemini Enterprise 등록
agents-cli infra cicd                   # CI/CD 파이프라인 + staging/prod 인프라 구성

누가 사용하면 좋은가

Google Cloud에서 에이전트를 프로덕션 수준으로 운용하려는 팀: 스캐폴딩부터 CI/CD·모니터링까지 파이프라인 전체를 코딩 에이전트에게 위임할 수 있다.
ADK를 처음 도입하는 개발자: CLI 명령어와 스킬이 ADK 세부 사항을 추상화해 학습 비용을 낮춘다.
Claude Code·Codex·Gemini CLI 사용자: 기존 코딩 에이전트에 Google Cloud 전문 지식을 바로 추가할 수 있다.

참고 자료

google/agents-cli — GitHub 공식 저장소
공식 문서
PyPI

Like?

AI Sparkup