Polski
Zacznij

Agent Sandboxes Polecenia, pliki i terminal

Sandbox do wykonywania kodu dla agentów AI

Twój model pisze kod, sandbox go uruchamia, a wynik wraca w tym samym wywołaniu. Polecenia, pliki i terminale to jedno API, na które odpowiada serwer, na którym działa sandbox, a nie panel.

Wykonanie kodu jednym wywołaniem

Każdy sandbox to microVM Firecracker z własnym jądrem Linuksa i rootem w środku, uruchamiana z naszego szablonu base w ok. 0,15 s: to Ubuntu 24.04 z narzędziami do budowania, Pythonem 3, Node.js 22 i Dockerem. run_command uruchamia polecenie przez bash -lc jako user, który ma sudo, albo jako root, w dowolnym wskazanym katalogu. Wywołanie czeka do 45 sekund na koniec polecenia i odpowiada jego kodem wyjścia oraz ostatnimi 32 KiB jego stdout i stderr.

Trzy pola zmieniają to, na co czeka wywołanie:

  • wait_for_port odpowiada, gdy tylko coś zacznie nasłuchiwać na porcie, a polecenie działa dalej: npm run dev i 5173.
  • wait_seconds=0 odpowiada, gdy polecenie wystartuje. get_command znowu na nie czeka, a watch_command przesyła jego wynik na żywo: najpierw ostatnie 64 KiB, potem to, co przychodzi.
  • timeout_seconds kończy polecenie, które działa za długo. Bez niego polecenie kończy tylko stop_command: SIGTERM, a 10 s później SIGKILL.

Każda odpowiedź mówi, ile bajtów polecenie już wypisało; odeślij tę liczbę, a następna odpowiedź zawiera tylko to, co nowe. Z request_id ponowienie w ciągu 24 godzin niczego nie uruchamia drugi raz i odpowiada tym, co zrobiło pierwsze wywołanie. list_commands pokazuje, co teraz działa, łącznie z poleceniami wpisanymi przez SSH, a 100 ostatnich zakończonych zostaje zachowanych.

from pethost.sandboxes import FileChange, Sandboxes, TextEdit

sandboxes = Sandboxes()  # czyta PETHOST_TOKEN
box = sandboxes.create_sandbox()
code = "x = 1\nprint(x * 42)\n"
sandboxes.write_files(box.sandbox_id, changes=[FileChange(path="app.py", text=code)])
out = sandboxes.run_command(box.sandbox_id, command="python3 app.py", timeout_seconds=30)
print(out.exit_code, out.stdout)  # 0 42

edit = TextEdit(old_text="x = 1", new_text="x = 2")
sandboxes.write_files(box.sandbox_id, changes=[FileChange(path="app.py", edit=edit)])
server = sandboxes.run_command(box.sandbox_id, command="python3 -m http.server 8000",
                               wait_for_port=8000)
print(server.state.name)  # RUNNING: odpowiedziało, gdy port 8000 zaczął nasłuchiwać
pethost sandbox new --name tests --size small
pethost sandbox cp ./app tests:/home/user/app
pethost sandbox run tests --cwd /home/user/app -- python3 -m unittest
pethost sandbox open tests --terminal

Pliki: paczki zmian i dokładne edycje

write_files przyjmuje listę zmian i wykonuje je po kolei: zapis tekstu albo bajtów pliku, zamiana tekstu, który występuje w nim dokładnie raz, przeniesienie, usunięcie, utworzenie katalogu, ustawienie uprawnień. Brakujące katalogi nadrzędne są tworzone. Zatrzymuje się na pierwszej zmianie, która się nie uda, i mówi, na której, z powodem, na którym można oprzeć logikę, na przykład że tekstu do zamiany nie ma. Edycja trafia więc tylko tam, gdzie jest jej tekst. Żądanie mieści do 17 MiB.

