Polski
Zacznij

Agent Sandboxes Wstrzymanie z pamięcią

Wstrzymaj sandbox z pamięcią, obudź go w 0,1 s

Sandbox agenta przez większość życia czeka na model. Wstrzymanie zachowuje w nim wszystko, także działające procesy, za 30% ceny działania, a następne wywołanie budzi go w ok. 0,1 s dokładnie tam, gdzie był.

Co zachowuje wstrzymanie

Wstrzymany sandbox trzyma pamięć, procesy i dysk na dysku swojego serwera. Serwer deweloperski ma dalej otwarty port, sesja Pythona zachowuje zmienne, rozmowa agenta kodującego zostaje tam, gdzie była, a niedokończony build rusza od miejsca, w którym stanął. Sandbox wstrzymujesz jednym wywołaniem, pause_sandbox, albo zostawiasz to jego licznikowi bezczynności: domyślnie po 5 minutach, w których nic się w nim nie dzieje.

Co go budzi

Wszystko, co do niego sięga: polecenie, odczyt albo zapis pliku, otwarty strumień, prompt do agenta, logowanie SSH albo żądanie do jednego z jego portów. Nigdy nie musisz go najpierw wznawiać: wywołanie, które go potrzebuje, budzi go i dostaje odpowiedź. resume_sandbox jest na wypadek, gdy chcesz, żeby działał, choć nie ma nic do zrobienia.

Zmierzone na naszych serwerach: wznowienie trwa 41 ms na serwerze i 124 ms przez API; polecenie wysłane do wstrzymanego sandboxa odpowiada w 80 ms, razem z wybudzeniem; a wejście na adres podglądu wstrzymanego sandboxa trwa ok. 200 ms.

Jak działa wstrzymanie i wznowienie

Przy wstrzymaniu gość zapisuje swoje systemy plików, maszyna wirtualna staje, a serwer robi snapshot różnicowy: zapisuje tylko pamięć, którą maszyna wirtualna zmieniła od ostatniego snapshotu, i pomija ciągi stron z samymi zerami. Zaraz po utworzeniu wstrzymanie trwało w medianie 52 ms dla sandboxa SMALL i 85 ms dla LARGE, mierzone przez API.

Wstrzymany sandbox zachowuje swoje miejsce na serwerze: serwer trzyma pamięć, której będzie potrzebować wybudzenie, więc wybudzenia nigdy nie odmawiamy z braku miejsca. Dlatego sandbox wznawia się tylko tam, na tym samym Firecrackerze, procesorze i bazie, i dlatego wstrzymanie kosztuje 30% ceny działania, a nie nic.

from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # czyta PETHOST_TOKEN
sandbox = sandboxes.create_sandbox("base")

# Proces serwera; wywołanie odpowiada, gdy ten nasłuchuje na porcie 8000.
sandboxes.run_command(sandbox.sandbox_id, command="python3 -m http.server 8000", wait_for_port=8000)
sandboxes.pause_sandbox(sandbox.sandbox_id)  # pamięć, procesy i dysk zostają na jego serwerze

# To wywołanie go budzi i odpowiada ten sam proces serwera.
page = sandboxes.run_command(sandbox.sandbox_id, command="curl -s localhost:8000 | head -n 1")
print(page.stdout)
id=$(pethost sandbox new)
pethost sandbox run "$id" -d --wait-for-port 8000 -- python3 -m http.server 8000
pethost sandbox pause "$id"
pethost sandbox run "$id" -- 'curl -s localhost:8000 | head -n 1'   # budzi go

Ile kosztuje wstrzymany sandbox

Wstrzymany sandbox jest rozliczany za pełne sekundy po 30% ceny działania swojego rozmiaru, bez minimum: 0,0054 $ za godzinę dla SMALL, do 0,0432 $ dla XLARGE. Czas działania nigdy nie zamienia się w czas wstrzymania i żadna sekunda nie jest liczona dwa razy. Gdy restartujemy maszynę serwera, jego działające sandboxy są wstrzymywane i wznawiane po restarcie, a te sekundy nic nie kosztują.

