Español
Empezar

Agent Sandboxes Se pausa solo si está inactivo

Los sandboxes inactivos se pausan y se detienen solos

No escribes el código que limpia lo que deja un agente. Tres temporizadores en cada sandbox deciden en qué se convierte uno inactivo: en pausa tras 5 minutos, detenido tras 30, nunca eliminado. Cada uno se configura por sandbox, y 0 lo desactiva.

Qué cuenta como inactivo

Un sandbox está inactivo mientras no pasa nada en él: ninguna llamada a él ni ningún stream abierto, ningún enlace abierto, sesión SSH ni petición a uno de sus puertos, ningún turno de agente en curso y ningún comando en ejecución iniciado con keep_awake. Un proceso en segundo plano por sí solo no lo mantiene despierto: cuando el sandbox se pausa, el proceso se congela con él y sigue al despertar. Cada servidor revisa cada uno de sus sandboxes una vez por segundo.

Los tres temporizadores: pausa, detención y eliminación automáticas

  • pause_after_idle_seconds, 300 por defecto: un sandbox en ejecución se pausa, con su memoria y sus procesos conservados, al 30 % de su precio en ejecución.
  • stop_after_idle_seconds, 1800 por defecto: un sandbox en ejecución o en pausa se detiene; sus procesos terminan, y su disco pasa al almacenamiento de objetos a 0,03 US$ por GiB al mes de sus propios datos.
  • delete_after_idle_seconds, 0 por defecto, es decir, nunca: un sandbox en cualquier estado se elimina.

Los tres usan un solo reloj, el tiempo desde que pasó algo por última vez en el sandbox. Un temporizador de detención que no supera al de pausa detiene un sandbox en ejecución sin pausarlo antes. get_sandbox dice qué hará el ciclo de vida a continuación y cuándo, en next_state y next_state_time. Configuras los temporizadores al crear un sandbox, los cambias después con update_sandbox, y una plantilla puede llevarlos para cada sandbox creado a partir de ella.

from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings

sandboxes = Sandboxes()  # lee PETHOST_TOKEN
lifecycle = Lifecycle(
    pause_after_idle_seconds=60,  # en pausa tras un minuto inactivo
    stop_after_idle_seconds=3600,  # detenido tras una hora inactivo
    delete_after_idle_seconds=7 * 86400,  # eliminado tras una semana inactivo
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))

# Trabajo al que nadie llama mientras se ejecuta: keep_awake aplaza la pausa, una hora como máximo.
install = "python3 -m venv env && env/bin/pip install pandas scikit-learn"
sandboxes.run_command(sandbox.sandbox_id, command=install, keep_awake=True, timeout_seconds=3600, wait_seconds=0)
id=$(pethost sandbox new --pause-after 1m --stop-after 1h --delete-after 168h)
pethost sandbox run "$id" --keep-awake --timeout 1h -d -- 'python3 -m venv env && env/bin/pip install pandas scikit-learn'

Cuando a un servidor le falta espacio

Un servidor puede pausar o detener sandboxes antes de sus temporizadores. Cuando le falta memoria, pausa los sandboxes en ejecución que llevan un minuto o más inactivos; cuando le falta disco, detiene los sandboxes en pausa que llevan más tiempo inactivos. En ningún caso se pierde nada: uno en pausa despierta como cualquier otro, uno detenido arranca de nuevo desde su disco, y state_message dice por qué pasó.

Despertar un sandbox detenido

Una llamada a un sandbox detenido se rechaza por defecto (FAILED_PRECONDITION con Stopped), y una petición a uno de sus puertos recibe un 503, hasta que resume_sandbox lo inicia. Con wake_when_stopped activado, un sandbox detenido despierta con una llamada, un inicio de sesión SSH o una petición a un puerto, igual que uno en pausa: en unos 0,2 s, o en unos 10 s por GiB si hay que traer su disco de vuelta del almacenamiento de objetos. Sus vCPU cuentan entonces para tu plan mientras está detenido. Sirve para un sandbox al que un webhook llama de vez en cuando.

Cuánto cuesta el tiempo inactivo

Ningún sandbox tiene una vida máxima: uno que se mantiene despierto se ejecuta hasta que lo detienes, y uno que se deja solo cuesta menos en cada paso. Toma un sandbox SMALL en el que un agente trabaja 2 horas al día y que deja inactivo las otras 22, durante un mes de 30 días. En pausa mientras está inactivo, cuesta 4,64 US$ de uso: 60 horas a 0,018 US$ y 660 a 0,0054 US$. Si siguiera en ejecución, costaría 12,96 US$. Detenido mientras está inactivo, con 5 GiB de datos propios, cuesta 1,22 US$, pero entonces cada inicio lo arranca desde su disco, sin sus procesos. La facturación por segundo explica cómo se cuenta cada uno de esos segundos.

Cómo se compara

Otros proveedores limitan cuánto vive un sandbox. Según sus páginas el 21 de noviembre de 2026, las sesiones de E2B duran hasta 1 hora en Hobby y 24 horas en Pro, y una pausa reinicia la cuenta; los sandboxes de Modal viven 5 minutos por defecto y 24 horas como máximo; y las sesiones de Vercel Sandbox duran 45 minutos en Hobby y 24 horas en Pro. Pethost no pone límite: un sandbox se pausa y se detiene según sus temporizadores, y vive hasta que tú, o un temporizador de eliminación que configures, lo elimina.

Leer la documentación

Preguntas

¿Se pausará una compilación larga a mitad?

No si la inicias con keep_awake: el sandbox no se pausa por inactividad mientras se ejecuta ese comando. Dale también timeout_seconds, para que un comando que se cuelga no lo mantenga despierto para siempre.

¿Puede un sandbox no pausarse nunca?

Sí: pon pause_after_idle_seconds a 0. Entonces se ejecuta, facturado como en ejecución, hasta su temporizador de detención o hasta que lo detengas.

¿Qué despierta un sandbox detenido?

resume_sandbox, o, con wake_when_stopped activado, cualquier llamada a él, inicio de sesión SSH o petición a uno de sus puertos.

¿La pausa y la detención automáticas eliminan algo?

No. Una pausa conserva la memoria, los procesos y el disco, una detención conserva el disco, y no se elimina nada salvo que configures delete_after_idle_seconds.

¿Hay una vida máxima?

No. Un sandbox vive hasta que lo eliminas, o hasta que lo hace un temporizador de eliminación que configuraste.

Relacionado

Dale a tu agente una VM en 0,15 s

Empezar la prueba gratis