Español
Empezar

Agent Sandboxes Cada comando, host y turno

Mira todo lo que hizo un sandbox

Cuando la ejecución de un agente sale mal, quieres saber qué pasó dentro de su sandbox. La observabilidad del sandbox guarda la respuesta: métricas y un registro de cada comando, cada host alcanzado y cada turno de agente, con la misma API que los ejecuta.

Métricas del sandbox

get_sandbox_metrics responde con la CPU, donde el 100 % es todas las vCPU ocupadas, la memoria en uso, el disco en uso y los bytes de entrada y de salida, como puntos promediados por intervalo: la última hora por defecto, o cualquier periodo de las últimas 24 horas, con un intervalo de 5 s o más, hasta 1000 puntos. El servidor de un sandbox conserva sus métricas 24 horas.

Eventos: qué pasó, a medida que pasaba

Cada sandbox registra lo que pasó en él, del más antiguo al más reciente, como una lista que recorres por páginas o un stream en tiempo real que sigues desde cualquier punto:

  • Ciclo de vida: creado, pausado, detenido, reanudado, cambio de tamaño y eliminado, cada uno con su motivo, como una petición, la inactividad, un despertar o un fallo; una creación indica su tamaño, y un fork su original.
  • Comandos que terminaron: los primeros 1024 bytes del comando, su código de salida, cuánto tiempo se ejecutó y si lo inició la API, SSH o una terminal.
  • Salida, minuto a minuto por host y puerto: permitida o rechazada, sus conexiones, los bytes en cada sentido y los secretos puestos en sus peticiones.
  • Puertos, minuto a minuto: las peticiones, cuántas recibieron un 5xx y los bytes en cada sentido.
  • Turnos de agente: el agente, los primeros 200 caracteres del prompt, cómo terminó el turno y sus tokens de entrada y de salida.

Un sandbox conserva los 10.000 eventos más recientes de cada tipo, y una lista o un stream pueden traer solo los tipos que pidas. Registra hasta 600 comandos y turnos de agente por minuto; los que pasen de ahí se registran en los minutos siguientes.

from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # lee PETHOST_TOKEN
sandbox_id = sandboxes.list_sandboxes(name="api-dev").sandboxes[0].sandbox_id

points = sandboxes.get_sandbox_metrics(sandbox_id).points  # la última hora
print(max(point.cpu_percent for point in points), points[-1].memory_used_bytes)

for event in sandboxes.watch_sandbox_events(sandbox_id):  # lo que pasó hasta ahora, luego en tiempo real
    if event.command:
        print(event.time, event.command.exit_code, event.command.command)
    elif event.egress and not event.egress.allowed:
        print(event.time, "refused:", event.egress.host)
pethost sandbox events api-dev -f                    # todos los eventos, y luego los nuevos según llegan
pethost sandbox events api-dev --kind egress -n 50   # los últimos 50 eventos de salida

Comandos, transcripciones y uso

Además de los eventos, list_commands muestra lo que se ejecuta ahora, iniciado por la API, SSH o una terminal. get_command y watch_command dan la salida de un comando, los últimos 64 KiB y luego en tiempo real, y el sandbox conserva los últimos 100 comandos que terminaron.

watch_conversation transmite la conversación de un agente de programación: cada prompt, cada mensaje, cada llamada a herramienta con su entrada y su salida, y el final de cada turno. Una conversación se queda en el disco del sandbox: una pausa la conserva, un fork la lleva consigo y una plantilla la deja fuera.

Cada sandbox informa de los segundos que estuvo en ejecución y en pausa, de las GiB-hora que estuvo guardado y de lo que lleva costado, y list_usage da una fila por día, contador y tamaño, tal como se cobró. El panel web muestra las métricas y los eventos de un sandbox en su página.

Qué se conserva, y cuánto tiempo

Las métricas se conservan 24 horas, y los eventos, los 10.000 más recientes de cada tipo, mientras viva el sandbox. Cuando se elimina un sandbox, su registro se conserva 30 días, con su uso final, y sus eventos y métricas, un día.

Lo que aún no está hecho

Aún no hay webhooks ni exportación a OpenTelemetry. Para alimentar tu propio monitoreo, sigue el stream, o recorre la lista desde el id del último evento que leíste: el id de un evento posterior siempre es mayor, así que nunca lees uno dos veces. La guía de observabilidad tiene cada campo, y la página de la lista de destinos permitidos explica cómo se juzgan los hosts de los eventos de salida.

Leer la documentación

Preguntas

¿Cuánto tiempo se conservan las métricas de un sandbox?

24 horas, en el servidor del sandbox, con un intervalo de 5 s o más.

¿Puedo enviar los eventos a mi monitoreo?

Aún no por push: no hay webhooks ni exportación a OpenTelemetry. Sigue watch_sandbox_events, o consulta list_sandbox_events con el id del último evento que leíste.

¿Se conservan las transcripciones de un agente?

Sí, en el disco del sandbox, mientras viva el sandbox. Una pausa las conserva, y un fork las lleva consigo.

¿Puedo ver a qué hosts llegó un sandbox?

Sí. Sus eventos de salida listan cada host y puerto minuto a minuto, permitido o rechazado, con sus conexiones y los bytes en cada sentido.

¿Qué queda después de eliminar un sandbox?

Su registro, con su uso final, durante 30 días; sus eventos y métricas, durante un día.

Relacionado

Dale a tu agente una VM en 0,15 s

Empezar la prueba gratis