Los agentes administrados en la API de Gemini te brindan un arnés de agente configurable. Una sola llamada a la API aprovisiona una zona de pruebas de Linux en la que el agente razona, ejecuta código, administra archivos y navega por la Web de forma autónoma.
Guía de inicio rápido
Haz tu primera llamada al agente, transmite respuestas y crea un agente personalizado.
Agente de Antigravity
Son las capacidades, las herramientas, la entrada multimodal y los precios del agente predeterminado.
Agentes en AI Studio
Espacio de pruebas visual para crear prototipos de agentes sin escribir código.
Agentes administrados disponibles
- Agente de Antigravity: Agente administrado de uso general potenciado por Gemini 3.6 Flash. Ejecuta código, administra archivos y busca en la Web dentro de una zona de pruebas segura de Linux alojada por Google. Puedes configurar el modelo subyacente (como Gemini 3.6 Flash, Gemini 3.5 Flash o Gemini 3.5 Flash-Lite) con
agent_configy extenderlo con tus propias instrucciones, habilidades y datos para crear un agente personalizado. - Deep Research: Agente de investigación autónomo que planifica, ejecuta y sintetiza tareas de investigación de varios pasos para casos de uso como análisis de mercado, diligencia debida y revisiones de literatura.
Seguridad y prácticas recomendadas
Cada agente se ejecuta en un entorno de zona de pruebas aislado a nivel del SO. De forma predeterminada, el sandbox tiene acceso de red saliente sin restricciones. Puedes restringir o inhabilitar el acceso a la red con una lista de entidades permitidas.
Acceso a la red
De forma predeterminada, los entornos tienen acceso de red saliente sin restricciones. Usa una lista de entidades permitidas network para restringir el tráfico saliente a dominios específicos o patrones de comodín. Para obtener detalles sobre la configuración, consulta la Lista de entidades permitidas de red (AI Studio) o las reglas de red (API).
Herramientas y APIs externas
Puedes conectar herramientas y APIs externas para extender el agente. Usa solo herramientas de fuentes confiables y limita los permisos al mínimo requerido. Las credenciales se pueden insertar de forma segura a través de transformaciones de encabezado del proxy de salida y nunca se exponen dentro de la zona de pruebas. El agente puede usar cualquier credencial a la que tenga acceso, por lo que solo debe proporcionar credenciales cuyo alcance completo esté dispuesto a otorgar.
- Usa cuentas de servicio o claves de API con privilegios mínimos.
- Prefiere los tokens de corta duración a las claves de larga duración.
- Solo proporciona credenciales cuyo alcance completo estés dispuesto a otorgar.
- Rota las credenciales periódicamente.
Para obtener detalles sobre cómo configurar las transformaciones de encabezado, consulta Credenciales.
Supervisión humana
Siempre verifica los resultados (código generado, transformaciones de datos, cambios de configuración) antes de implementarlos, especialmente para las tareas que modifican datos o interactúan con sistemas externos.
Precios
Los agentes administrados usan un modelo de pago por uso basado en los tokens del modelo de Gemini y el uso de herramientas. Una sola interacción puede activar varios bucles de razonamiento, que suelen consumir entre 100,000 y 3 millones de tokens. El procesamiento de entorno no se factura durante la versión preliminar. Consulta los costos estimados para ver los desgloses por tarea. Los agentes administrados también están disponibles en el nivel gratuito con un límite de frecuencia y una cuota de uso gratuitos.
Límites
| Límite | Descripción |
|---|---|
| Duración del entorno | Los entornos se borran de forma permanente después de 7 días de inactividad. |
| VM Spin-down | Las VMs se apagan después de un breve período de inactividad para conservar recursos. La siguiente solicitud restablece el estado (con un inicio en frío). |
| Software preinstalado | Entorno basado en Ubuntu con Python 3.12 y Node.js 22. Para obtener más información sobre la imagen base del entorno, consulta Software preinstalado. |
| Cantidad máxima de agentes | Puedes tener hasta 1,000 agentes administrados. |
Frameworks de agentes
También puedes compilar agentes con Gemini usando estos frameworks y SDKs:
- LangChain / LangGraph: Crea flujos de aplicaciones complejos y con estado, y sistemas multiagente con estructuras de gráficos.
- LlamaIndex: Conecta agentes de Gemini a tus datos privados para flujos de trabajo mejorados con RAG.
- CrewAI: Organiza agentes de IA autónomos y colaborativos que interpretan roles.
- Vercel AI SDK: Compila interfaces de usuario y agentes potenciados por IA en JavaScript o TypeScript.
- ADK de Google: Es un framework de código abierto para crear y organizar agentes de IA interoperables.
- SDK de Antigravity: Compila agentes autónomos de IA con las mismas herramientas, el mismo bucle de agente y la misma administración de contexto que impulsan Google Antigravity, programable en Python.