Documentación de Pethost Agent Sandboxes
Un sandbox es una microVM Linux para código, agentes de programación y un escritorio con Chrome: una VM Firecracker con su propio kernel, y root dentro. Se inicia desde una plantilla en unos 0,15 s, se pausa con su memoria y sus procesos cuando no pasa nada en él, despierta con la siguiente llamada en unos 0,1 s y se detiene en almacenamiento de objetos cuando sigue inactivo más tiempo. Pagas por segundo lo que conserva cada estado.
En la memoria de su servidor
Ejecuta tus procesos y responde a cada llamada.
0,018 US$ la hora, SMALL
Inactivo 5 min: se pausa
La siguiente llamada lo despierta
En el disco de su servidor
Conserva memoria, procesos y disco.
0,0054 US$ la hora, SMALL
Inactivo 30 min: se detiene
En almacenamiento de objetos
Conserva su disco; sus procesos terminan.
0,03 US$ por GiB al mes
ResumeSandbox lo inicia de nuevo, con sus archivos como los dejó
Por dónde empezar
En cifras
- 0,15 s para iniciar un sandbox, medido a través de un panel a 16 ms de su servidor
- 0,1 s para despertar uno en pausa, con su siguiente llamada
- 0,018 US$ la hora por 2 vCPU y 4 GiB, por segundo
- 30 % de ese precio mientras está en pausa
Qué hace un sandbox
- Comandos, archivos y una terminal. Ejecuta un comando y espera a su puerto, edita un archivo por reemplazo exacto, transmite la salida o abre una terminal en un navegador: comandos y archivos.
- Puertos. Cualquier puerto en
https://<port>-<id>.<server>, público o detrás de un token: puertos y previsualizaciones. - Agentes de programación. Claude Code, Codex y OpenCode vienen instalados. Una llamada le da un prompt a un agente, y otra transmite cada llamada a herramienta que hace: agentes de programación.
- Un escritorio. Chrome en una pantalla de 1280×800, que se inicia con su primer uso: haz clic, escribe y toma una captura de pantalla en una llamada, o míralo en tiempo real: computer use.
- Plantillas, forks y volúmenes. Guarda el disco de un sandbox e inicia otros nuevos desde él (plantillas); copia un sandbox en ejecución, memoria incluida, en hasta 100 copias (forks); guarda datos en un disco fuera de cualquier sandbox, en un servidor (volúmenes).
- Secretos y salida. Claves de API que el sandbox nunca tiene, y una lista de destinos permitidos a los que puede conectarse: secretos y salida.
- SSH y observabilidad.
ssh,scpyssh -Lnormales (SSH), y las métricas, los eventos y el uso de cada sandbox (observabilidad).
Agent Sandboxes y App Platform
Pethost tiene dos tipos de espacio de trabajo. App Platform es la máquina de un plan para tus apps de Docker Compose, a un precio fijo al mes: su documentación es la documentación de App Platform. Agent Sandboxes es de lo que tratan estas páginas: microVM que tu código o tu agente inicia, usa y detiene a través de una API, facturadas por segundo. Cada espacio de trabajo es de un tipo, y una cuenta puede tener los dos.
Todas las páginas
Primeros pasos
-
Cómo funcionan Pethost Agent Sandboxes
Qué es un sandbox, sus tres estados RUNNING, PAUSED y STOPPED, qué lo despierta, las dos API y dónde viven su memoria, sus procesos y sus archivos.
-
Guía rápida: tu primer sandbox
Crea un sandbox, ejecuta un comando, escribe un archivo, abre un puerto y limpia: desde Python, TypeScript, Go, Rust, la CLI pethost o tu agente.
-
Conecta un agente a los sandboxes por MCP
Dale sandboxes como herramientas a Claude Code, Codex, Cursor o Claude: agrega el servidor MCP de Agent Sandboxes e inicia sesión en un espacio de trabajo.
Conceptos
-
Ciclo de vida de un sandbox: pausa, detención e inactividad
Cuándo un sandbox inactivo se pausa, se detiene o se elimina: qué es actividad, los tres temporizadores, keep_awake, wake_when_stopped y valores para cada uso.
-
Precios y facturación de los sandboxes: por segundo, por estado
Cuánto cuesta un sandbox cada segundo en ejecución, en pausa o detenido, qué incluye un plan, los inicios gratis y sus límites, la prueba gratis y ejemplos.
-
Buenas prácticas para Pethost Agent Sandboxes
Las decisiones que hacen que un sandbox se inicie rápido, cueste menos y sea seguro: plantillas, pausa, lotes, keep_awake, request_id, secretos y salida.
Tareas
-
Ejecuta comandos y edita archivos en un sandbox
Ejecuta comandos en un sandbox y espera su salida o su puerto, transmite los largos, edita archivos por reemplazo exacto y mueve archivos grandes con enlaces.
-
Puertos y previsualizaciones: las URL de un sandbox
Dale a cualquier puerto de un sandbox una dirección HTTPS, pública o detrás de un token, espera a que escuche un servidor y crea previsualizaciones que duermen.
-
Ejecuta Claude Code, Codex y OpenCode en un sandbox
Dale un prompt a Claude Code, Codex u OpenCode en un sandbox con una llamada, transmite sus llamadas a herramientas e inicia su sesión sin que la clave entre.
-
Computer use: Chrome en un escritorio dentro de un sandbox
Haz clic, escribe y toma una captura de un escritorio con Chrome en una llamada, para un agente de computer use, o mira la pantalla del sandbox en tiempo real.
-
Plantillas: sandboxes que se inician listos para trabajar
Guarda el disco de un sandbox como plantilla, con tus paquetes e imágenes de Docker, e inicia sandboxes nuevos desde ella en cualquier servidor en unos 0,2 s.
-
Secretos y salida: claves que un sandbox nunca tiene
Dale a un sandbox claves de API que nunca tiene, que el proxy de salida pone solo para los hosts que indiques, y limita adónde puede conectarse.
-
Haz un fork de un sandbox, memoria y procesos incluidos
Copia un sandbox en ejecución, con su memoria, sus procesos y su disco, en hasta 100 sandboxes en una llamada, para probar varias cosas a la vez desde un punto.
-
Volúmenes: un disco que sobrevive a los sandboxes
Crea un volumen, móntalo en sandboxes en un path, de lectura y escritura en uno o de solo lectura en muchos, y entiende dónde vive y cuánto cuesta.
-
SSH a un sandbox: shell, scp, SFTP y túneles
Inicia sesión en cualquier sandbox con ssh normal, copia archivos con scp y SFTP y redirige sus puertos con ssh -L, con una clave o un token como contraseña.
-
Observabilidad: métricas, eventos y uso de un sandbox
Lee la CPU, la memoria, el disco y la red de un sandbox, lista y sigue su ciclo de vida, comandos, conexiones, peticiones y turnos de agente, y ve cuánto costó.
Referencia
-
Límites de Pethost Agent Sandboxes
Todos los límites de Pethost Agent Sandboxes en un sitio: tamaños, presupuestos del plan, inicios, límites por sandbox y por llamada, historial y red.
-
Errores de la API de los sandboxes, y qué hacer
Cada rechazo de la API de los sandboxes, su código y su detalle tipado, qué significa y qué debe hacer después tu programa o tu agente.
Prueba Pethost Agent Sandboxes
Una prueba gratis de 7 días con 1 US$ de uso y 4 vCPU, con tarjeta. Después, un plan desde 20 US$ al mes, que incluye ese mismo importe en uso.