Español
Menú de la documentación

Documentación de Pethost Agent Sandboxes

Actualizado · 3 min de lectura

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.

RUNNING

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

PAUSED

En el disco de su servidor

Conserva memoria, procesos y disco.

0,0054 US$ la hora, SMALL

Inactivo 30 min: se detiene

STOPPED

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ó

El ciclo de vida por defecto. Cada temporizador se puede cambiar o desactivar, y un sandbox nunca se elimina salvo que lo pidas: ciclo de vida e inactividad.

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, scp y ssh -L normales (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

Tareas

Referencia

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.

Empezar la prueba gratis