Gemini API 매니지드 에이전트: 3.6 Flash 기본 적용 및 훅(Hooks) 도입
IMP
8/10
핵심 요약
Gemini API의 매니지드 에이전트(Managed Agents)가 기본 모델로 빠르고 효율적인 Gemini 3.6 Flash를 탑재했습니다. 또한 샌드박스 내 도구 호출을 제어할 수 있는 환경 훅(Environment hooks), 예산 제어 기능 및 무료 티어를 지원하여 개발자들이 더욱 정교하게 AI 에이전트를 구축하고 비용을 관리할 수 있게 되었습니다. 이번 업데이트는 AI 코딩 보조 및 자동화 워크플로우의 안전성과 활용성을 크게 높이는 핵심 업데이트입니다.
번역된 본문
Gemini API의 매니지드 에이전트(Managed Agents): 3.6 Flash, 훅(Hooks) 및 기타 기능들
2026년 7월 28일
Gemini API의 매니지드 에이전트가 이제 기본적으로 Gemini 3.6 Flash 모델을 사용합니다. 새로운 환경 훅(environment hooks)을 통해 샌드박스 내부의 도구 호출(tool calls)을 차단하거나, 린트(lint, 코드 스타일 검사)하거나, 감사(audit)할 수 있습니다. 또한 예산 제어, 예약 트리거, 무료 티어(free tier) 접근 권한을 추가했습니다.
필립 쉬미드(Philipp Schmid), 구글 딥마인드 기술 직원
마리아노 코키리오(Mariano Cocirio), 구글 딥마인드 제품 관리자
[음성 듣기] [이 기사는 구글 AI에 의해 생성되었습니다. 생성형 AI는 실험적 기능입니다.]
음성 속도: 0.75X 1X 1.5X 2X
Gemini API의 매니지드 에이전트에 환경 훅, 모델 선택, 무료 티어 액세스 기능이 추가되었습니다. 이러한 기능들은 이전에 도입된 백그라운드 작업 및 원격 MCP 서버 통합을 기반으로 구축되었습니다. Gemini Interactions API의 매니지드 에이전트를 사용하면, 단일 API 호출만으로 격리된 클라우드 샌드박스 내에서 추론, 코드 실행, 패키지 설치, 파일 관리 및 웹 검색을 조율할 수 있습니다.
AI 코딩 어시스턴트를 사용 중이라면, 터미널에 다음 명령어를 입력하여 Interactions API 스킬에 대한 액세스 권한을 부여할 수 있습니다:
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api
아래는 @google/genai TypeScript/JavaScript SDK를 사용한 예제입니다. Python이나 cURL의 경우, Antigravity 에이전트 문서를 확인하십시오.
npm install @google/genai
Gemini 3.6 Flash가 기본 모델로 지정
antigravity-preview-05-2026 에이전트는 이제 기본적으로 Gemini 3.6 Flash로 실행됩니다. 코드를 변경할 필요가 없으며, 다음 상호작용 시 자동으로 적용됩니다. 또한 상호작용이나 매니지드 에이전트를 생성할 때 agent_config.model을 전달하여 모델을 명시적으로 선택할 수 있습니다. 비용을 낮추기 위해 Gemini 3.5 Flash-Lite를 사용하거나, 선호하는 모델을 지정할 수 있습니다.
(코드 생략)
지원되는 모델은 다음과 같습니다:
Gemini 3.6 Flash (gemini-3.6-flash, 기본값): 추론, 코딩 및 도구 사용에 최적화된 균형 잡힌 모델.
Gemini 3.5 Flash (gemini-3.5-flash): 범용 에이전트 워크플로우를 위한 이전 세대 모델.
Gemini 3.5 Flash-Lite (gemini-3.5-flash-lite): Gemini 3.5 제품군 중 가장 낮은 지연 시간과 비용을 제공.
환경 훅(Hooks): 샌드박스 내 도구 호출 차단, 린트 및 감사
환경 훅을 사용하면 에이전트가 샌드박스 내에서 도구를 호출하기 전후에 사용자 정의 스크립트를 실행할 수 있습니다. 환경에 .agents/hooks.json 파일을 추가하면 런타임이 pre_tool_execution 또는 post_tool_execution 이벤트에서 핸들러를 실행합니다. matcher 필드는 정규 표현식을 지원하여 |를 사용해 여러 도구를 지정하거나 *를 사용해 모든 도구를 대상으로 할 수 있습니다.
(JSON 구성 생략)
이 구성에서 다음과 같이 작동합니다:
security-gate 그룹은 code_execution 또는 write_file 호출이 있기 전에 gate.py를 실행합니다. 스크립트가 {"decision": "deny", "reason": "..."}를 반환하면 도구 호출을 건너뛰고 거부 이유가 모델의 컨텍스트에 전달됩니다.
auto-format 그룹은 코드 스타일을 적용하기 위해 모든 도구가 완료된 후 auto_lint.py를 실행합니다.
또한 훅은 외부 엔드포인트로 직접 POST 요청을 보내는 http 유형 핸들러도 지원합니다. 전체 HTTP 훅 정의 및 실패 처리 의미론에 대해서는 훅 문서를 참조하십시오.
Gemini API Managed Agents: 3.6 Flash, hooks, and more Jul 28, 2026 | x.com Facebook LinkedIn Mail Copy link Managed Agents in Gemini API now default to Gemini 3.6 Flash. New environment hooks let you block, lint, or audit tool calls inside the sandbox. Also, we’ve added budget controls, scheduled triggers, and free tier access. Philipp Schmid Member of the Technical Staff, Google DeepMind Mariano Cocirio Product Manager, Google DeepMind Share x.com Facebook LinkedIn Mail Copy link . Inlining them here makes them available in the DOM for the page. --> Your browser does not support the audio element. Listen to article [[duration]] minutes This content is generated by Google AI. Generative AI is experimental Voice Speed Voice Speed 0.75X 1X 1.5X 2X Managed Agents in Gemini API are getting environment hooks , model selection , and free tier access . These capabilities build on our previous release introducing background tasks and remote MCP server integration . With managed agents in the Gemini Interactions API , a single API call coordinates, reasoning, code execution, package installation, file management, and web retrieval inside an isolated cloud sandbox. If you're using an AI coding assistant, drop this in your terminal to give it access to the Interactions API skill: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api. Below are examples using the @google/genai TypeScript/JavaScript SDK. For Python or cURL, check out the Antigravity agent documentation . npm install @google/genai Gemini 3.6 Flash is now the default The antigravity-preview-05-2026 agent now runs Gemini 3.6 Flash by default. No code changes are required. Your next interaction picks it up automatically. You can also explicitly select models by passing agent_config.model when creating an interaction or managed agent. Use Gemini 3.5 Flash-Lite for lower cost, or pin to your model of preference. import { GoogleGenAI } from "@google/genai"; const client = new GoogleGenAI({}); const interaction = await client.interactions.create({ agent: "antigravity-preview-05-2026", input: "Audit all dependencies in package.json, upgrade outdated packages, and verify the build by running npm test.", environment: "remote", agent_config: { type: "antigravity", model: "gemini-3.5-flash-lite", }, }); console.log(interaction.output_text); Supported models include: Gemini 3.6 Flash ( gemini-3.6-flash , default): Balanced model for reasoning, coding, and tool use. Gemini 3.5 Flash ( gemini-3.5-flash ): Previous generation for general agentic workflows. Gemini 3.5 Flash-Lite ( gemini-3.5-flash-lite ): Lowest latency and cost on the Gemini 3.5 family. Environment hooks: block, lint, and audit tool calls inside the sandbox Environment hooks let you run your custom scripts before or after every tool call the agent makes inside its sandbox. Add a . agents/hooks.json into your environment and the runtime executes your handlers on pre_tool_execution or post_tool_execution events. The matcher field supports regular expressions, allowing you to target multiple tools with | or catch everything with * : { "security-gate": { "pre_tool_execution": [ { "matcher": "code_execution|write_file", "hooks": [ { "type": "command", "command": "python3 /.agents/hooks-scripts/gate.py", "timeout": 10 } ] } ] }, "auto-format": { "post_tool_execution": [ { "matcher": "*", "hooks": [ { "type": "command", "command": "python3 /.agents/hooks-scripts/auto_lint.py", "timeout": 15 } ] } ] } } In this configuration: The security-gate group runs gate.py before every code_execution or write_file call. If the script returns {"decision": "deny", "reason": "..."} , the tool call is skipped and the rejection reason is passed into the model’s context. The auto-format group runs auto_lint.py after every tool finishes to enforce code styling. Hooks also support http type handlers that POST directly to an external endpoint. For complete HTTP hook definitions and failure handling semantics, refer to the hooks documentation . Teams are already using hooks to build production-grade validation pipelines. For example, AI-native investment bank Offdeal uses post_tool_execution hooks to run automated image verification inside the remote sandbox. "OffDeal is an AI-native investment bank, and Archie is the AI analyst our bankers use every day. A requirement for banker-ready decks is company logos: buyer tables, sponsor columns, tombstone grids, often 30+ logos in a single deck, every one of which must be the right company, the appropriate size and aspect ratio, contain the name, have a transparent background, and have a high contrast when placed on a white slide. Before agent hooks, we couldn’t do this on Gemini’s managed agents: the sandbox is remote, so our validation code had nowhere to run. With hooks, a post_tool_execution hook triggers our pipeline inside the sandbox the moment Archie writes its company list, fetching candidates, enforcing pixel-level quality checks, verifying each logo with Gemini vision, and publishing a manifest of approved files that are the only images allowed into the deck." - Alston Lin, Founder & CTO of OffDeal Cost control and automation features Free tier availability Managed agents are now available on free tier projects . Developers can experiment with agentic workflows using an API key from a project without active billing . Budget controls Because managed agents execute multi-turn autonomous loops, complex tasks can consume significant token budgets. To prevent runaway tasks, you can pass max_total_tokens inside agent_config to cap total consumption (input + output + thinking). When the agent reaches the limit, execution safely pauses and the interaction returns status: "incomplete" . The environment state is preserved, enabling you to continue where it stopped by passing previous_interaction_id with a fresh budget. const interaction = await client.interactions.create({ agent: "antigravity-preview-05-2026", input: "Audit all modules in this repo and generate a migration report.", agent_config: { type: "antigravity", max_total_tokens: 10000, }, environment: "remote", }); Scheduled execution with triggers Automate recurring agent tasks with scheduled triggers . A trigger binds an agent, environment, prompt, and cron schedule into a persistent resource that fires without manual intervention. Each run reuses the same sandbox, so files persist across executions. Environments API The Environments API lets you list, inspect, and delete sandbox sessions from code. Recover environment IDs after a disconnect, or clean up sandboxes when your pipeline finishes instead of waiting for the 7-day TTL. Get started with managed agents These updates turn managed agents into cost-controlled, scheduled workers that operate autonomously inside real development environments without breaking your budget or requiring external orchestration. Check out the Gemini Interactions API overview and the managed agents quickstart to explore custom agent definitions, environment configurations, network rules, and advanced streaming patterns. POSTED IN: