google/agents-cli

Gemini Enterprise Agent Platform에서 에이전트를 구축하기 위한 CLI 및 스킬(skills).

시작하기 | 스킬 (Skills) | 명령어 (Commands) | PyPI | 이슈 (Issues) | 문서 (Docs) | 릴리스 노트 (Release Notes) | Star us

여러분이 즐겨 사용하는 코딩 어시스턴트를 Google Cloud에서 에이전트를 구축하고 배포하는 전문가로 변신시키세요.

Agent Platform의 Agents CLI (agents-cli)는 여러분의 코딩 에이전트가 엔터프라이즈급 에이전트를 구축, 확장, 거버넌스 및 최적화할 수 있는 스킬과 명령어를 제공합니다. 따라서 여러분이 모든 CLI와 서비스를 직접 학습할 필요가 없습니다.

다음과 완벽하게 연동됩니다:
Gemini CLI • Claude Code • Codex • Antigravity • 그리고 그 외 모든 코딩 에이전트.

사전 요구 사항: Python 3.11 이상, uv, 그리고 Node.js.

uvx google-agents-cli setup

또는 스킬만 추가하세요 — 나머지는 코딩 에이전트가 처리합니다

npx skills add google/agents-cli

Gemini CLI, Claude Code, Codex 또는 선호하는 코딩 에이전트를 실행하세요.

코딩 에이전트에게 무언가를 만들어 달라고 요청하세요 — 예: "agents-cli를 사용하여 장황한 텍스트를 간결하고 기술적인 신음 소리로 압축하는 원시인 스타일의 에이전트를 만들어줘"

단계별 안내를 보려면 전체 튜토리얼을 확인하세요.

스킬 (Skill)	코딩 에이전트가 배우는 내용
google-agents-cli-workflow	개발 라이프사이클 (Development lifecycle), 코드 보존 규칙, 모델 선택
google-agents-cli-adk-code	ADK Python API — 에이전트 (agents), 도구 (tools), 오케스트레이션 (orchestration), 콜백 (callbacks), 상태 (state)
google-agents-cli-scaffold	프로젝트 스캐폴딩 (Project scaffolding) — create, enhance, upgrade
google-agents-cli-eval	평가 방법론 (Evaluation methodology) — 지표 (metrics), 평가 세트 (evalsets), LLM-as-judge, 궤적 점수 산정 (trajectory scoring)
google-agents-cli-deploy	배포 (Deployment) — Agent Runtime, Cloud Run, GKE, CI/CD, 비밀 정보 (secrets)
google-agents-cli-publish	Gemini Enterprise 등록
google-agents-cli-observability	관측 가능성 (Observability) — Cloud Trace, 로깅 (logging), 제3자 통합 (third-party integrations)

명령 (Command)	기능 (What it does)
agents-cli setup	CLI 및 코딩 에이전트 (coding agents)용 스킬 (skills) 설치
agents-cli scaffold <name>	새로운 에이전트 프로젝트 생성
agents-cli eval run	에이전트 평가 (evaluations) 실행
agents-cli deploy	Google Cloud에 배포
agents-cli publish gemini-enterprise	Gemini Enterprise에 등록

모든 명령 보기

명령 (Command)	설명 (Description)
agents-cli login	Google Cloud 또는 AI Studio로 인증
agents-cli login --status	인증 상태 표시
Scaffold (스캐폴딩)
agents-cli scaffold <name>	새로운 에이전트 프로젝트 생성
agents-cli scaffold enhance	기존 프로젝트에 배포 (deployment), CI/CD, 또는 RAG 추가
agents-cli scaffold upgrade	프로젝트를 최신 agents-cli 버전으로 업그레이드
Develop (개발)
agents-cli run "prompt"	단일 프롬프트 (prompt)로 에이전트 실행
agents-cli install	프로젝트 의존성 (dependencies) 설치
agents-cli lint	코드 품질 검사 (Ruff) 실행
Evaluate (평가)
agents-cli eval run	에이전트 평가 (evaluations) 실행
agents-cli eval compare	두 개의 평가 결과 파일 비교
Deploy & Publish (배포 및 게시)
agents-cli deploy	Google Cloud에 배포
agents-cli publish gemini-enterprise	Gemini Enterprise에 등록
agents-cli infra single-project	단일 프로젝트 인프라 (infrastructure) 프로비저닝
agents-cli infra cicd	CI/CD 파이프라인 + 스테이징/운영 (staging/prod) 인프라 설정
Data (데이터)
agents-cli infra datastore	RAG를 위한 데이터스토어 (datastore) 인프라 프로비저닝
agents-cli data-ingestion	데이터 수집 (data ingestion) 파이프라인 실행
Other (기타)
agents-cli info	프로젝트 설정 및 CLI 버전 표시
agents-cli update	모든 IDE에 스킬 (skills) 강제 재설치

