Skip to main content
공개 노트

Cloud Agents Interpreters: 에이전트가 CSV를 '읽는' 대신 '계산'한다

Views 3약 3분생성형 AI 활용
Summary

Cloud Agents Interpreters: 에이전트가 CSV를 '읽는' 대신 '계산'한다

AI 에이전트가 큰 CSV를 다룰 때 핵심 문제는 “이해”가 아니라 “정확한 처리”입니다. 수천~수백만 행을 세고, 묶고, 정렬하는 일은 언어 모델이 추론으로 맞힐 영역이 아니라 코드가 실행해야 할 영역입니다.

새 Interpreters 기능은 이 지점에 초점을 맞춥니다. 에이전트 루프 내부에 가벼운 런타임을 두고, bash 없이 샌드박스 형태로 코드 기반 작업을 처리하게 합니다. 예를 들어 CSV를 파싱하고, error_code별로 그룹화한 뒤, 그룹별 개수를 계산하고, 빈도순으로 정렬하는 작업이 여기에 해당합니다.

Interpreters가 바꾸는 것

Interpreters의 의미는 “더 유창한 답변”보다 “검증 가능한 실행”에 가깝습니다. 모델이 숫자를 추정해 답하는 대신, 에이전트가 필요한 계산을 실제로 수행하고 그 결과를 반환하는 구조이기 때문입니다.

이 차이는 특히 데이터 작업에서 중요합니다. 로그, 결제 내역, 고객 문의 데이터처럼 결과의 정확성이 중요한 입력에서는 그럴듯한 요약보다 재현 가능한 집계가 더 큰 가치를 만듭니다. Interpreters는 에이전트가 이런 작업을 모델의 문장 생성 능력에만 맡기지 않도록 해줍니다.

비슷한 방향은 다른 에이전트 도구에서도 확인됩니다. Microsoft의 코드 인터프리터도 에이전트가 샌드박스 환경에서 Python 코드를 작성·실행해 데이터 분석, 시각화, 파일 생성을 처리하도록 설명합니다.1 흐름은 분명합니다. 에이전트의 경쟁력은 말솜씨만이 아니라, 안전한 실행 환경 안에서 도구를 정확히 사용하는 능력으로 이동하고 있습니다.

Agents CLI 관점에서 보면

Google의 Agents CLI는 Google Cloud에서 AI 에이전트를 구축·평가·배포하기 위한 명령어와 스킬을 제공하는 도구입니다.2 Gemini CLI, Claude Code, Codex, Antigravity 같은 여러 코딩 에이전트와 함께 사용할 수 있습니다.2

여기서 중요한 점은 Agents CLI가 코딩 에이전트 자체가 아니라는 것입니다. 역할은 코딩 에이전트가 ADK 에이전트를 만들고 배포하도록 돕는 쪽에 가깝습니다.2 즉, 에이전트 개발 흐름에 필요한 프로젝트 생성, 평가, 배포 과정을 보조하는 도구로 이해하는 편이 정확합니다.

시작 조건도 명확합니다. Agents CLI를 설치하려면 Python 3.11 이상, uv, Node.js가 필요하며, 설치 명령은 다음과 같습니다.2

uvx google-agents-cli setup

로컬 개발에서는 Google Cloud 없이 AI Studio API 키로 ADK와 Gemini를 실행할 수 있지만, 클라우드 배포 기능을 사용하려면 Google Cloud가 필요합니다.2

실무 적용 기준

Interpreters는 “요약”보다 “집계”가 중요한 에이전트에 먼저 검토할 만합니다. 예를 들어 로그 CSV에서 오류 코드를 세거나, 결제 내역을 항목별로 묶거나, 고객 문의 데이터를 유형별로 정렬하는 작업처럼 결과가 숫자와 규칙으로 검증되는 경우입니다.

다만 바로 운영에 넣기보다는 평가 루프를 먼저 붙이는 편이 안전합니다. Agents CLI에는 새 에이전트 프로젝트를 생성하는 명령, 평가를 실행하는 명령, 두 평가 결과를 비교하는 명령이 제공됩니다.2

agents-cli scaffold <name>
agents-cli eval run
agents-cli eval compare

이런 흐름을 만들면 Interpreters가 실제로 정확도를 높이는지, 기존 방식보다 오류를 줄이는지, 변경 후 결과가 어떻게 달라지는지 비교할 수 있습니다.

결론

Cloud Agents Interpreters의 핵심은 에이전트가 데이터를 “읽는 척”하지 않고, 필요한 계산을 안전한 런타임에서 직접 수행하도록 만드는 데 있습니다.

큰 CSV나 로그처럼 정확한 집계가 중요한 작업에서는 더 긴 프롬프트보다 실행 가능한 도구가 더 실용적입니다. Interpreters는 AI 에이전트가 단순한 답변 생성기를 넘어, 검증 가능한 작업 실행자로 이동하고 있음을 보여주는 기능입니다.

1Add the code interpreter capability to your agent

2GitHub - google/agents-cli

이 노트는 보도·비평·교육·연구 목적으로 작성되었습니다. 저작권 문의가 있으시면 에서 알려주세요.

틸노트는 사용자가 AI를 활용해 노트를 쉽게 작성하거나 편집할 수 있는 서비스입니다.

AI 스퀘어 단톡방에 함께해요

AI 활용과 틸노트 사용 팁을 나누는 오픈채팅방입니다. 입장 비밀번호는 tilnote입니다.

참여하기