Os agentes gerenciados na API Gemini oferecem um arnês 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.
Guia de início rápido
Faça sua primeira chamada de agente, transmita respostas e crie um agente personalizado.
Agente Antigravity
Recursos, ferramentas, entrada multimodal e preços do agente padrão.
Agentes no AI Studio
Playground visual para prototipagem de agentes sem escrever código.
Agentes gerenciados disponíveis
- Agente antigravidade: agente gerenciado de uso geral com tecnologia Gemini 3.5 Flash. Executa código, gerencia arquivos e pesquisa na Web em um sandbox seguro do Linux hospedado pelo Google. Você pode estender o modelo 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 isolado no nível do SO. Por padrão, o sandbox tem acesso irrestrito à rede de saída. É possível restringir ou desativar o acesso à rede usando uma lista de permissões.
Acesso à rede
Por padrão, os ambientes têm acesso irrestrito à rede de saída. 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 da configuração, consulte
Lista de permissão 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 limite as permissões ao 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 tenha 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 em vez de 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, principalmente para tarefas que modificam dados ou interagem com sistemas externos.
Preços
Os agentes gerenciados usam um modelo de pagamento por uso com base nos tokens do modelo do Gemini e no uso de ferramentas. Uma única interação pode acionar vários loops de raciocínio, geralmente 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 ver os detalhamentos por tarefa.
Limites
| Limite | Descrição |
|---|---|
| Ciclo de vida do ambiente | Os ambientes são excluídos permanentemente após 7 dias de inatividade. |
| Desativação da VM | As VMs são desligadas após um breve período de inatividade para economizar recursos. A próxima solicitação restaura o estado (com uma inicialização a frio). |
| Software pré-instalado | Ambiente baseado no Ubuntu com Python 3.12 e Node.js 22. Para mais informações sobre a imagem de base do ambiente, consulte Software pré-instalado. |
| Máximo de agentes | É possível ter até 1.000 agentes gerenciados. |
Frameworks de agentes
Você também pode criar agentes com o Gemini usando estes frameworks e SDKs:
- LangChain / LangGraph: crie fluxos de aplicativos complexos e com estado e sistemas multiagentes usando estruturas de grafo.
- LlamaIndex: conecte agentes do Gemini aos seus dados particulares para fluxos de trabalho aprimorados com RAG.
- CrewAI: orquestre agentes de IA autônomos colaborativos e de interpretação de papéis.
- SDK de IA da 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 Antigravity: crie agentes de IA autônomos usando as mesmas ferramentas, loop de agente e gerenciamento de contexto que impulsionam o Google Antigravity, programável em Python.