
agents-cli
Google · 코딩
agents-cli는 기존 코딩 어시스턴트에게 AI 에이전트를 처음부터 끝까지 구축하는 법을 가르치는 Google의 명령줄 도구다. Google Cloud의 각 서비스를 손으로 익히는 대신, CLI와 여러 스킬을 설치한 뒤 코딩 에이전트에게 ADK 기반 에이전트의 골격 생성, 실행, 평가, 배포, 게시를 요청하면 된다. Antigravity CLI, Claude Code, Codex는 물론 이미 쓰고 있는 다른 코딩 에이전트와도 함께 동작한다.

agents-cli 소개
agents-cli란
agents-cli는 Google Cloud에서 AI 에이전트를 구축하기 위한 Google의 오픈소스 Google Cloud AI 에이전트 CLI다. 명령줄 도구와 설치 가능한 스킬 묶음을 함께 제공하며, 이것들이 코딩 어시스턴트에 연결된다. 그래서 어시스턴트는 개발 수명주기, ADK의 Python API, 골격 생성 규칙, 평가 방법, 배포 대상을 미리 외우지 않아도 파악한다.
이 도구가 푸는 핵심 문제는 흩어짐이다. Google Cloud에서 에이전트를 만들려면 보통 여러 서비스를 건드려야 하고, 각각 고유한 CLI와 설정을 가진다. 이 AI 에이전트 배포 도구는 그것을 하나의 흐름으로 묶는다. 코딩 에이전트에게 말을 걸면 프로젝트를 만들고, 테스트하고, 출시하는 데 필요한 명령을 대신 실행한다.
내부적으로는 에이전트를 정의하는 코드 계층인 Google의 ADK 에이전트 프레임워크 위에 세워졌다. CLI가 그 프레임워크를 감싸므로 반복적인 코드를 손으로 쓰지 않아도 된다.
가장 큰 한계는 범위다. Google Cloud를 위해 만든 개발자 도구라서 터미널, Python 3.11+, uv, Node.js에 익숙하다고 전제하며, 중립적인 호스트가 아니라 Google의 에이전트 플랫폼을 가리킨다. 끌어다 놓는 방식의 에이전트 빌더를 원한다면 이건 아니다.
시작하기
uvx google-agents-cli setup으로 CLI와 스킬을 설치한다. Python 3.11+, uv, Node.js가 필요하다.- 코딩 어시스턴트(Antigravity CLI, Claude Code, Codex 등)를 열고
agents-cli login으로 Google Cloud나 AI Studio에 로그인한다. - 코딩 에이전트에게 쉬운 말로 에이전트를 만들라고 요청한다. 워크플로와 골격 생성 스킬이 작동하고, 확인 질문을 던진 뒤 명세를 저장한다.
- 에이전트가
agents-cli create로 프로젝트 골격을 만들게 하고, 이어서agents-cli install로 의존성을 설치한다. - 실행, 평가, 배포:
agents-cli run으로 빠르게 시험하고,agents-cli eval run으로 추적 기록을 채점하며, 출시할 준비가 되면agents-cli deploy를 쓴다.
제품 정보
agents-cli의 요금, 지원 플랫폼, 성능을 한눈에 확인해 보세요.
추천 대상
이 도구가 가장 잘 맞는 사용자, 작업, 상황입니다.
사용자
- 백엔드와 Python 개발자
- 이미 Google Cloud를 쓰는 팀
- 코딩 에이전트 고급 사용자
작업
- 새 ADK 에이전트 프로젝트의 골격 생성
- 에이전트 품질 평가
- 프로덕션 배포
활용 상황
- 각 서비스 문서를 먼저 읽지 않고 주말에 에이전트 아이디어를 시작한다
- 검토를 통과해야 하는 사내 도구를 출시한다
- 기업 사용자용으로 에이전트를 등록한다
주요 기능
코딩 어시스턴트용 스킬
핵심 발상은 agents-cli가 코딩 어시스턴트에게 스킬 묶음을 넘기고, 각 스킬이 작업의 한 부분을 맡는다는 것이다. 워크플로와 모델 선택을 위한 스킬, ADK의 Python API용 스킬, 골격 생성용 스킬이 있고, 평가, 배포, 게시, 관측성에는 각각 별도의 스킬이 있다. 작업을 요청하면 어시스턴트가 알맞은 스킬을 불러오므로 Google Cloud의 세부 사항을 추측하지 않는다. 서비스 문서를 복사해 붙여 넣을 일도 없다.
프로젝트 골격 생성과 업그레이드
agents-cli create 명령은 작동하는 코드, 테스트, 바로 쓸 수 있는 평가 세트를 갖춘 새 에이전트 프로젝트를 만든다. 이미 프로젝트가 있다면 scaffold 하위 명령으로 배포나 CI/CD를 더하거나 더 새 버전의 도구로 끌어올릴 수 있다. 이 업그레이드 경로는 CLI가 바뀔 때 중요하다. 처음부터 다시 만들 필요가 없다.
내장 평가
평가 명령은 작업을 분명한 단계로 나눈다. eval generate는 평가 사례로 에이전트를 돌린다. eval grade는 지표에 따라 추적 기록을 채점한다. 그리고 eval run은 둘을 한 번에 한다. 이 AI 에이전트 평가는 여러 턴의 데이터셋, LLM을 심판으로 삼는 채점, 적응형 평가 기준을 지원한다. 취미로 에이전트를 만드는 대부분이 굳이 하지 않는 것보다 더 나아간다.
배포 대상
에이전트가 준비되면 Google의 Agent Runtime, Cloud Run, GKE에 배포할 수 있다. 배포 스킬은 CI/CD 파이프라인과 비밀도 다루므로, 로컬 빌드에서 돌아가는 서비스까지의 길은 직접 떠안는 대신 안내된다. Google Cloud 프로젝트 설정과 자격 증명은 그대로 이어진다.
Gemini Enterprise 게시
전용 게시 스킬이 에이전트를 Gemini Enterprise에 등록한다. 이는 Google이 기업용 에이전트를 위해 마련한 플랫폼이다. 이 단계가 작동하는 시제품을 조직이 실제로 사용자에게 배포할 수 있는 무언가로 바꾼다. 건너뛰면 에이전트는 로컬에 머문다.
관측성 연결
관측성 스킬은 에이전트를 Cloud Trace와 로깅에 연결하고 서드파티 연동도 다룬다. 일단 가동되면 어둡게 나는 대신 프로덕션에서 에이전트가 어떻게 작동하는지 본다.
이미 쓰는 도구에서 실행
agents-cli는 새 편집기를 강요하지 않는다. Antigravity CLI, Claude Code, Codex, 그리고 다른 어떤 코딩 에이전트와도 작동하므로 익숙한 워크플로를 유지하고 CLI가 Google Cloud의 빈틈을 메운다.
장단점
장점
- Apache 2.0으로 무료이며 오픈소스라서 시험해 볼 라이선스 비용이 없다.
- 여러 서비스에 걸친 흐름을 안내되는 하나의 명령줄로 묶어 설정 학습 곡선을 낮춘다.
- 스킬 기반 설계라서 플랫폼 지식을 내가 아니라 코딩 어시스턴트가 짊어진다.
- 평가, 배포, 관측성이 포함되어 있어 단계마다 별도 도구를 꿰맞출 필요가 없다.
단점
- Google Cloud에 묶여 있어 다른 곳에 배포하는 것은 의도된 경로가 아니다.
- 개발자 환경(Python 3.11+, uv, Node.js)과 터미널 숙련을 요구하므로 비기술 사용자는 배제된다.
- 빠르게 움직이는 오픈소스 프로젝트라 명령과 스킬이 버전 사이에 바뀔 수 있어, 업그레이드 후 문서를 다시 확인해야 할 수 있다.
자주 묻는 질문
코딩 어시스턴트에게 Google Cloud에서 AI 에이전트를 구축, 평가, 배포, 게시하는 스킬과 명령을 준다. 한 번 설치한 뒤 코딩 에이전트에게 쉬운 말로 작업을 요청하면 된다.
관련 콘텐츠
agents-cli와 관련된 도구, 스킬, 아티클을 살펴보세요.
agents-cli 대안
Forefront
Forefront · 코딩Forefront는 오픈소스 AI로 무언가를 만드는 웹 플랫폼이다. 대표적인 오픈소스 언어 모델을 자신의 데이터로 미세 조정하고, 성능을 평가하고, API로 실행하거나 내보내 직접 호스팅할 수 있다. 폐쇄형 플랫폼의 편의를 원하면서도 모델과 데이터의 소유권은 놓지 않으려는 개발자가 대상이다.
Startkit
StartKit.AI · 코딩Startkit은 AI SaaS와 AI 래퍼 제품을 만들기 위한 보일러플레이트다. 지루한 부분을 미리 연결해 둔 AI 스타트업 보일러플레이트라고 생각하면 된다. 인증, Stripe와 Lemon Squeezy 결제, 사용량 제한, 트랜잭션 이메일, 그리고 OpenAI, Anthropic, Groq, Llama와 통신하는 AI API 스타터 키트가 포함된다. 저장소를 복제하고 가격을 정한 뒤 사용자가 실제로 돈을 내는 부분에 착수하면 된다. React와 Tailwind 위의 Next.js로 만들어졌기 때문에 보일러플레이트 코드의 상당 부분이 이미 익숙하게 느껴진다.
Testim
Tricentis · 코딩Testim은 웹, 모바일, Salesforce 애플리케이션 전반에 걸쳐 엔드투엔드 테스트를 만들고 실행하는 AI 기반 테스트 자동화 플랫폼이다. 머신러닝에 기대어 인터페이스가 바뀌어도 테스트를 안정적으로 유지하므로, 팀은 깨진 셀렉터를 고치는 데 쓰는 시간을 줄인다. 오늘부터 쓸 수 있는 자동화 테스트 도구치고 나쁘지 않다. 브라우저에서 동작을 녹화해 테스트를 만들고, 더 세밀한 제어가 필요하면 JavaScript를 더한다. 바쁜 QA 팀에게 탄탄한 선택이다.
