Cómo usar subagentes paralelos en Google Antigravity (para dummies)

Uno de los superpoderes de Google Antigravity es que puede lanzar múltiples agentes trabajando en paralelo sin bloquear tu flujo de trabajo. Mientras el agente principal avanza con tu tarea, otros agentes en segundo plano investigan el código, corren tests o consultan documentación — todo al mismo tiempo. Esta guía explica cómo funciona y cómo aprovecharlo.

Si no conoces los fundamentos de Antigravity, empieza por cómo usar Google Antigravity paso a paso.

¿Qué es un subagente en Antigravity?

Un subagente es una sesión independiente de agente que el agente principal lanza para delegar trabajo específico. Los subagentes corren de forma asíncrona — el agente principal no espera a que terminen, sigue trabajando en paralelo.

Cada subagente tiene su propio contexto (no hereda la conversación del padre), su propio conjunto de herramientas definido por el padre, y puede trabajar en la misma carpeta o en un worktree aislado.

El agente principal puede lanzar múltiples subagentes simultáneamente y los subagentes pueden comunicarse entre sí enviando mensajes usando sus IDs únicos.

Subagentes integrados (no necesitas configurarlos)

Antigravity viene con tres subagentes especializados listos para usar:

• research: optimizado para investigar la base de código, navegar la estructura de archivos y responder preguntas sobre el proyecto sin modificar nada.
• browser: controla Chrome para automatizar tareas web. Se invoca con el comando /browser en el chat.
• self: un clon exacto del agente actual, con el mismo prompt del sistema y las mismas herramientas. Útil para tareas que requieren el mismo nivel de capacidad que el agente principal.

Cómo gestionar subagentes: el panel /agents

En la CLI, escribe /agents para abrir el panel de gestión de subagentes. Ahí ves:

• Lista de todos los subagentes activos, completados o terminados
• Estado de cada uno (running, done, killed, error)
• El paso actual que está ejecutando cada subagente

Selecciona cualquier subagente y presiona Enter para ver su conversación completa: pasos, razonamiento interno y outputs de herramientas. Puedes monitorear exactamente qué está haciendo cada agente.

Aprobaciones sin perder el hilo

Cuando un subagente necesita ejecutar algo que requiere tu aprobación (como correr un comando o escribir un archivo), Antigravity te avisa sin interrumpir tu trabajo:

• Fast Path Alert: aparece justo encima de tu campo de texto una notificación con la acción pendiente. Presiona Ctrl+K para aprobarla instantáneamente sin cambiar de pantalla.
• Teleport (Alt+J): salta directamente al subagente que está esperando aprobación. Aprueba o rechaza y vuelve a tu conversación principal.

Estados de los subagentes

Un subagente puede estar en uno de tres estados:

• Running: está ejecutando activamente. Puedes cancelarlo con el botón "Stop Subagent" en el panel.
• Idle: terminó su tarea y le envió los resultados al agente padre. Puede ser despertado nuevamente si recibe un mensaje.
• Killed: terminado permanentemente. Su historial de conversación sigue visible, pero no puede volver a ejecutarse. Los worktrees temporales se limpian automáticamente.

Límite de subagentes anidados

Los subagentes pueden lanzar sus propios subagentes, creando jerarquías. El límite es 10 niveles de profundidad para evitar consumo excesivo de recursos. En la práctica, la mayoría de los casos de uso se resuelven con 2-3 niveles.

Seguridad y herencia de permisos

Los subagentes heredan los permisos de seguridad del agente padre. Un subagente no puede hacer nada que el padre no tenga permitido. Si el padre tiene bloqueado rm -rf, el subagente también lo tiene bloqueado — automáticamente.

Si un subagente necesita un permiso adicional, la solicitud sube al panel de la UI para que tú la apruebes manualmente.

Tareas programadas (Scheduled Tasks)

Antigravity 2.0 permite programar conversaciones automáticas en horarios definidos usando el comando /schedule o configurando Cron Sidecars.

Casos de uso típicos:

• Revisión diaria de código al inicio de la jornada: "Dame un resumen de los cambios de ayer y cualquier issue abierto"
• Monitoreo periódico: "Cada hora, verifica que los endpoints de la API respondan correctamente"
• Actualizaciones automáticas: "Cada lunes, busca nuevas versiones de dependencias y crea un PR con las actualizaciones"

Los sidecars de cron se configuran en ~/.gemini/config/sidecars/ con un archivo sidecar.json:

{
  "builtin": "schedule",
  "args": [
    "0 9 * * 1",
    "agentapi",
    "new-conversation",
    "Dame el resumen de la semana"
  ]
}

/teamwork-preview: multi-agente avanzado (plan Ultra)

El comando /teamwork-preview activa un modo especial (exclusivo del plan Ultra, $200/mes) donde Antigravity lanza un equipo de agentes colaborando con recuperación de errores automática y coordinación integrada.

La diferencia con los subagentes normales: en teamwork, los agentes tienen roles definidos y coordinación explícita. Tú defines el objetivo de alto nivel y la plataforma gestiona toda la orquestación.

Es la opción para proyectos extremadamente complejos: migraciones de sistema completas, refactorizaciones masivas de código base, o auditorías de seguridad que requieren múltiples perspectivas simultáneas.

Subagentes personalizados

El agente puede definir sus propios subagentes en tiempo de ejecución usando la herramienta define_subagent. Puedes configurar:

• Un prompt de sistema específico para el rol del subagente
• Qué herramientas tiene acceso: solo lectura, lectura+escritura, o también subagentes propios
• Si puede usar herramientas MCP

Los subagentes personalizados están disponibles para ser invocados múltiples veces durante la misma conversación.

En resumen

Los subagentes de Antigravity permiten paralelizar trabajo complejo sin que tengas que microgestionar cada tarea. El panel /agents te da visibilidad completa, los atajos de teclado te permiten aprobar acciones sin perder el hilo, y las tareas programadas automatizan flujos recurrentes.

En Aldama usamos estas capacidades para orquestar proyectos de desarrollo de software con IA. Si quieres saber cómo integramos agentes en flujos de trabajo reales para nuestros clientes, es exactamente lo que hacemos. Sin humo.