Den vollständigen Index der Dokumentation findest du in llms.txt. Die Markdown-Version einer Dokumentationsseite erhältst du, indem du .md an die URL der Seite anhängst.
Hauptnavigation
Design

E2B

Verbinde eine E2B-Sandbox mit einer Sitzung der Agents API.

Im OpenAI Cookbook findest du Beispiele für die Verwaltung durch die Anwendung und die Verwaltung über Webhooks.

Wähle aus, wie du die Sandbox bereitstellen möchtest:

Einen Vergleich der beiden Modi findest du im Abschnitt Lebenszyklus einer Sandbox.

Bevor du beginnst

Setze E2B_API_KEY und verwende OPENAI_API_KEY für Anfragen deiner Anwendung. Setze OPENAI_EXECUTOR_API_KEY auf einen Umgebungsschlüssel und übergib ausschließlich diesen Schlüssel als CODEX_API_KEY an die Sandbox.

Verwaltung über Webhooks

Implementiere einen Controller, der OpenAI-Webhooks überprüft und für jede Sitzung einen eigenen E2B-Worker bereitstellt. Folge der Anleitung Handler bereitstellen und verbinden, um die Zugangsdaten einzurichten, den Endpunkt zu registrieren und die Signaturen zu überprüfen.

Speichere dauerhaft, welche Sandbox zu welcher Sitzung gehört. Setze bei einer Verbindungsanfrage einen pausierten Worker fort oder ersetze einen gelöschten Worker. Beim Pausieren bleiben die Dateien des Workers erhalten. Wenn du den Worker ersetzt, gehen sie verloren. Lege für den Controller und die Worker jeweils eine maximale Laufzeit fest. Entferne den OpenAI-Webhook, wenn du den Controller nicht mehr verwendest.

Verwaltung durch die Anwendung

Verwalte die Sandbox in deiner Anwendung mit dem SDK oder der API von E2B:

  1. Erstelle eine selbst gehostete Sitzung und speichere ihre Umgebungs-ID.
  2. Erstelle eine isolierte E2B-Sandbox mit dem Arbeitsverzeichnis der Sitzung und installiere darin die Codex CLI.
  3. Starte den Executor in der Sandbox mit der Umgebungs-ID und dem Umgebungsschlüssel.
  4. Folge der Anleitung Sitzungen ausführen und fortsetzen, um Eingaben zu senden und das Ergebnis des jeweiligen Durchlaufs zu prüfen.
  5. Lösche die Sitzung und stoppe die E2B-Sandbox, wenn du fertig bist.

Konfiguriere die Lebensdauer der Sandbox unabhängig vom Zeitlimit für den Executor-Befehl. Die Sandbox stoppt nach Ablauf ihrer Lebensdauer auch dann, wenn der Befehl kein Zeitlimit hat.

Weiterführende Informationen