도구3분 읽기

Google I/O 2026: Gemini Agents API 완전 정리

Google I/O 2026에서 공개된 Gemini Managed Agents API 입문 가이드. AI 에이전트를 단일 API 호출로 만들고, Antigravity CLI로 멀티 에이전트 워크플로우를 구성하는 법을 정리했다.

#Update#General
Google I/O 2026: Gemini Agents API 완전 정리

TL;DR

  • Google I/O 2026에서 Gemini Managed Agents API 공개 — 에이전트 인프라를 직접 구축할 필요가 없어졌다
  • 단 4줄의 Python 코드로 도구 사용, 코드 실행이 가능한 AI 에이전트를 spin up 할 수 있다
  • Gemini CLI는 2026년 6월 18일에 종료 — Antigravity CLI로의 마이그레이션이 필요하다

Google I/O 2026에서 에이전트 시대가 열렸다

5월 19일 Google I/O 2026의 핵심 메시지는 하나였다. "에이전트 우선(Agent-First)". 검색 증강, 챗봇, 코파일럿 시대를 지나 이제 AI가 직접 작업을 계획하고 실행하는 단계로 넘어갔다.

그 중심에 있는 것이 Gemini Managed Agents API다. 기존에는 에이전트를 만들려면 LangChain, 자체 오케스트레이터, 도구 실행 환경을 직접 구성해야 했다. Managed Agents는 이 인프라 부담을 Google이 흡수한다.

Gemini 3.5 Flash 기반으로 동작하며, 격리된 Linux 환경에서 추론, 도구 사용, Python 코드 실행을 지원한다. 벤치마크 Terminal-Bench 2.1에서 76.2%를 기록 — 코드 에이전트 업무에서 실용적인 수준이다.

Managed Agents API: 4줄로 에이전트 만들기

Managed Agents의 진입장벽은 낮다. Python SDK에서 interactions.create() 한 번이면 추론, 도구 사용, 코드 실행이 가능한 에이전트가 격리 환경에서 실행된다.

from google import genai

client = genai.Client()
interaction = client.interactions.create(
    agent="antigravity-preview-05-2026",
    input="주어진 CSV를 분석하고 월별 매출 추이 그래프를 PDF로 저장해줘",
    system_instruction="데이터 분석가처럼 행동하고, 모든 결과는 PDF로 출력하라."
)

print(interaction.output)

웹 검색, API 호출, Python/Bash 코드 실행이 기본 내장 도구로 제공된다. 에이전트는 호스트 시스템에 영향을 주지 않는 ephemeral Linux 환경에서 돌아간다.

Google AI Studio Playground에서 코드 없이 먼저 테스트할 수 있다. Playground 탭에서 Agents 토글만 켜면 된다.

Antigravity 2.0: Gemini CLI의 후계자

Antigravity 2.0은 Managed Agents를 기반으로 한 에이전트 개발 플랫폼으로, 데스크탑 앱, CLI, SDK 세 가지 형태로 제공된다.

중요 일정: 기존 Gemini CLI는 2026년 6월 18일에 종료된다. 현재 Gemini CLI를 사용 중이라면 그 전에 마이그레이션해야 한다.

# Antigravity CLI 설치
npm install -g @google/antigravity-cli

# 기존 Gemini CLI 프로젝트 마이그레이션
antigravity migrate --from-gemini-cli

# 멀티 에이전트 워크플로우 초기화
antigravity init my-project
antigravity agent add researcher --model gemini-3.5-flash
antigravity agent add coder --tools code_execution
antigravity run --orchestrate

Antigravity CLI는 여러 서브에이전트를 비동기 병렬 실행할 수 있어, 대규모 리팩터링이나 리서치 작업을 터미널 세션을 잠그지 않고 처리한다. 스케줄 작업과 백그라운드 자동화도 지원한다.

비용과 실용성: 실제로 쓸 만한가?

Gemini 3.5 Flash의 API 가격은 **입력 $1.50 / 출력 $9.00 (100만 토큰당)**이다. 동급 모델 대비 4배 빠른 속도이고, Google AI Studio 무료 Tier에서도 Managed Agents를 바로 테스트할 수 있다.

실제로 유용한 활용 케이스:

  • 반복적인 데이터 처리 파이프라인 자동화
  • 코드 리뷰 + 테스트 작성을 하나의 에이전트에 위임
  • Google Workspace(Docs, Sheets) 데이터를 읽고 분석하는 워크플로우
  • Android Studio의 Migration Agent로 코드를 Kotlin으로 자동 전환

토큰 비용을 아끼려면 시스템 프롬프트가 긴 에이전트에 Prompt Caching을 반드시 활성화하자. 반복 호출이 많을수록 캐싱 효과가 크다.

마무리

Gemini Managed Agents API는 에이전트 개발의 인프라 부담을 실질적으로 낮춘 도구다. 지금 Google AI Studio Playground에서 Agents 토글을 켜고 직접 테스트해보자. Gemini CLI 사용자라면 6월 18일 전에 Antigravity CLI로 전환하는 것을 잊지 말자.

공유하기Twitter / X