Polski
Zacznij

Agent Sandboxes Sam się wstrzymuje w bezczynności

Bezczynne sandboxy same się wstrzymują i zatrzymują

Nie piszesz kodu, który sprząta po agencie. Trzy liczniki każdego sandboxa decydują, czym staje się bezczynny: po 5 minutach wstrzymanym, po 30 zatrzymanym, nigdy usuniętym. Każdy ustawiasz osobno dla sandboxa, a 0 go wyłącza.

Co liczy się jako bezczynność

Sandbox jest bezczynny, gdy nic się w nim nie dzieje: brak wywołań i otwartych strumieni, otwartych linków, sesji SSH i żądań do jego portów, żadna tura agenta nie trwa i nie działa żadne polecenie uruchomione z keep_awake. Sam proces w tle nie trzyma go na nogach: gdy sandbox się wstrzymuje, proces zamarza razem z nim i działa dalej po wybudzeniu. Każdy serwer sprawdza każdy swój sandbox raz na sekundę.

Trzy liczniki: automatyczne wstrzymanie, zatrzymanie i usunięcie

  • pause_after_idle_seconds, domyślnie 300: działający sandbox się wstrzymuje, z zachowaniem pamięci i procesów, za 30% ceny działania.
  • stop_after_idle_seconds, domyślnie 1800: działający albo wstrzymany sandbox się zatrzymuje; procesy się kończą, a dysk trafia do magazynu obiektów za 0,03 $ miesięcznie za GiB własnych danych.
  • delete_after_idle_seconds, domyślnie 0, czyli nigdy: sandbox w dowolnym stanie jest usuwany.

Wszystkie trzy liczą jeden czas: od chwili, gdy coś ostatnio działo się w sandboxie. Licznik zatrzymania nie dłuższy niż licznik wstrzymania zatrzymuje działający sandbox bez wstrzymywania go najpierw. get_sandbox mówi, co cykl życia zrobi dalej i kiedy, w next_state i next_state_time. Liczniki ustawiasz przy tworzeniu sandboxa, zmieniasz później przez update_sandbox, a szablon może je przekazać każdemu sandboxowi, który z niego powstanie.

from pethost.sandboxes import Lifecycle, Sandboxes, SandboxSettings

sandboxes = Sandboxes()  # czyta PETHOST_TOKEN
lifecycle = Lifecycle(
    pause_after_idle_seconds=60,  # wstrzymany po minucie bezczynności
    stop_after_idle_seconds=3600,  # zatrzymany po godzinie bezczynności
    delete_after_idle_seconds=7 * 86400,  # usunięty po tygodniu bezczynności
)
sandbox = sandboxes.create_sandbox("base", settings=SandboxSettings(lifecycle=lifecycle))

# Praca, do której nikt nie sięga, gdy trwa: keep_awake odsuwa wstrzymanie, najwyżej na godzinę.
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'

Gdy serwerowi zaczyna brakować zasobów

Serwer może wstrzymać albo zatrzymać sandboxy przed ich licznikami. Gdy brakuje mu pamięci, wstrzymuje działające sandboxy bezczynne od minuty lub dłużej; gdy brakuje mu dysku, zatrzymuje wstrzymane sandboxy najdłużej bezczynne. W żadnym przypadku nic nie ginie: wstrzymany sandbox budzi się jak każdy inny, zatrzymany startuje od nowa ze swojego dysku, a state_message mówi, dlaczego tak się stało.

Budzenie zatrzymanego sandboxa

Wywołanie do zatrzymanego sandboxa jest domyślnie odrzucane (FAILED_PRECONDITION ze Stopped), a żądanie do jego portu dostaje 503, dopóki resume_sandbox go nie uruchomi. Z włączonym wake_when_stopped zatrzymany sandbox budzi się przy wywołaniu, logowaniu SSH albo żądaniu do portu, tak jak wstrzymany: w ok. 0,2 s albo ok. 10 s na GiB, gdy dysk trzeba ściągnąć z magazynu obiektów. Jego vCPU liczą się wtedy do twojego planu, także gdy jest zatrzymany. To dobre ustawienie dla sandboxa, który od czasu do czasu wywołuje webhook.

Ile kosztuje bezczynność

Żaden sandbox nie ma maksymalnego czasu życia: trzymany na nogach działa, dopóki go nie zatrzymasz, a zostawiony w spokoju na każdym kroku kosztuje mniej. Weź jeden sandbox SMALL, w którym agent pracuje 2 godziny dziennie, a przez pozostałe 22 jest bezczynny, przez 30-dniowy miesiąc. Wstrzymywany w bezczynności kosztuje 4,64 $ zużycia: 60 godzin po 0,018 $ i 660 po 0,0054 $. Gdyby cały czas działał, kosztowałby 12,96 $. Zatrzymywany w bezczynności, z 5 GiB własnych danych, kosztuje 1,22 $, ale każdy start uruchamia go wtedy od nowa z dysku, bez jego procesów. Rozliczanie co do sekundy mówi, jak liczymy każdą z tych sekund.

Jak to wypada na tle innych

Inni dostawcy ograniczają czas życia sandboxa. Według ich stron z 21 listopada 2026 sesje w E2B trwają do 1 godziny w planie Hobby i do 24 godzin w planie Pro, a wstrzymanie liczy czas od nowa; sandboxy Modala żyją domyślnie 5 minut, a najwyżej 24 godziny; a sesje Vercel Sandbox trwają 45 minut w planie Hobby i 24 godziny w planie Pro. Pethost nie stawia limitu: sandbox wstrzymuje się i zatrzymuje według swoich liczników i żyje, dopóki go nie usuniesz ty albo ustawiony przez ciebie licznik usunięcia.

Przeczytaj dokumentację

Pytania

Czy długi build zostanie wstrzymany w połowie?

Nie, jeśli uruchomisz go z keep_awake: sandbox nie wstrzyma się z bezczynności, dopóki to polecenie działa. Daj mu też timeout_seconds, żeby polecenie, które się zawiesi, nie trzymało go na nogach na zawsze.

Czy sandbox może się nigdy nie wstrzymywać?

Tak: ustaw pause_after_idle_seconds na 0. Wtedy działa, rozliczany jak działający, aż do licznika zatrzymania albo do chwili, gdy go zatrzymasz.

Co budzi zatrzymany sandbox?

resume_sandbox, a z włączonym wake_when_stopped każde wywołanie do niego, logowanie SSH albo żądanie do jednego z jego portów.

Czy automatyczne wstrzymanie i zatrzymanie coś usuwają?

Nie. Wstrzymanie zachowuje pamięć, procesy i dysk, zatrzymanie zachowuje dysk, a nic nie jest usuwane, chyba że ustawisz delete_after_idle_seconds.

Czy jest maksymalny czas życia?

Nie. Sandbox żyje, dopóki go nie usuniesz ty albo ustawiony przez ciebie licznik usunięcia.

Powiązane

Daj swojemu agentowi komputer w 0,15 s

Zacznij darmowy okres próbny