google/agents-cli
The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploying AI agents on Google Cloud.
agents‑cli란?
agents‑cli는 Google의 Gemini 플랫폼에서 실행되는 AI 에이전트를 빌드, 테스트, 배포하는 데 도움이 되는 명령줄 도구(및 AI 기반 코딩 어시스턴트에 추가할 수 있는 "스킬" 세트)입니다. 하위 수준의 Agent Development Kit (ADK) 및 Google Cloud 서비스를 래핑하므로 여러 개별 CLI를 수동으로 연결할 필요가 없습니다.
대상 사용자
- 개발자: "에이전트" 애플리케이션(도구를 호출하고 상태를 유지할 수 있는 LLM 기반 봇)을 만들고 Google Cloud에서 실행하려는 경우.
- 코딩 어시스턴트: Antigravity CLI, Claude Code, OpenAI Codex 등. 이 도구는 스킬로 설치할 수 있어 해당 어시스턴트가 올바른 명령을 대신 실행할 수 있습니다.
- 에이전트 프로젝트(스캐폴딩, 평가, 배포, 관찰 가능성)에 대해 반복 가능하고 CI/CD 준비가 된 워크플로가 필요한 팀.
핵심 기능(README 설명 기준)
| 영역 | 제공 기능 |
|---|---|
| 스캐폴딩 | agents-cli create <name>은 ADK 호환 레이아웃으로 새 프로젝트를 생성합니다. scaffold enhance는 기존 리포지토리에 배포 또는 CI/CD를 추가하고, upgrade는 프로젝트를 최신 CLI 버전으로 업그레이드합니다. |
| 개발 헬퍼 | run "prompt"는 에이전트를 로컬에서 호출하고, install은 종속성을 해결하며, lint는 코드 품질을 위해 Ruff를 실행합니다. |
| 평가 스위트 | agents-cli eval … 아래의 명령으로 추론 트레이스 생성, 내장 메트릭으로 평가, 다중 턴 시나리오 합성, 실행 비교, 실패 모드 클러스터링, 프롬프트 자동 튜닝(optimize)이 가능합니다. |
| 배포 및 게시 | deploy는 에이전트를 Google Cloud(Cloud Run, GKE 또는 Gemini 관리 런타임)에 푸시합니다. publish gemini는 Gemini 플랫폼에 에이전트를 등록합니다. 인프라 헬퍼(infra single-project, infra cicd)는 필요한 Google Cloud 리소스를 설정합니다. |
| 관찰 가능성 | Cloud Trace, Cloud Logging 및 타사 모니터링과의 통합은 observability 스킬을 통해 내장되어 있습니다. |
| 인증 | agents-cli login은 Google Cloud 또는 AI Studio로 인증합니다. login --status는 현재 토큰을 표시합니다. |
| 원격 측정 제어 | 기본적으로 최소 사용 로그가 자신의 Google Cloud 프로젝트로 전송됩니다. AGENTS_CLI_TELEMETRY=0 또는 DO_NOT_TRACK=1로 비활성화할 수 있습니다. |
내부 작동 방식
- ADK Python API – CLI는 Agent Development Kit을 사용하는 코드를 생성합니다. 이 키트는 에이전트, 도구, 콜백 및 상태 처리를 정의합니다.
- Gemini 플랫폼 –
deploy또는publish시 CLI는 Gemini에서 Agent Runtime을 프로비저닝하거나 표준 Cloud Run / GKE 서비스를 프로비저닝하여 IAM, 시크릿 및 CI/CD 파이프라인을 처리합니다. - 평가 프레임워크 – 내장 데이터 세트 형식과 "LLM-as-judge" 평가 시스템을 통해 품질(예: 정확성, 관련성)을 측정하고 결과를 프롬프트 최적화에 피드백할 수 있습니다.
- 스킬 레이어 – 동일한 명령이 스킬로 노출되어 외부 코딩 에이전트에 설치할 수 있습니다(
npx skills add google/agents-cli사용). 해당 에이전트는 사용자를 대신하여 CLI 명령을 실행할 수 있습니다.
시작하기(빠른 요약)
- 사전 요구 사항 – Python 3.11+,
uv(빠른 Python 패키지 관리자), Node.js. - 설치 –
uvx google-agents-cli setup(또는npx skills add google/agents-cli로 코딩 에이전트에 스킬 추가). - 프로젝트 생성 –
agents-cli create my‑agent. - 반복 – 프롬프트 실행, lint, 로컬 평가.
- 배포 –
agents-cli deploy로 Google Cloud에 푸시한 다음agents-cli publish gemini로 등록.
중요성
- 엔드투엔드 워크플로 – ADK, Cloud Run, GKE 및 로깅 설정을 수동으로 결합할 필요가 없습니다.
- 에이전트 중심 평가 – 다중 턴 테스트 및 프롬프트 튜닝을 위한 즉시 사용 가능한 프레임워크를 제공합니다. 이는 일반 LLM 툴킷에는 종종 누락되어 있습니다.
- 코딩 어시스턴트와의 통합 – 스킬 모델을 통해 AI 기반 IDE 헬퍼가 에이전트 프로젝트의 "운영자"가 되어 개발자 경험을 간소화할 수 있습니다.
자세히 알아보기
- 전체 문서 사이트: https://google.github.io/agents-cli/
- 빠른 시작 튜토리얼: https://google.github.io/agents-cli/guide/quickstart-tutorial/
- 릴리스 노트, 이슈 트래커 및 PyPI 패키지는 README에 링크되어 있습니다.
위의 모든 정보는 리포지토리의 README에서 직접 가져온 것이며 추가 기능은 가정되지 않았습니다.
관련
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트
- 프로젝트