Deutsch
Menü der Doku

Doku zu Pethost Agent Sandboxes

Aktualisiert · 2 Min. Lesezeit

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.

RUNNING

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

PAUSED

Auf der Disk ihres Servers

Behält RAM, Prozesse und Disk.

0,0054 $ pro Stunde, SMALL

30 min Leerlauf: Sie stoppt

STOPPED

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

Der Standard-Lebenszyklus. Jeder Timer lässt sich ändern oder abschalten, und eine Sandbox wird nie gelöscht, außer du verlangst es: Lebenszyklus und Leerlauf.

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, scp und ssh -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

Konzepte

Aufgaben

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.

Testphase starten