Visão geral dos agentes

Os agentes gerenciados na API Gemini oferecem um harness de agente configurável. Uma única chamada de API provisiona um sandbox do Linux em que o agente raciocina, executa código, gerencia arquivos e navega na Web de forma autônoma.

Agentes gerenciados disponíveis

• Agente do Antigravity: agente gerenciado de uso geral com tecnologia do Gemini 3.6 Flash. Executa código, gerencia arquivos e pesquisa na Web em um sandbox seguro do Linux hospedado pelo Google. É possível configurar o modelo subjacente (como o Gemini 3.6 Flash, o Gemini 3.5 Flash ou o Gemini 3.5 Flash-Lite) usando agent_config e estendê-lo com suas próprias instruções, habilidades e dados para criar um agente personalizado.
• Deep Research: agente de pesquisa autônomo que planeja, executa e sintetiza tarefas de pesquisa de várias etapas para casos de uso como análise de mercado, auditoria e revisões de literatura.

Segurança e práticas recomendadas

Cada agente é executado em um ambiente de sandbox isolado no nível do SO. O sandbox tem acesso de rede de saída irrestrito por padrão. É possível restringir ou desativar o acesso à rede usando uma lista de permissões.

Acesso à rede

Por padrão, os ambientes têm acesso de rede de saída irrestrito. Use uma lista de permissões network para restringir o tráfego de saída a domínios específicos ou padrões curinga. Para detalhes de configuração, consulte Lista de permissões de rede (AI Studio) ou Regras de rede (API).

Ferramentas e APIs externas

É possível conectar ferramentas e APIs externas para estender o agente. Use apenas ferramentas de fontes confiáveis e permissões de escopo para o mínimo necessário. As credenciais podem ser injetadas com segurança por transformações de cabeçalho de proxy de saída e nunca são expostas dentro do sandbox. O agente pode usar qualquer credencial a que tiver acesso. Portanto, forneça apenas credenciais cujo escopo completo você esteja disposto a conceder.

• Use contas de serviço ou chaves de API com privilégios mínimos.
• Prefira tokens de curta duração a chaves de longa duração.
• Forneça apenas credenciais cujo escopo completo você esteja disposto a conceder.
• Alterne as credenciais regularmente.

Para detalhes sobre como configurar transformações de cabeçalho, consulte Credenciais.

Supervisão humana

Sempre verifique as saídas (código gerado, transformações de dados, mudanças de configuração) antes de implantá-las, especialmente para tarefas que modificam dados ou interagem com sistemas externos.

Preços

Os agentes gerenciados usam um modelo de pagamento por uso com base em tokens de modelo do Gemini e uso de ferramentas. Uma única interação pode acionar vários loops de raciocínio, normalmente consumindo de 100 mil a 3 milhões de tokens. A computação do ambiente não é faturada durante o pré-lançamento. Consulte os custos estimados para detalhamentos por tarefa. Os agentes gerenciados também estão disponíveis no nível sem custo financeiro com um limite de taxa e uma cota de uso sem custo financeiro.

Limites

Frameworks de agentes

Também é possível criar agentes com o Gemini usando estes frameworks e SDKs:

• LangChain / LangGraph: crie fluxos de aplicativos com estado e complexos e sistemas multiagente usando estruturas de grafo.
• LlamaIndex: conecte agentes do Gemini aos seus dados particulares para fluxos de trabalho aprimorados por RAG.
• CrewAI
• SDK de IA do Vercel: crie interfaces e agentes de usuário com tecnologia de IA em JavaScript/TypeScript.
• **ADK do Google**: um framework de código aberto para criar e orquestrar agentes de IA interoperáveis.
• SDK do Antigravity: crie agentes de IA autônomos usando as mesmas ferramentas, loop de agente e gerenciamento de contexto que alimentam o Google Antigravity, programável em Python.