Doku zu Pethost Agent Sandboxes
Eine Sandbox ist eine Linux-MicroVM für Code, Coding-Agenten und einen Desktop mit Chrome: eine Firecracker-VM mit eigenem Kernel, und darin bist du root. Sie startet aus einer Vorlage in etwa 0,15 s, pausiert mit RAM und Prozessen, wenn nichts in ihr passiert, wacht beim nächsten Aufruf in etwa 0,1 s auf und stoppt in den Objektspeicher, wenn sie länger im Leerlauf bleibt. Du zahlst sekundengenau für das, was jeder Zustand hält.
Im RAM ihres Servers
Führt deine Prozesse aus und beantwortet jeden Aufruf.
0,018 $ pro Stunde, SMALL
5 min Leerlauf: Sie pausiert
Der nächste Aufruf weckt sie
Auf der Disk ihres Servers
Behält RAM, Prozesse und Disk.
0,0054 $ pro Stunde, SMALL
30 min Leerlauf: Sie stoppt
Im Objektspeicher
Behält ihre Disk; ihre Prozesse enden.
0,03 $ pro GiB und Monat
ResumeSandbox startet sie wieder, ihre Dateien, wie sie sie verlassen hat
Wo du anfängst
In Zahlen
- 0,15 s zum Start einer Sandbox, gemessen über ein Panel 16 ms von ihrem Server entfernt
- 0,1 s zum Wecken einer pausierten, beim nächsten Aufruf
- 0,018 $ pro Stunde für 2 vCPUs und 4 GiB, sekundengenau
- 30 % dieses Preises, solange sie pausiert
Was eine Sandbox kann
- Befehle, Dateien und ein Terminal. Führ einen Befehl aus und warte auf seinen Port, bearbeite eine Datei durch exaktes Ersetzen, streame die Ausgabe oder öffne ein Terminal im Browser: Befehle und Dateien.
- Ports. Jeder Port unter
https://<port>-<id>.<server>, öffentlich oder hinter einem Token: Ports und Vorschauen. - Coding-Agenten. Claude Code, Codex und OpenCode sind installiert. Ein Aufruf gibt einem Agenten einen Prompt, ein anderer streamt jeden Tool-Aufruf, den er macht: Coding-Agenten.
- Ein Desktop. Chrome auf einem Bildschirm mit 1280×800, der bei seiner ersten Nutzung startet: klicken, tippen und einen Screenshot machen in einem Aufruf, oder live zusehen: Computer Use.
- Vorlagen, Forks und Volumes. Speichere die Disk einer Sandbox und starte neue daraus (Vorlagen); kopier eine laufende Sandbox samt RAM in bis zu 100 Kopien (Forks); halte Daten auf einer Disk außerhalb jeder Sandbox, auf einem Server (Volumes).
- Secrets und Egress. API-Keys, die die Sandbox nie hält, und eine Allowlist, wohin sie sich verbinden darf: Secrets und Egress.
- SSH und Observability. Einfaches
ssh,scpundssh -L(SSH) und die Metriken, Events und der Verbrauch jeder Sandbox (Observability).
Agent Sandboxes und App Platform
Pethost hat zwei Arten von Workspaces. App Platform ist die Maschine eines Tarifs für deine Docker-Compose-Apps, zu einem festen Preis im Monat: Die Doku dazu ist die Doku zur App Platform. Um Agent Sandboxes geht es auf diesen Seiten: MicroVMs, die dein Code oder dein Agent über eine API startet, nutzt und stoppt, sekundengenau abgerechnet. Jeder Workspace ist von einer Art, und ein Konto kann beide haben.
Alle Seiten
Einstieg
-
So funktionieren Pethost Agent Sandboxes
Was eine Sandbox ist, ihre drei Zustände RUNNING, PAUSED und STOPPED, was sie weckt, die zwei APIs und wo RAM, Prozesse und Dateien liegen.
-
Schnellstart: deine erste Sandbox
Sandbox erstellen, Befehl ausführen, Datei schreiben, Port öffnen, aufräumen: mit Python, TypeScript, Go, Rust, der pethost-CLI oder deinem Agenten.
-
Einen Agenten über MCP mit Sandboxes verbinden
Gib Claude Code, Codex, Cursor oder Claude Sandboxes als Tools: Füg den MCP-Server von Pethost Agent Sandboxes hinzu und melde dich bei einem Workspace an.
Konzepte
-
Lebenszyklus einer Sandbox: Auto-Pause, Auto-Stopp und Leerlauf
Wann eine Sandbox im Leerlauf pausiert, stoppt oder gelöscht wird: was als Aktivität zählt, die drei Timer, keep_awake, wake_when_stopped und Werte je Einsatz.
-
Preise und Abrechnung von Sandboxes: sekundengenau, je Zustand
Was eine Sandbox pro Sekunde kostet, wenn sie läuft, pausiert oder schläft, was ein Tarif enthält, kostenlose Starts und Limits, die Testphase und Beispiele.
-
Best Practices für Pethost Agent Sandboxes
Die wenigen Entscheidungen für schnelle Starts, weniger Kosten und Sicherheit: Vorlagen, Pausen, Batch-Jobs, keep_awake, request_id, Secrets und Egress.
Aufgaben
-
Befehle ausführen und Dateien bearbeiten in einer Sandbox
Shell-Befehle in einer Sandbox ausführen und auf Ausgabe oder Port warten, lange streamen, Dateien durch exaktes Ersetzen bearbeiten, große über Links bewegen.
-
Ports und Vorschauen: die URLs einer Sandbox
Gib jedem Port einer Sandbox eine HTTPS-Adresse, öffentlich oder hinter einem Token, warte auf einen Dev-Server und lass Vorschauen zwischen Besuchen schlafen.
-
Claude Code, Codex und OpenCode in einer Sandbox ausführen
Gib Claude Code, Codex oder OpenCode in einer Sandbox mit einem Aufruf einen Prompt, streame seine Tool-Aufrufe und melde ihn an, ohne dass der Key hineinkommt.
-
Computer Use: Chrome auf einem Desktop in einer Sandbox
Klicken, tippen und einen Screenshot eines Desktops mit Chrome machen, in einem Aufruf für einen Computer-Use-Agenten, oder den Bildschirm live sehen.
-
Vorlagen: Sandboxes startklar starten
Speichere die Disk einer Sandbox als Vorlage, mit deinen Paketen und Docker-Images, und starte daraus neue Sandboxes auf jedem Server in etwa 0,2 s.
-
Secrets und Egress: Keys, die eine Sandbox nie hält
Gib einer Sandbox API-Keys, die sie nie hält, vom Egress-Proxy für die genannten Hosts eingesetzt, und begrenze mit einer Allowlist, wohin sie sich verbindet.
-
Eine Sandbox forken, RAM und Prozesse eingeschlossen
Kopier eine laufende Sandbox mit RAM, Prozessen und Disk in einem Aufruf in bis zu 100 Sandboxes, um vom selben Punkt aus mehreres gleichzeitig zu probieren.
-
Volumes: eine Disk, die Sandboxes überdauert
Erstell ein Volume, mounte es an einem Pfad in Sandboxes, schreibend in eine oder lesend in viele, und erfahre, wo es liegt und was es kostet.
-
Per SSH in eine Sandbox: Shell, scp, SFTP und Tunnel
Melde dich mit einfachem ssh bei jeder Sandbox an, kopier Dateien mit scp und SFTP, leite Ports mit ssh -L weiter, mit einem Key oder Token als Passwort.
-
Observability: Metriken, Events und Verbrauch einer Sandbox
Lies CPU, RAM, Disk und Netzwerk einer Sandbox, liste und streame Lebenszyklus, Befehle, Verbindungen, Port-Requests und Turns, und sieh, was sie gekostet hat.
Referenz
-
Limits von Pethost Agent Sandboxes
Jede Grenze von Pethost Agent Sandboxes an einem Ort: Größen, Budgets der Tarife, Startlimits, Limits pro Sandbox und Aufruf, aufbewahrter Verlauf und Netzwerk.
-
Fehler der Sandboxes-API, und was zu tun ist
Jede Ablehnung der Sandboxes-API, ihr Code und ihr typisiertes Detail, was sie bedeutet und was dein Programm oder dein Agent als Nächstes tun sollte.
Pethost Agent Sandboxes ausprobieren
Eine Testphase von 7 Tagen mit 1 $ Verbrauch und 4 vCPUs, mit Karte. Danach ein Tarif ab 20 $ im Monat, der genauso viel Verbrauch enthält.