Wstrzymać czy zatrzymać

Zatrzymanie to drugi sposób na trzymanie sandboxa, którego nie używasz. Wstrzymanie trzyma go w gotowości, zatrzymanie trzyma go tanio:

WstrzymanyZatrzymany
Gdzie jestNa dysku swojego serweraW magazynie obiektów
Co zostajePamięć, procesy i dyskDysk; procesy się kończą
Cena, SMALL0,0054 $ za godzinę0,03 $ miesięcznie za GiB własnych danych
Powrót do działaniaOk. 0,1 s, przy następnym wywołaniuOk. 0,2 s przez resume_sandbox albo ok. 10 s na GiB, gdy dysk trzeba ściągnąć z powrotem

Domyślnie sandbox zatrzymuje się po 30 minutach bezczynności, wstrzymany czy nie; cykl życia mówi, jak to zmienić.

Ograniczenia

Wstrzymanemu sandboxowi nie zmienisz rozmiaru: nowy rozmiar jest odrzucany, dopóki sandbox nie zostanie wznowiony albo zatrzymany. Gdy jest wstrzymany, jego vCPU liczą się do budżetu twojego planu, tak jak vCPU działającego. Gdy na dysku serwera zaczyna brakować miejsca, wstrzymane sandboxy najdłużej bezczynne są wcześniej zatrzymywane, z zachowaniem dysków, a state_message to mówi. Gdy przestrzeni roboczej skończy się i zużycie w planie, i saldo, jej wstrzymane sandboxy są zatrzymywane.

Jak to wypada na tle innych

Według ich stron z 21 listopada 2026: E2B też zachowuje pamięć i nic nie liczy za wstrzymany sandbox, ale za 2 vCPU i 4 GiB w działaniu liczy 0,1656 $ za godzinę, wobec 0,018 $ u nas, a jego dokumentacja podaje, że wstrzymanie trwa ok. 4 sekund na GiB pamięci, a wznowienie ok. 1 sekundy. Daytona wstrzymuje tylko swoją klasę maszyn wirtualnych z Linuksem, a za wstrzymanie liczy sam dysk. boat.dev nie ma wstrzymania: zatrzymanie usuwa maszynę wirtualną i zachowuje jej dysk.

Przeczytaj dokumentację

Pytania

Czy wstrzymanie i wznowienie sandboxa zachowuje działające procesy?

Tak, razem z pamięcią i dyskiem. Gdy sandbox jest wstrzymany, jego procesy są zamrożone z resztą pamięci, a po wybudzeniu działają dalej od miejsca, w którym były. Polecenie uruchomione z keep_awake nie pozwala sandboxowi się wstrzymać, dopóki działa: dla buildu albo zadania, na które nikt nie czeka.

Ile kosztuje wstrzymany sandbox?

30% ceny działania, co do sekundy: 0,0054 $ za godzinę dla SMALL, 0,0108 $ dla DEFAULT, 0,0216 $ dla LARGE i 0,0432 $ dla XLARGE.

Czy wybudzenie może się nie udać z braku miejsca?

Nie: wstrzymany sandbox zachowuje swoje miejsce na serwerze. Wybudzenie jest odrzucane tylko wtedy, gdy przestrzeń robocza ma więcej vCPU, niż jej plan teraz pozwala, na przykład po przejściu na mniejszy plan.

Wstrzymać sandbox czy go zatrzymać?

Wstrzymaj to, do czego niedługo wrócisz: zachowuje pamięć i procesy za 30% ceny działania i rusza w ok. 0,1 s. Zatrzymaj to, co może poczekać: procesy się kończą, dysk zostaje w magazynie obiektów, po 0,03 $ za GiB miesięcznie, a start uruchamia system od nowa z tego dysku.

Powiązane

Daj swojemu agentowi komputer w 0,15 s

Zacznij darmowy okres próbny