Google Agents CLI로 살펴보는 코딩 에이전트를 만드는 새로운 방식

이 글은 Google Cloud Next에서 공개된 Google Agents CLI가 무엇인지, 왜 등장했는지, 그리고 기존 코딩 에이전트 환경에서 어떤 변화를 가져오는지 정리한 글입니다.
단순히 “에이전트를 만드는 도구”가 아니라, 에이전트를 만드는 에이전트의 역량을 끌어올리는 메타 도구라는 점에서 이 CLI가 어떤 문제를 해결하려 하는지, 그리고 개발자와 플랫폼 엔지니어에게 어떤 의미를 가지는지를 중심으로 살펴봅니다.

반응형

---

Google Agents CLI란 무엇인가

Google Agents CLI는 Gemini CLI, Claude Code, Codex와 같은 코딩 에이전트가 Google Cloud 기반 AI 에이전트를 설계·배포할 수 있도록 전문 역량을 주입하는 CLI 도구입니다.

중요한 점은, 이 도구가 에이전트 자체를 실행하는 런타임이 아니라는 것입니다.
대신 다음 질문에 답하는 능력을 코딩 에이전트에 제공합니다.

• 어떤 컴포넌트를 선택해야 하는가
• 어떤 순서로 조합해야 하는가
• 어떤 설정이 현재 상황에 적합한가

즉, “코드를 어떻게 짤까”가 아니라 **“어떤 구조와 선택이 맞는가”**라는 판단 영역을 자동화하는 도구입니다.

---

등장 배경: 진짜 병목은 어디에 있었나

에이전트 개발에서의 실제 병목은 SDK 코드 작성 그 자체가 아니라, 다음과 같은 부분에 있습니다.

• 수십 가지 컴포넌트 중 무엇을 써야 하는지 결정
• 워크플로우와 배포 구조 설계
• 평가 방식 선택과 운영 환경 연결
• 흩어진 문서들을 종합해 전체 그림을 이해하는 과정

범용 코딩 에이전트는 이런 결정을 추측으로 처리할 수밖에 없습니다.
Google Agents CLI는 이 문제를 숙련된 플랫폼 엔지니어의 판단을 도구화하는 방식으로 접근합니다.

---

기반 기술: ADK 위에서 동작하는 메타 레이어

이 CLI는 Google의 ADK(Agent Development Kit) 를 기반으로 만들어졌습니다.
그리고 다음을 하나의 CLI 흐름으로 묶습니다.

• 프로젝트 생성
• 에이전트 구조 설계
• 평가
• 배포
• 엔터프라이즈 등록

결과적으로 에이전트 개발의 전체 생명주기를 단일 도구로 다루는 구조입니다.

---

핵심 구조와 동작 방식

설치와 기본 환경

설치는 다음 한 줄로 시작합니다.

uvx google-agents-cli setup

필요한 환경은 다음과 같습니다.

• Python 3.11 이상
• uv (Python 패키지 매니저)
• Node.js

로컬 개발은 AI Studio API 키만으로 가능하며,
클라우드 배포 시에만 Google Cloud 계정이 필요합니다.

---

7가지 스킬 주입 구조

Agents CLI는 코딩 에이전트에 7종의 스킬을 주입하는 방식으로 동작합니다.

• 워크플로우 설계
• ADK 코드 작성
• 프로젝트 스캐폴딩(뼈대 자동 생성)
• 평가 (LLM-as-judge 방식 포함)
• 배포 (Agent Runtime, Cloud Run, GKE)
• Gemini Enterprise 퍼블리싱
• 관측성(로그·트레이스를 통한 상태 파악)

이 구조 덕분에 코딩 에이전트는 단순 코드 생성기를 넘어, 에이전트 플랫폼을 이해하는 조력자로 동작하게 됩니다.

---

Tool Wiring과 프로토콜 지원

도구 연결 측면에서는 다음을 지원합니다.

• MCP(Model Context Protocol): 모델이 외부 도구를 호출하는 표준
• A2A(Agent-to-Agent): 에이전트 간 통신 프로토콜
• 다양한 커넥터 구조

이를 통해 에이전트 간 협업과 외부 도구 연동이 자연스럽게 설계됩니다.

---

기존 프로젝트에도 적용 가능

이미 만들어진 에이전트 프로젝트가 있다면,

• scaffold enhance 명령을 통해
• 배포 설정과 CI/CD 파이프라인을 사후 추가

할 수 있습니다.
또한 코딩 에이전트 없이 터미널에서 독립 실행도 가능합니다.

---

차별화 포인트 정리

1. 특정 코딩 에이전트에 종속되지 않음

Gemini CLI, Claude Code, Codex, Antigravity 등
어떤 코딩 에이전트를 쓰든 스킬 주입 방식으로 동작합니다.

도구 선택권을 침해하지 않는 구조입니다.

---

2. Google Cloud 에이전트 스택의 프론트도어

ADK, Agent Runtime, Agent Sandbox, Gemini Enterprise를
하나의 명령 체계로 연결합니다.

단순한 CLI를 넘어,
Google Cloud 에이전트 스택 전체의 진입점 역할을 합니다.

---

3. 블랙박스가 아닌 의사결정 노출

이 도구는 결과만 보여주지 않습니다.

• 무엇을 했는지
• 왜 그렇게 결정했는지

를 함께 설명하도록 설계되어 있습니다.
이로 인해 팀 전체의 플랫폼 이해도가 함께 올라가는 구조를 지향합니다.

---

시사점과 한계

의미 있는 변화

• “코딩 에이전트가 에이전트를 만든다”는 구조는
  개발자 워크플로우가 에이전트 중심으로 이동하고 있음을 보여줍니다.
• MCP 문서, ADK 문서, gcloud 문서, Runtime 문서 등
  흩어진 정보를 하나로 수렴해 탐색 비용을 크게 낮추려는 시도입니다.

---

고려해야 할 부분

• 현재는 Pre-GA 단계이며,
  소스 공개가 아닌 사전 빌드된 .whl 파일 형태로만 배포됩니다.
• Google Cloud 에이전트 생태계에 초점이 맞춰져 있어
  멀티클라우드나 비-Google 스택 중심 팀에는 적용 범위가 제한적일 수 있습니다.
• 도구 통합의 이점만큼,
  단일 CLI에 대한 의존도 증가는 조직 차원에서 검토가 필요합니다.

---

728x90

에이전트 개발의 초점이 바뀌고 있다

Google Agents CLI는
“코드를 얼마나 잘 쓰느냐”보다
“어떤 구조를 선택하느냐”가 더 중요해진 시점을 잘 보여주는 도구입니다.

에이전트 개발이 본격적으로 플랫폼·운영·조직 단위의 문제로 확장되는 지금,
이 CLI는 단순한 생산성 도구가 아니라
에이전트 시대의 개발 방법론을 실험하는 도구로 볼 수 있습니다.

앞으로 이 접근이 업계 전반으로 확산될지,
혹은 Google Cloud 생태계에 특화된 전략으로 남을지는
지켜볼 만한 포인트입니다.

300x250

https://github.com/google/agents-cli

GitHub - google/agents-cli: The CLI and skills that turn any coding assistant into an expert at creating, evaluating, and deploy