Deutsch
Loslegen

Agent Sandboxes Pausiert im Leerlauf von selbst

Sandboxes im Leerlauf pausieren und stoppen von selbst

Den Code, der hinter einem Agenten aufräumt, schreibst du nicht. Drei Timer an jeder Sandbox entscheiden, was aus einer im Leerlauf wird: pausiert nach 5 min, gestoppt nach 30, nie gelöscht. Jeder gilt pro Sandbox, und 0 schaltet ihn ab.

Was als Leerlauf zählt

Eine Sandbox ist im Leerlauf, solange nichts in ihr passiert: kein Aufruf in sie und kein offener Stream, kein offener Link, keine SSH-Sitzung und kein Request an einen ihrer Ports, kein laufender Turn eines Agenten und kein laufender Befehl, der mit keep_awake gestartet wurde. Ein Hintergrundprozess allein hält sie nicht wach: Pausiert die Sandbox, wird der Prozess mit ihr eingefroren und macht beim Aufwachen weiter. Jeder Server prüft jede seiner Sandboxes einmal pro Sekunde.

Die drei Timer: Auto-Pause, Auto-Stopp, Auto-Löschen

  • pause_after_idle_seconds, standardmäßig 300: Eine laufende Sandbox pausiert, RAM und Prozesse bleiben erhalten, zu 30 % ihres Preises im Betrieb.
  • stop_after_idle_seconds, standardmäßig 1800: Eine laufende oder pausierte Sandbox stoppt; ihre Prozesse enden, und ihre Disk geht für 0,03 $ pro GiB und Monat ihrer eigenen Daten in den Objektspeicher.
  • delete_after_idle_seconds, standardmäßig 0, also nie: Eine Sandbox in jedem Zustand wird gelöscht.

Alle drei laufen auf einer Uhr, der Zeit, seit zuletzt etwas in der Sandbox passiert ist. Ein Stopp-Timer, der nicht später als der Pause-Timer kommt, stoppt eine laufende Sandbox, ohne sie vorher zu pausieren. get_sandbox sagt in next_state und next_state_time, was der Lebenszyklus als Nächstes tut und wann. Du stellst die Timer beim Erstellen einer Sandbox ein, änderst sie später mit update_sandbox, und eine Vorlage kann sie für jede Sandbox mitbringen, die aus ihr entsteht.

from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings

sandboxes = Sandboxes()  # liest PETHOST_TOKEN
lifecycle = Lifecycle(
    pause_after_idle_seconds=60,  # pausiert nach einer Minute Leerlauf
    stop_after_idle_seconds=3600,  # gestoppt nach einer Stunde Leerlauf
    delete_after_idle_seconds=7 * 86400,  # gelöscht nach einer Woche Leerlauf
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))

# Arbeit, in die niemand hineinruft, solange sie läuft: keep_awake hält die Pause fern, höchstens eine Stunde.
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'

Wenn einem Server etwas knapp wird

Ein Server darf Sandboxes vor ihren Timern pausieren oder stoppen. Wird sein RAM knapp, pausiert er laufende Sandboxes, die eine Minute oder länger im Leerlauf sind; wird seine Disk knapp, stoppt er die pausierten Sandboxes, die am längsten im Leerlauf sind. So oder so geht nichts verloren: Eine pausierte Sandbox wacht auf wie jede andere, eine gestoppte startet wieder von ihrer Disk, und state_message sagt, warum es passiert ist.

Eine gestoppte Sandbox wecken

Ein Aufruf in eine gestoppte Sandbox wird standardmäßig abgelehnt (FAILED_PRECONDITION mit Stopped), und ein Request an einen ihrer Ports bekommt 503, bis resume_sandbox sie startet. Mit wake_when_stopped wacht eine gestoppte Sandbox bei einem Aufruf, einem SSH-Login oder einem Request an einen Port auf wie eine pausierte: in etwa 0,2 s, oder in etwa 10 s pro GiB, wenn ihre Disk erst aus dem Objektspeicher zurückgeholt werden muss. Ihre vCPUs zählen dann auch gestoppt gegen deinen Tarif. Das passt für eine Sandbox, die ab und zu ein Webhook aufruft.

Was Leerlauf kostet

Keine Sandbox hat eine maximale Lebensdauer: Eine, die wach gehalten wird, läuft, bis du sie stoppst, und eine, die in Ruhe gelassen wird, kostet mit jedem Schritt weniger. Nimm eine SMALL-Sandbox, in der ein Agent täglich 2 Stunden arbeitet und die er die anderen 22 im Leerlauf lässt, über einen Monat mit 30 Tagen. Pausiert im Leerlauf kostet sie 4,64 $ Verbrauch: 60 Stunden zu 0,018 $ und 660 zu 0,0054 $. Liefe sie durch, kostete sie 12,96 $. Gestoppt im Leerlauf, mit 5 GiB eigenen Daten, kostet sie 1,22 $, aber dann bootet jeder Start sie von ihrer Disk, ihre Prozesse sind weg. Die sekundengenaue Abrechnung erklärt, wie jede dieser Sekunden zählt.

Im Vergleich

Andere Anbieter begrenzen, wie lange eine Sandbox lebt. So stand es am 21. November 2026 auf ihren Seiten: Bei E2B dauern Sitzungen bei Hobby bis zu 1 Stunde und bei Pro bis zu 24 Stunden, und eine Pause startet die Zählung neu; die Sandboxes von Modal leben standardmäßig 5 Minuten und höchstens 24 Stunden; und bei Vercel Sandbox dauern Sitzungen bei Hobby 45 Minuten und bei Pro 24 Stunden. Pethost setzt keine Grenze: Eine Sandbox pausiert und stoppt nach ihren Timern und lebt, bis du sie entfernst oder ein Lösch-Timer, den du gesetzt hast.

Doku lesen

Fragen

Wird ein langer Build mittendrin pausiert?

Nicht, wenn du ihn mit keep_awake startest: Die Sandbox pausiert nicht wegen Leerlaufs, solange dieser Befehl läuft. Gib ihm auch timeout_seconds mit, damit ein Befehl, der hängt, sie nicht für immer wach hält.

Kann eine Sandbox nie pausieren?

Ja: Setz pause_after_idle_seconds auf 0. Dann läuft sie und wird als laufend abgerechnet, bis ihr Stopp-Timer greift oder du sie stoppst.

Was weckt eine gestoppte Sandbox?

resume_sandbox, oder mit wake_when_stopped jeder Aufruf in sie, jeder SSH-Login und jeder Request an einen ihrer Ports.

Löschen Auto-Pause und Auto-Stopp etwas?

Nein. Eine Pause behält RAM, Prozesse und Disk, ein Stopp behält die Disk, und gelöscht wird nichts, außer du setzt delete_after_idle_seconds.

Gibt es eine maximale Lebensdauer?

Nein. Eine Sandbox lebt, bis du sie löschst oder bis ein Lösch-Timer, den du gesetzt hast, es tut.

Verwandte Funktionen

Gib deinem Agenten einen Computer in 0,15 s

Kostenlose Testphase starten