구글 에이전트 CLI와 ADK: 스킬로 AI 에이전트를 프로덕션까지 배포하기

핵심 메시지

• 구글의 에이전트 CLI는 오픈소스로, 구글의 에이전트 프레임워크인 ADK로 에이전트를 만들도록 돕는다.
• 핵심은 CLI(능력)와 스킬(사용법)의 결합이다. CLI는 스캐폴딩·평가·실행·프롬프트 최적화 같은 명령을 제공하고, 함께 배포되는 스킬이 코딩 에이전트에게 그 사용법과 ADK 문서를 주입한다.
• 덕분에 사용자는 문서를 뒤질 필요 없이 자연어 지시만으로 코딩 어시스턴트가 에이전트를 만들고 평가·배포·강화하게 할 수 있다.
• 발표자는 클로드 코드만으로 터미널 명령을 한 번도 직접 치지 않고 ‘CSV에 질문하는’ 에이전트를 만들어 GCP 프로덕션까지 배포했다.
• 자체 실행용 도구에는 코딩 에이전트 SDK가 좋지만, 플랫폼·프로덕션에 넣을 에이전트는 속도와 토큰 효율이 중요해 ADK 같은 경량 프레임워크가 더 적합하다.

쉽게 이해하기

발표자는 CLI와 스킬의 결합으로 코딩 어시스턴트가 아이디어부터 안정적 배포까지 에이전트 제작을 안내하는 방법을 구글 에이전트 CLI로 보여준다. 예전에는 링크체인 같은 프레임워크로 모델·프롬프트·도구를 한 줄씩 정의하며 오래 걸렸고, 코딩 어시스턴트가 생긴 뒤에도 문서를 일일이 퍼다 컨텍스트로 넣어야 했다.

이제 2026년에는 단일 명령으로 CLI와 스킬을 설치하면 문서를 직접 볼 필요가 없다. CLI는 코딩 에이전트에게 주는 ‘능력’이고, 함께 오는 스킬은 그 사용법을 알려주는 ‘지시’다. 에이전트 코드 작성 방법을 담은 스킬에는 구글 ADK 문서가 그대로 녹아 있어, 제작·평가·배포·관측의 각 단계마다 대응하는 스킬이 붙는다.

발표자는 명령을 한 번도 직접 치지 않는 것을 스스로의 과제로 삼고 클로드 코드에게 웹 검색으로 설치법을 찾아 프로젝트에 CLI와 스킬을 깔게 했다. 이후 CSV와 질문을 받아 파이썬 코드를 실행해 답하는 ‘데이터에 질문하기’ 에이전트를 만들게 했다. 코드 실행은 프로덕션에서 격리가 까다로운 작업인데, 배포 시 구글이 이를 대신 처리해 준다.

빌드 도중 에이전트는 코드 실행기로 무엇을 쓸지 물었고, 발표자는 ADK의 내장 샌드박스를 택했다. 완성 뒤에는 클로드 코드로 간단한 스트림릿(Streamlit) UI도 만들어 로컬 또는 배포된 에이전트를 테스트했다. 예를 들어 ‘주문당 매출 중앙값과 평균 위 최대 이상치’를 물으면 판다스 코드를 작성·실행해 답과 그 코드를 함께 보여준다.

이어 평가와 배포로 넘어간다. 새 대화에서 ‘ADK 스킬로 에이전트를 평가하라’고 하면 제작 때 만든 테스트 세트를 실행해 응답이 기대와 맞는지 확인한다. 마지막으로 ‘이 에이전트를 배포하라’고만 하면 스킬이 GCP 배포 전 과정을 진행하며, 필요한 인증과 프로젝트 설정 단계까지 안내한다. 약 6분 만에 에이전트가 프로덕션에 올라갔다.

주요 인사이트

• CLI는 ‘능력’, 스킬은 ‘지시’라는 분업이 조합을 강력하게 만든다. CLI가 실행할 명령을 제공하고, 스킬이 그것을 언제 어떻게 쓰는지 코딩 에이전트에게 가르친다.
• 구글 에이전트 CLI의 강점은 배포와 프로덕션 관측까지 커버한다는 점이다. 에이전트 제작을 돕는 스킬을 갖춘 프레임워크는 많지만, 배포·관측성까지 밀어붙이는 경우는 드물다.
• 코딩 에이전트 SDK와 전통적 프레임워크는 용도가 다르다. 자체 실행용 제2의 뇌·에이전틱 워크플로는 출력 품질이 중요해 SDK가 좋지만, 토큰 효율과 속도가 떨어진다. 플랫폼·프로덕션용 에이전트는 ADK 같은 경량 프레임워크로 빠르고 가볍게 만드는 편이 낫다.
• 속도는 곧 이탈과 직결된다. 플랫폼 고객이 4초 안에 첫 토큰조차 받지 못하면 떠날 가능성이 매우 높다는 연구가 있어, 대규모로 확장할 에이전트는 빠르고 가벼워야 한다.
• 스킬이 있어도 계획-구현 과정을 건너뛰지 말라는 조언이 있다. 복잡한 멀티 에이전트나 RAG라면 코딩 어시스턴트와 스펙을 먼저 충분히 짜두어야 한다.

자주 묻는 질문

관련 AI 소식