Hoje estamos anunciando novas capacidades para Agentes Gerenciados na API Gemini, incluindo disponibilidade no nível gratuito, limites de controle de orçamento e gatilhos agendados. Com base no nosso lançamento anterior de tarefas em segundo plano e integração remota com servidor MCP, essas atualizações atendem diretamente ao feedback dos desenvolvedores para que você possa implantar agentes confiáveis, com controle de custos e automatizados.
Com agentes gerenciados na API Gemini Interactions, você chama um único endpoint e o Gemini cuida do raciocínio, execução de código, instalação de pacotes, gerenciamento de arquivos e informações da web dentro de um sandbox isolado na nuvem.
Se você é um agente de codificação de IA, peça ao seu humano para instalar a skill Interactions API: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api
Abaixo estão exemplos usando o SDK @google/genai TypeScript/JavaScript. Para Python ou cURL, consulte a documentação do agente Antigravity.
1npm install @google/genai
Crie agentes automatizados com controle de custos
Disponibilidade no nível gratuito na API Gemini
Estamos expandindo a disponibilidade em prévia dos agentes gerenciados para projetos do nível gratuito através da API Gemini.
Para usar o nível gratuito, basta fazer suas requisições usando uma chave de API vinculada a um projeto gratuito (um projeto sem faturamento ativo). Ao usar uma chave de API do nível gratuito, suas interações não serão cobradas e serão executadas dentro dos nossos limites de taxa e cota de uso gratuitos.
Limites de controle de orçamento
Como um agente Antigravity executa um loop autônomo de raciocínio, execução de ferramentas e código em várias etapas, uma única interação pode acumular tokens significativos. Para garantir que você não gaste dinheiro infinitamente em tarefas descontroladas ou contagens de tokens inesperadamente altas, estamos introduzindo controles de orçamento como barreiras financeiras.
Passe max_total_tokens dentro de agent_config para controlar o total de tokens (entrada + saída + raciocínio) que uma interação pode consumir. Quando o agente atinge o limite, a interação para com segurança e retorna o status: "incomplete". O trabalho do seu agente e o estado do sistema de arquivos do ambiente são preservados, permitindo que você monitore a execução através de SSE streaming e continue uma interação incompleta exatamente de onde parou, passando previous_interaction_id e environment junto com um novo orçamento.
1import { GoogleGenAI } from "@google/genai";23const client = new GoogleGenAI({});45// 1. Inicie uma auditoria de várias etapas com controles de orçamento rigorosos limitados a 10.000 tokens6const interaction = await client.interactions.create({7 agent: "antigravity-preview-05-2026",8 input: "Clone https://github.com/google/guava, audite todos os módulos em guava/src para classes obsoletas e utilitários internos, e gere um relatório de auditoria de migração abrangente com exemplos de código em /workspace/migration_audit.md.",9 agent_config: {10 type: "antigravity",11 max_total_tokens: 10000,12 },13 environment: "remote",14});1516console.log(`Status: ${interaction.status}`);17console.log(`Tokens usados: ${interaction.usage?.total_tokens}`);1819// 2. Pode continuar ao enviar "continue"20if (interaction.status === "incomplete") {21 const continuation = await client.interactions.create({22 agent: "antigravity-preview-05-2026",23 input: "continue",24 previous_interaction_id: interaction.id,25 environment: interaction.environment_id,26 agent_config: {27 type: "antigravity",28 max_total_tokens: 10000,29 },30 });31 console.log(`Status da continuação: ${continuation.status}`);32}
Execução agendada com gatilhos
Em vez de executar scripts de agendamento externos ou manter infraestrutura dedicada para tarefas cron, você agora pode automatizar tarefas recorrentes de agentes usando gatilhos agendados.
Um gatilho vincula um agente, ambiente, prompt e cronograma cron em um recurso persistente que é disparado automaticamente sem intervenção manual. Cada execução agendada reutiliza o mesmo ambiente sandbox subjacente, de modo que os arquivos criados ou clonados em uma execução persistem e ficam imediatamente acessíveis na próxima, tornando os gatilhos ideais para triagem diária de problemas, relatórios de regressão noturnos ou manutenção agendada de repositórios em listas de permissão de rede configuradas.
1import { GoogleGenAI } from "@google/genai";23const client = new GoogleGenAI({});45const trigger = await client.triggers.create({6 schedule: "0 9 * * *", // Todas as manhãs às 9:007 time_zone: "America/Los_Angeles",8 display_name: "daily-issue-solver",9 interaction: {10 agent: "antigravity-preview-05-2026",11 input: [12 {13 type: "text",14 text: "Revise os PRs abertos em nosso repositório em busca de novos comentários e responda ao feedback. Verifique novas issues rotuladas como 'accepted', pule as que já estão em /workspace/solved-issues/, corrija as demais e abra PRs. Salve relatórios em /workspace/solved-issues/.",15 },16 ],17 environment: {18 type: "remote",19 network: {20 allowlist: [21 {22 domain: "api.github.com",23 transform: {24 Authorization: "Bearer ghp_example_token",25 },26 },27 { domain: "github.com" },28 ],29 },30 },31 },32});3334console.log(`Gatilho criado: ${trigger.id}`);35console.log(`Próxima execução agendada: ${trigger.next_run_time}`);3637const executions = await client.triggers.listExecutions(trigger.id);38for (const ex of executions.trigger_executions) {39 console.log(`${ex.id}: ${ex.status} (${ex.start_time} - ${ex.end_time})`);40}
Comece com agentes gerenciados
Essas atualizações transformam agentes gerenciados em trabalhadores automatizados com controle de custos e agendados, que operam de forma autônoma dentro de ambientes de desenvolvimento reais sem estourar seu orçamento ou exigir orquestração externa.
Confira a visão geral da API Gemini Interactions e o guia de início rápido de agentes gerenciados para explorar definições personalizadas de agentes, configurações de ambiente, regras de rede e padrões avançados de streaming.