read_file czyta do 1 MiB od dowolnego przesunięcia, list_files wypisuje katalog na dowolną głębokość, a watch_files przesyła na żywo każdą zmianę pod nim. Plik dowolnej wielkości przechodzi przez link z create_link: adres pobierania wysyła plik albo katalog jako .tar, a adres wgrywania przyjmuje PUT. Każdy działa raz.

Terminal w przeglądarce

create_link z terminalem daje stronę, na której działa bash albo polecenie takie jak claude, i WebSocket pod tym samym adresem, który przenosi jego bajty, do terminala we własnym produkcie. Link działa domyślnie godzinę, a najwyżej dzień.

Co działa w środku

Docker działa w każdym sandboxie: dockerd startuje przy pierwszym połączeniu z jego gniazdem i trzyma obrazy na dysku sandboxa, więc przetrwają zatrzymanie, a szablon je przeniesie. Resztę zainstalujesz z apt, przez sudo.

Wywołania idą prosto do serwera sandboxa, który SDK znajduje za ciebie. Pierwsze polecenie po utworzeniu odpowiada w 29–48 ms. Na serwerze z 74 sandboxami, z których każdy budował projekt JavaScript i czekał między buildami, tak jak agent, proste polecenie trwało 6 ms (28 ms w 95. percentylu).

Limity i ceny

CoLimit
Wywołania naraz, na sandbox64; write_files liczy się za 16
Żądanie1 MiB; write_files 17 MiB
Odpowiedźok. 64 KiB; read_file 1 MiB; dowolna wielkość przez link
Wynik w odpowiedziostatnie 32 KiB stdout i stderr

Polecenia, pliki i linki nie mają własnej ceny: płacisz za sekundy działania sandboxa, od 0,018 $ za godzinę dla SMALL (2 vCPU, 4 GiB) do 0,144 $ dla XLARGE (16 vCPU, 32 GiB), a każdy okres działania zaokrąglamy w górę do sekundy, minimum 10 s. Po 5 minutach bezczynności sandbox wstrzymuje się za 30% tej ceny. Jak działa rozliczanie co do sekundy.

Jak to wypada na tle innych

21 listopada 2026 E2B liczyło 0,1656 $ za godzinę sandboxa z 2 vCPU i 4 GiB, tak samo Daytona; SMALL w Pethost, tego samego rozmiaru, kosztuje 0,018 $. Sesje w E2B trwały do 1 godziny w planie Hobby i do 24 godzin w planie Pro, w Vercel Sandbox 45 minut w planie Hobby i 24 godziny w planie Pro. Sandbox Pethost nie ma limitu czasu życia.

Przeczytaj dokumentację

Pytania

Jakie języki uruchomi sandbox do wykonywania kodu?

Wszystko, co działa na Linuksie. Python 3 i Node.js 22 są zainstalowane, Docker działa, a resztę zainstaluje apt. Zapisz sandbox ze swoimi narzędziami jako szablon, a nowe sandboxy wystartują z nimi.

Jak długo może działać polecenie?

Tyle, ile potrzebuje: jedno wywołanie czeka do 45 sekund, potem czytasz albo odbierasz na żywo jego wynik. Po 5 minutach bezczynności sandbox wstrzymuje się z poleceniem w pamięci, które działa dalej przy następnym wywołaniu. Polecenie uruchomione z keep_awake działa bez przerwy, tak samo jak to, które śledzisz przez watch_command.

Czy kod ma dostęp do internetu?

Tak, przez TCP: domyślnie sandbox może łączyć się z czymkolwiek. Lista dozwolonych dla ruchu wychodzącego zawęża to do wskazanych domen, adresów IP i portów. Żaden ruch UDP nie wychodzi z sandboxa.

Jak przenosić duże pliki?

Przez link pobierania albo wgrywania, dowolnej wielkości, albo przez scp po SSH.

Powiązane

Daj swojemu agentowi komputer w 0,15 s

Zacznij darmowy okres próbny