Gemini Managed Agents ganham controles de orçamento e ganchos

Gemini 3.6 Flash como padrão

Os Managed Agents da Gemini API agora rodam Gemini 3.6 Flash por padrão, sem necessidade de alteração de código. Também é possível selecionar explicitamente o modelo via agent_config.model, incluindo Gemini 3.5 Flash e Gemini 3.5 Flash-Lite (menor latência e custo).

Environment hooks

A principal novidade são os environment hooks: scripts customizados que rodam antes ou depois de cada tool call do agente dentro do sandbox. Configurados via .agents/hooks.json, suportam matchers com regex para filtrar ferramentas específicas.

Dois tipos de evento:

• pre_tool_execution: pode bloquear uma chamada retornando {"decision": "deny", "reason": "..."}, passando o motivo para o contexto do modelo.
• post_tool_execution: roda após a execução, útil para linting, formatação ou validação.

Hooks também suportam handlers HTTP que fazem POST para endpoints externos.

Como caso de uso real, a OffDeal (banco de investimento AI-native) usa hooks post_tool_execution para rodar verificação automatizada de logos dentro do sandbox remoto - buscando candidatos, aplicando checagens de qualidade em nível de pixel e validando cada imagem com Gemini Vision antes de aprovar para uso em decks.

Controles de custo e automação

• Free tier: Managed Agents agora disponíveis em projetos sem billing ativo, permitindo experimentação com API key.
• Budget controls: o parâmetro max_total_tokens dentro de agent_config limita o consumo total (input + output + thinking). Ao atingir o limite, a execução pausa com status: "incomplete" e o estado do ambiente é preservado, permitindo retomar com previous_interaction_id e um novo orçamento.
• Scheduled triggers: automatizam tarefas recorrentes绑定 agente, ambiente, prompt e cron schedule em um recurso persistente. Cada execução reutiliza o mesmo sandbox, então arquivos persistem entre runs.
• Environments API: permite listar, inspecionar e deletar sessões de sandbox programaticamente, sem esperar o TTL de 7 dias.