Gemini 엔터프라이즈 에이전트 개발: agents-cli로 코딩 에이전트 역량 강화 전략 (2026년 최신 가이드)
2026년, 인공지능 기술은 더 이상 선택이 아닌 필수가 되었습니다. 특히 기업 환경에서는 복잡한 요구사항을 충족하는 엔터프라이즈급 AI 에이전트 개발에 대한 수요가 폭발적으로 증가하고 있습니다. 하지만 수많은 클라우드 서비스와 CLI 도구들을 익히는 것은 개발자에게 큰 부담으로 작용합니다. 이러한 난관을 해결하고 개발 생산성을 혁신적으로 끌어올릴 수 있는 강력한 도구가 바로 agents-cli입니다.
agents-cli는 Gemini 엔터프라이즈 에이전트 플랫폼에서 에이전트를 구축하고 배포하는 데 필요한 CLI 명령어와 핵심 스킬을 제공합니다. 이 도구는 여러분이 이미 사용하고 있는 코딩 에이전트(예: Gemini CLI, Claude Code, Codex)의 역량을 비약적으로 강화하여, 구글 클라우드 환경에서 엔터프라이즈급 에이전트를 손쉽게 개발, 확장, 관리, 최적화할 수 있도록 돕습니다. 이제 복잡한 과정을 일일이 학습할 필요 없이, agents-cli가 제공하는 통합된 환경에서 오직 에이전트 개발에만 집중할 수 있게 됩니다.
agents-cli란 무엇인가?
출처: github.com
agents-cli는 단순히 명령줄 인터페이스를 넘어, 코딩 에이전트가 구글 클라우드 기반의 ADK(Agent Development Kit) 에이전트를 개발하는 데 필요한 지식과 도구를 통합적으로 제공하는 솔루션입니다. 이는 코딩 에이전트의 '두뇌'에 전문적인 스킬셋을 추가하여, 마치 숙련된 AI 전문가처럼 복잡한 개발 작업을 수행할 수 있도록 만듭니다.
핵심 가치: agents-cli는 개발자가 개별 CLI 및 서비스를 모두 학습하는 부담 없이, 코딩 에이전트를 활용하여 엔터프라이즈급 에이전트를 구축하고 배포할 수 있도록 지원합니다. 이는 2026년 AI 개발의 생산성을 한 단계 끌어올리는 중요한 도구로 평가받고 있습니다.
agents-cli의 핵심 스킬 및 기능
agents-cli는 코딩 에이전트에게 다음과 같은 다양한 핵심 스킬을 부여하여, 에이전트 개발 전반의 효율성을 극대화합니다. 각 스킬은 특정 개발 영역에 대한 깊이 있는 지식과 도구를 포함하고 있습니다.
| 스킬명 | 코딩 에이전트가 학습하는 내용 |
|---|---|
google-agents-cli-workflow |
개발 수명 주기, 코드 보존 규칙, 모델 선택 전략 |
google-agents-cli-adk-code |
ADK Python API (에이전트, 도구, 오케스트레이션, 콜백, 상태 관리) |
google-agents-cli-scaffold |
프로젝트 스캐폴딩 (생성, 향상, 업그레이드) |
google-agents-cli-eval |
평가 방법론 (메트릭, 평가 세트, 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 명령어 상세 분석
agents-cli는 개발자가 직접 터미널에서 실행하거나, 코딩 에이전트가 활용할 수 있는 강력하고 직관적인 명령어 세트를 제공합니다. 다음은 주요 명령어와 그 기능에 대한 설명입니다.
| 명령어 | 설명 | 주요 용도 |
|---|---|---|
agents-cli setup |
CLI 및 스킬을 코딩 에이전트에 설치합니다. | 초기 환경 설정 |
agents-cli login |
Google Cloud 또는 AI Studio에 인증합니다. | 클라우드 리소스 접근 |
agents-cli scaffold <name> |
새로운 에이전트 프로젝트를 생성합니다. | 새 프로젝트 시작 |
agents-cli scaffold enhance |
기존 프로젝트에 배포, CI/CD, RAG 기능을 추가합니다. | 기존 프로젝트 확장 |
agents-cli scaffold upgrade |
프로젝트를 최신 agents-cli 버전으로 업그레이드합니다. | 버전 관리 |
agents-cli run "prompt" |
단일 프롬프트로 에이전트를 실행합니다. | 로컬 개발 및 테스트 |
agents-cli install |
프로젝트 종속성을 설치합니다. | 개발 환경 준비 |
agents-cli lint |
코드 품질 검사(Ruff)를 실행합니다. | 코드 품질 관리 |
agents-cli eval run |
에이전트 평가를 실행합니다. | 에이전트 성능 검증 |
agents-cli eval compare |
두 평가 결과 파일을 비교합니다. | 성능 비교 분석 |
agents-cli deploy |
Google Cloud에 에이전트를 배포합니다. | 클라우드 환경 배포 |
agents-cli publish gemini-enterprise |
Gemini Enterprise에 등록합니다. | 엔터프라이즈 등록 |
agents-cli infra single-project |
단일 프로젝트 인프라를 프로비저닝합니다. | 기본 인프라 설정 |
agents-cli infra cicd |
CI/CD 파이프라인 및 스테이징/프로덕션 인프라를 설정합니다. | 자동화된 배포 시스템 구축 |
agents-cli infra datastore |
RAG(검색 증강 생성)를 위한 데이터스토어 인프라를 프로비저닝합니다. | RAG 기반 에이전트 지원 |
agents-cli data-ingestion |
데이터 수집 파이프라인을 실행합니다. | 데이터 준비 |
agents-cli info |
프로젝트 설정 및 CLI 버전을 표시합니다. | 정보 확인 |
agents-cli update |
모든 IDE에 스킬을 강제로 재설치합니다. | 스킬 업데이트 |
agents-cli 시작하기: 필수 전제 조건 및 설치
agents-cli를 활용하기 위해서는 몇 가지 전제 조건이 충족되어야 합니다. 또한, 설치 과정은 매우 간단하며, 코딩 에이전트와 연동하여 더욱 강력한 개발 환경을 구축할 수 있습니다.
전제 조건
- Python: 3.11 이상 버전
- uv: Python 패키지 설치 및 관리 도구
- Node.js: JavaScript 런타임 환경 (npx 사용을 위해 필요)
설치 방법
agents-cli와 관련 스킬을 설치하는 방법은 두 가지가 있습니다. 전체 CLI와 스킬을 한 번에 설치하거나, 필요한 스킬만 추가할 수 있습니다. 아래 코드를 실행하면 agents-cli를 설치할 수 있습니다.
uvx google-agents-cli setup만약 코딩 에이전트가 나머지 부분을 처리하도록 하고, 스킬만 추가하려면 다음 명령어를 사용합니다.
npx skills add google/agents-cli첫 번째 에이전트 구축 예시
- 코딩 에이전트 실행: Gemini CLI, Claude Code, Codex 등 선호하는 코딩 에이전트를 실행합니다.
- 에이전트 구축 요청: 코딩 에이전트에게 agents-cli를 사용하여 에이전트를 구축하도록 요청합니다. 예를 들어, 다음과 같은 프롬프트를 사용할 수 있습니다.
아래 프롬프트를 코딩 에이전트에 입력하여 첫 에이전트를 생성해보세요.
"Use agents-cli to build a caveman-style agent that compresses verbose text into terse, technical grunts"agents-cli 아키텍처 및 Google Cloud 연동
agents-cli는 Google Cloud의 강력한 에이전트 스택을 기반으로 구축됩니다. 이는 에이전트의 개발부터 배포, 운영에 이르는 전 과정에서 Google Cloud의 안정적이고 확장 가능한 인프라를 활용함을 의미합니다. 로컬 개발 단계에서는 AI Studio API 키를 사용하여 Gemini와 ADK를 로컬에서 실행할 수 있지만, 실제 배포 및 클라우드 기능을 활용하려면 Google Cloud 프로젝트가 필수적입니다.
agents-cli는 다음과 같은 질문에 대한 명확한 답변을 제공하며, 개발자들이 가질 수 있는 오해를 해소합니다.
자주 묻는 질문 (FAQ)
- Gemini CLI, Claude Code, Codex의 대체재인가요?아닙니다. agents-cli는 코딩 에이전트 자체가 아니라, 코딩 에이전트를 위한 도구입니다. 이는 코딩 에이전트가 Google Cloud에서 ADK 에이전트를 구축, 평가, 배포하는 능력을 향상시키는 CLI 명령어와 스킬을 제공합니다.
adk를 직접 사용하는 것과 어떻게 다른가요?adk는 에이전트 프레임워크입니다. agents-cli는 코딩 에이전트에게adk에이전트를 엔드투엔드로 구축, 평가, 배포할 수 있는 스킬과 도구를 제공합니다. 즉,adk를 더 효율적으로 활용할 수 있도록 돕는 상위 개념의 도구입니다.- Google Cloud가 필요한가요?로컬 개발(생성, 실행, 평가)의 경우, AI Studio API 키를 사용하여
ADK와 Gemini를 로컬에서 실행할 수 있으므로 Google Cloud가 필수는 아닙니다. 하지만 배포 및 클라우드 기능을 사용하려면 Google Cloud가 필요합니다. - 기존 에이전트 프로젝트와 함께 사용할 수 있나요?네, 가능합니다.
agents-cli scaffold enhance명령어를 사용하여 기존 프로젝트에 배포 및 CI/CD 기능을 추가할 수 있습니다. - 코딩 에이전트 없이 agents-cli를 사용할 수 있나요?네, 가능합니다. CLI는 독립적으로 작동하며,
agents-cli scaffold,eval,deploy등 모든 명령어를 터미널에서 직접 실행할 수 있습니다. 스킬은 단지 코딩 에이전트가 이러한 작업을 더 쉽게 수행하도록 돕는 역할을 합니다.
2026년, 엔터프라이즈 AI 에이전트 개발의 미래
agents-cli는 2026년 기업들이 AI 에이전트 개발을 가속화하고, 복잡한 클라우드 환경에서 효율적으로 운영할 수 있도록 설계된 핵심 도구입니다. 개발 수명 주기 관리, 고급 평가 방법론, 다양한 배포 옵션, 그리고 통합된 옵저버빌리티까지, 엔터프라이즈급 요구사항을 충족하는 모든 기능을 제공합니다.
이 도구를 통해 개발팀은 더 적은 노력으로 더 강력하고 안정적인 AI 에이전트를 구축할 수 있으며, 이는 결과적으로 기업의 디지털 전환과 혁신에 크게 기여할 것입니다. agents-cli는 아직 Preview 단계의 기능이며, 구글 클라우드 서비스 약관 및 Pre-GA 오퍼링 약관이 적용됩니다. 지속적인 피드백과 기여를 통해 더욱 발전할 것으로 기대됩니다.
지금 바로 agents-cli를 도입하여 여러분의 코딩 에이전트를 진정한 엔터프라이즈 AI 개발 전문가로 변모시키고, 2026년의 AI 혁신을 선도하시길 바랍니다.
출처: github.com
출처: github.com
참고 GitHub 저장소
google/agents-cli
댓글