Sandbox Mode: cómo Antigravity controla tus agentes IA

El Sandbox Mode en Antigravity es la función que garantiza que un agente de IA solo ejecute comandos e instale librerías dentro de las carpetas que tú autorizas. Si trabajas con microservicios y te preocupa que un agente modifique archivos fuera de tu proyecto, aquí entiendes cómo blindar tu entorno.

Partimos de una plataforma que ya corre con tres microservicios activos mediante comandos npm run dev. La pregunta de fondo es simple pero incómoda: cuando le pides a un agente que ejecute esos comandos, ¿qué acceso real tiene a tu máquina? Ahí es donde entran dos conceptos que conviene distinguir bien.

Qué diferencia hay entre workspace isolation y sandbox mode

Ambos protegen tu entorno, pero no hacen lo mismo. El primero delimita carpetas; el segundo controla la ejecución de comandos.

El workspace isolation asegura que, aunque los comandos corran directamente en tu terminal, la plataforma solo tenga acceso a carpetas específicas [1:38]. Es una barrera de alcance: le dices al agente dónde puede mirar.

El problema aparece cuando un IDE necesita instalar librerías. En Python usas entornos virtuales, pero hay lenguajes que no tienen ese tipo de aislamiento, y entonces la herramienta te pide escribir e instalar directamente en tu máquina [2:15]. El resultado es incómodo: terminas con muchas librerías instaladas de las que ni siquiera eres consciente.

¿Qué es el Sandbox Mode en Antigravity? Es un modo que ejecuta los comandos del agente dentro de un entorno aislado, de modo que cualquier acción fuera de tu carpeta autorizada requiere tu permiso explícito antes de correr.

Qué herramientas usa Antigravity según tu sistema operativo

Antigravity no crea el entorno aislado de la misma forma en todos lados. Depende del sistema que uses.

• En MacBook se apoya en Sandbox Exec [3:05].
• En Linux utiliza NS Jail [3:10].
• En Windows el componente todavía está en desarrollo, así que si usas ese sistema vale la pena revisar si ya está disponible [3:14].

Para verlo en acción, la configuración se ajusta en Settings, pestaña General. Ahí cambias la opción de folders a always ask y la de command execution a modo sandbox [3:30]. Con eso, el comportamiento del agente cambia por completo.

Cómo reacciona el agente cuando intenta salir del sandbox

La mejor forma de probarlo es pedirle algo que no debería poder hacer. En la clase se le pidió crear un archivo llamado fuga.txt en la carpeta Documentos [3:55].

El resultado fue claro: el sistema pidió permiso específico para modificar ese archivo, porque estaba fuera de la carpeta autorizada. Al negar la operación, el agente intentó un truco conocido: ejecutar un comando directo para sobrescribir el archivo y así saltarse los permisos de escritura.

Y aquí viene lo interesante. En algunos IDEs esa maniobra funciona y burla los permisos. En Antigravity no. Siempre te pregunta si un comando necesita hacer cambios fuera del sandbox, incluso cuando ese comando no representa una modificación directa a un archivo [4:40].

¿Por qué el agente intenta sobrescribir un archivo con un comando? Porque los modelos no comprenden de forma intrínseca sus propios límites. Intentan cumplir la tarea por cualquier vía, y por eso necesitas una capa como el sandbox que valide cada acción externa.

Por qué npm install tarda tanto dentro del sandbox

Hay un efecto secundario que probablemente te va a pasar. Al crear un nuevo microservicio, el comando npm install puede tardar muchísimo en correr [5:10].

La causa es directa: el agente está intentando ejecutar la instalación fuera del sandbox y se queda atorado en un ciclo donde no puede hacer cambios en tu máquina. La solución es sencilla.

1. Detén el proceso cuando notes que se cuelga.
2. Dile al agente cuál fue el problema con NPM.
3. Espera a que solicite permiso correctamente para correr npm install fuera del sandbox.
4. Autoriza la operación con un sí.

Ese pequeño diálogo convierte un cuelgue silencioso en una petición de permiso explícita, que es justo lo que buscamos. La plataforma solo ejecuta lo que tú autorizas, sin excepciones.

Cómo extender el sandbox a cada microservicio

Este comportamiento no se limita a un solo servicio. Puedes aplicarlo a todos.

Para lograrlo, generas archivos de agente en cada una de las subcarpetas, tal como se hizo al inicio del proyecto [6:20]. Así cada microservicio hereda las mismas reglas de aislamiento y control de comandos.

Este enfoque resuelve una de las mayores preocupaciones del desarrollo asistido por IA de hace apenas unos meses: la incertidumbre sobre qué corría realmente en tu entorno. Con Antigravity tienes la certeza de que solo lo que necesitas se está ejecutando, y únicamente en los entornos que especificas.

En el flujo del curso, este paso también incluyó crear un microservicio extra usando el scaffold del Budget Service con la plantilla de Gemini [0:40], un movimiento pensado para llegar al final con una plataforma completamente funcional.

¿Ya probaste activar el modo sandbox en tu propio proyecto? Cuéntame en los comentarios qué comando intentó saltarse tus permisos primero.