Hoje estamos anunciando novas funcionalidades 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 servidores 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 os agentes gerenciados na API Gemini Interactions, você chama um único endpoint e o Gemini lida com 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 da API Interactions: npx skills add google-gemini/gemini-skills --skill gemini-interactions-api
Abaixo estão exemplos usando o SDK @google/genai em 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 sob 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 limites de orçamento como proteções 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 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 streaming SSE 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 limites rígidos de orçamento 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 em busca de classes obsoletas e utilitários internos, e gere um relatório abrangente de auditoria de migração 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, agora você pode automatizar tarefas recorrentes do agente usando gatilhos agendados.
Um gatilho vincula um agente, ambiente, prompt e agenda cron em um recurso persistente que é acionado automaticamente sem intervenção manual. Cada execução agendada reutiliza o mesmo ambiente sandbox subjacente, para que os arquivos criados ou clonados em uma execução persistam e estejam imediatamente acessíveis na próxima, tornando os gatilhos ideais para triagem diária de issues, relatórios noturnos de regressão ou manutenção programada 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:00 AM7 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 aos feedbacks. Verifique novas issues marcadas como 'accepted', pule qualquer uma já rastreada em /workspace/solved-issues/, corrija as restantes 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 com controle de custos e agendados que operam autonomamente 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.
