Dokumentacja Pethost Agent Sandboxes
Sandbox to linuksowa microVM do kodu, agentów kodujących i pulpitu z Chrome: maszyna wirtualna Firecracker z własnym jądrem i rootem w środku. Startuje z szablonu w ok. 0,15 s, wstrzymuje się razem z pamięcią i procesami, gdy nic się w nim nie dzieje, budzi przy następnym wywołaniu w ok. 0,1 s, a gdy dłużej jest bezczynny, zatrzymuje się do magazynu obiektów. Płacisz co do sekundy za to, co trzyma każdy stan.
W pamięci swojego serwera
Wykonuje twoje procesy i odpowiada na każde wywołanie.
0,018 $ za godzinę, SMALL
5 min bezczynności: wstrzymuje się
Następne wywołanie go budzi
Na dysku swojego serwera
Zachowuje pamięć, procesy i dysk.
0,0054 $ za godzinę, SMALL
30 min bezczynności: zatrzymuje się
W magazynie obiektów
Zachowuje dysk; jego procesy się kończą.
0,03 $ miesięcznie za GiB
ResumeSandbox uruchamia go ponownie, z plikami takimi, jakie zostawił
Od czego zacząć
W liczbach
- 0,15 s na start sandboxa, zmierzone przez panel oddalony o 16 ms od jego serwera
- 0,1 s na wybudzenie wstrzymanego, przy jego następnym wywołaniu
- 0,018 $ za godzinę przy 2 vCPU i 4 GiB, co do sekundy
- 30% tej ceny, gdy jest wstrzymany
Co robi sandbox
- Polecenia, pliki i terminal. Uruchom polecenie i poczekaj na jego port, edytuj plik przez dokładną zamianę, odbieraj wyjście na żywo albo otwórz terminal w przeglądarce: polecenia i pliki.
- Porty. Dowolny port pod
https://<port>-<id>.<server>, publiczny albo za tokenem: porty i podglądy. - Agenci kodujący. Claude Code, Codex i OpenCode są zainstalowani. Jedno wywołanie daje agentowi prompt, drugie przesyła na żywo każde jego wywołanie narzędzia: agenci kodujący.
- Pulpit. Chrome na ekranie 1280×800, który startuje przy pierwszym użyciu: kliknij, wpisz i zrób zrzut ekranu jednym wywołaniem albo oglądaj na żywo: sterowanie komputerem.
- Szablony, forki i wolumeny. Zapisz dysk sandboxa i uruchamiaj z niego nowe (szablony); skopiuj działający sandbox, razem z pamięcią, nawet do 100 kopii (forki); trzymaj dane na dysku poza sandboxami, na jednym serwerze (wolumeny).
- Sekrety i ruch wychodzący. Klucze API, których sandbox nigdy nie trzyma, i lista dozwolonych miejsc, z którymi może się łączyć: sekrety i ruch wychodzący.
- SSH i obserwowalność. Zwykłe
ssh,scpissh -L(SSH) oraz metryki, zdarzenia i zużycie każdego sandboxa (obserwowalność).
Agent Sandboxes i App Platform
Pethost ma dwa rodzaje przestrzeni roboczych. App Platform to maszyna z planu dla twoich aplikacji Docker Compose, w stałej cenie miesięcznej: jej dokumentacja to dokumentacja App Platform. Agent Sandboxes to temat tych stron: maszyny microVM, które twój kod albo twój agent uruchamia, używa i zatrzymuje przez API, rozliczane co do sekundy. Każda przestrzeń robocza jest jednego rodzaju, a jedno konto może mieć oba.
Wszystkie strony
Pierwsze kroki
-
Jak działają Pethost Agent Sandboxes
Czym jest sandbox, jego trzy stany RUNNING, PAUSED i STOPPED, co go budzi, dwa API oraz gdzie są jego pamięć, procesy i pliki.
-
Szybki start: twój pierwszy sandbox
Utwórz sandbox, uruchom polecenie, zapisz plik, otwórz port i posprzątaj: z Pythona, TypeScriptu, Go, Rusta, CLI pethost albo przez agenta.
-
Podłącz agenta do sandboxów przez MCP
Daj Claude Code, Codexowi, Cursorowi albo Claude’owi sandboxy jako narzędzia: dodaj serwer MCP Pethost Agent Sandboxes i zaloguj się do przestrzeni roboczej.
Pojęcia
-
Cykl życia sandboxa: automatyczne wstrzymanie, zatrzymanie i bezczynność
Kiedy bezczynny sandbox się wstrzymuje, zatrzymuje albo jest usuwany: co liczy się jako aktywność, trzy liczniki, keep_awake, wake_when_stopped i wartości.
-
Ceny i rozliczanie sandboxów: co do sekundy, według stanu
Ile sandbox kosztuje za każdą sekundę działania, wstrzymania czy snu, co zawiera plan, darmowe starty i ich limity, okres próbny i przykłady z wyliczeniami.
-
Dobre praktyki Pethost Agent Sandboxes
Kilka wyborów, dzięki którym sandboxy startują szybko, kosztują mniej i są bezpieczne: szablony, wstrzymanie, zadania wsadowe, keep_awake, request_id, sekrety.
Zadania
-
Uruchamianie poleceń i edycja plików w sandboxie
Uruchamiaj polecenia w sandboxie i czekaj na ich wynik albo port, śledź długie na żywo, edytuj pliki przez dokładną zamianę i przenoś duże pliki linkami.
-
Porty i podglądy: adresy URL sandboxa
Daj dowolnemu portowi sandboxa adres HTTPS, publiczny albo za tokenem, poczekaj, aż serwer deweloperski zacznie nasłuchiwać, i trzymaj podglądy, które śpią.
-
Uruchamianie Claude Code, Codex i OpenCode w sandboxie
Daj Claude Code, Codexowi albo OpenCode prompt w sandboxie jednym wywołaniem, śledź jego wywołania narzędzi i zaloguj go bez wpuszczania klucza do sandboxa.
-
Sterowanie komputerem: Chrome na pulpicie w sandboxie
Kliknij, wpisz i zrób zrzut ekranu pulpitu z Chrome jednym wywołaniem, dla agenta sterującego komputerem, albo oglądaj ekran sandboxa na żywo w przeglądarce.
-
Szablony: sandboxy gotowe do pracy od startu
Zapisz dysk sandboxa jako szablon, z pakietami i obrazami Dockera, i uruchamiaj z niego nowe sandboxy na dowolnym serwerze w ok. 0,2 s.
-
Sekrety i ruch wychodzący: klucze, których sandbox nie trzyma
Daj sandboxowi klucze API, których nie trzyma, podstawiane przez proxy ruchu wychodzącego do wskazanych hostów, i ogranicz listą dozwolonych, dokąd się łączy.
-
Fork sandboxa, razem z pamięcią i procesami
Skopiuj działający sandbox, z pamięcią, procesami i dyskiem, nawet do 100 sandboxów jednym wywołaniem, żeby naraz próbować kilku rzeczy od tego samego miejsca.
-
Wolumeny: dysk, który przeżywa sandboxy
Utwórz wolumen, zamontuj go w sandboxach pod ścieżką, do zapisu w jednym albo do odczytu w wielu, i dowiedz się, gdzie leży i ile kosztuje.
-
SSH do sandboxa: powłoka, scp, SFTP i tunele
Loguj się do sandboxa zwykłym ssh, kopiuj pliki przez scp i SFTP, przekierowuj porty przez ssh -L, z kluczem przestrzeni roboczej albo tokenem jako hasłem.
-
Obserwowalność: metryki, zdarzenia i zużycie sandboxa
Odczytaj CPU, pamięć, dysk i sieć sandboxa, listuj i śledź na żywo jego cykl życia, polecenia, połączenia, żądania do portów i tury agentów, i zobacz koszt.
Referencja
-
Limity Pethost Agent Sandboxes
Wszystkie granice Pethost Agent Sandboxes w jednym miejscu: rozmiary, budżety planów, limity startów, sandboxa i wywołania, przechowywana historia i sieć.
-
Błędy API sandboxów i co z nimi zrobić
Każda odmowa API sandboxów, jej kod i typowany szczegół, co oznacza i co twój program albo agent powinien zrobić dalej.
Wypróbuj Pethost Agent Sandboxes
Okres próbny na 7 dni z 1 $ zużycia i 4 vCPU, z kartą. Potem plan od 20 $ miesięcznie, który zawiera tyle samo zużycia.