agents-cli가 기반으로 구축하는 Google Cloud 에이전트 스택:

이것이 Gemini CLI, Claude Code, 또는 Codex의 대안인가요?

아니요. agents-cli는 코딩 에이전트(coding agent)를 위한 도구이지, 코딩 에이전트 그 자체는 아닙니다. 이 도구는 여러분의 코딩 에이전트가 Google Cloud에서 ADK 에이전트를 더 잘 구축, 평가 및 배포할 수 있도록 CLI 명령과 스킬 (skills)을 제공합니다.

ADK를 직접 사용하는 것과 무엇이 다른가요?

ADK는 에이전트 프레임워크 (agent framework)입니다.

agents-cli는

여러분의 코딩 에이전트 (coding agent)가 ADK 에이전트를 엔드투엔드 (end-to-end)로 구축, 평가 및 배포할 수 있는 스킬 (skills)과 도구 (tools)를 제공합니다.

Google Cloud가 필요한가요?

로컬 개발 (create, run, eval)을 위해서는 필요하지 않습니다. AI Studio API 키를 사용하여 로컬에서 ADK와 함께 Gemini를 실행할 수 있습니다. 배포 및 클라우드 기능을 위해서는 필요합니다.

기존 에이전트 프로젝트에 사용할 수 있나요?

네. agents-cli scaffold enhance를 사용하면 기존 프로젝트에 배포 및 CI/CD를 추가할 수 있습니다.

코딩 에이전트 없이 agents-cli를 사용할 수 있나요?

네. CLI는 단독으로 작동합니다. agents-cli scaffold, eval, deploy 및 기타 모든 명령을 터미널에서 직접 실행할 수 있습니다. 스킬 (skills)은 코딩 에이전트가 여러분을 대신해 이 작업을 더 쉽게 수행할 수 있도록 도와줄 뿐입니다.

다른 스킬로 agents-cli를 확장할 수 있나요?

agents-cli 스킬은 에이전트 구축 라이프사이클 (scaffold, ADK 코드 패턴, 평가 (evals), 배포 (deploy), 게시 (publish), 관찰성 (observability))을 다룹니다. 인접한 관심 분야의 경우, 다른 스킬 제품군을 함께 설치할 수 있습니다. 예를 들어, agent-skills는 일반적인 소프트웨어 엔지니어링 워크플로 (아이디어 구상, 사양 게이트 (spec gates), 계획, 코드 리뷰)를 다루며, google/skills는 Google Cloud 기초 (BigQuery, Cloud Run, Firebase, GKE)를 다룹니다.

저희는 여러분의 의견을 소중히 여깁니다. 이는 커뮤니티를 위해 agents-cli를 개선하는 데 도움이 됩니다.

버그 및 기능 요청: 이슈 (issue)를 오픈해 주세요 — 우선순위를 두길 원하는 이슈에는 👍를 눌러주세요.
구축한 것을 공유해 주세요: 여러분의 프로젝트에 대해 듣고 싶습니다! 에이전트를 공유하거나 피드백을 제공하려면 agents-cli@google.com으로 연락해 주세요.

기여하는 가장 좋은 방법은 피드백을 통한 것입니다. 버그 보고, 기능 요청, 그리고 이슈를 통해 공유된 아이디어는 우리의 로드맵 (roadmap)을 직접적으로 형성합니다. CLI는 저장소의 소스 코드가 아닌 빌드된 휠 (wheel) 형태로 배포되는데, 이를 통해 공개 인터페이스 (public interface)를 안정적으로 유지하면서도 빠르게 반복 개선할 수 있습니다. 코드는 난독화 (obfuscated)되지 않았습니다. .whl 파일 (표준 zip 아카이브)을 추출하여 어떤 릴리스든 검사할 수 있습니다.

자세한 내용은 기여 가이드 (contributing guide)를 참조하세요.

agents-cli는 Google Cloud API를 활용합니다. 에이전트 (agents)를 배포할 때, 귀하의 Google Cloud 프로젝트 내에 리소스 (resources)가 배포되며 해당 리소스에 대한 책임은 귀하에게 있습니다. 자세한 내용은 Google Cloud 서비스 약관 (Google Cloud Service Terms)을 검토하시기 바랍니다.

이 기능은 서비스별 약관 (Service Specific Terms)의 일반 서비스 약관 (General Service Terms) 섹션에 있는 "Pre-GA 제공 약관 (Pre-GA Offerings Terms)"의 적용을 받습니다. Pre-GA 기능은 "있는 그대로 (as is)" 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명 (launch stage descriptions)을 참조하세요.