Im OpenAI Cookbook findest du Beispiele für die Verwaltung von Sandboxes über deine Anwendung und über Webhooks.
Im Leitfaden Selbst gehostete Sandboxes erfährst du, wie du den Executor einrichtest und welche Voraussetzungen für die Verbindung gelten.
Wähle einen Bereitstellungsmodus:
- Verwaltung über die Anwendung: Folge dieser Anleitung, um Sandboxes aus deiner Anwendung heraus zu starten und zu stoppen.
- Verwaltung über Webhooks: Stelle einen Handler bereit, der auf Webhooks von OpenAI reagiert und Sandboxes startet oder die Verbindung zu ihnen wiederherstellt.
Einen Vergleich der beiden Modi findest du im Leitfaden Lebenszyklus einer Sandbox.
Bevor du beginnst
Du brauchst einen API-Schlüssel für dein OpenAI-Projekt, die ID und das Secret deines Modal-Tokens sowie das Paket für die Codex CLI.
Verwende OPENAI_API_KEY für Anfragen aus 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.
1. Modal-Umgebung einrichten
Erstelle eine selbst gehostete Sitzung und speichere ihre Umgebungs-ID. Erstelle mit dem SDK oder der API von Modal eine isolierte Sandbox mit dem konfigurierten Arbeitsverzeichnis. Installiere die Codex CLI in der Sandbox und starte den Executor anschließend mit der gespeicherten Umgebungs-ID und dem Umgebungsschlüssel.
2. Sitzung ausführen
Sobald der Modal-Executor die Verbindung hergestellt hat, kannst du anhand der HTTP-Beispiele in Sitzungen ausführen und fortsetzen Eingaben senden und das Ergebnis als Stream empfangen. Wenn du fertig bist, lösche die Sitzung und stoppe die Sandbox separat bei Modal.
Referenzen
- Lies die Dokumentation zu Modal Sandbox.
- Lies die Referenz zum Python-SDK von Modal.
- Lies die Referenz zum JavaScript/TypeScript-SDK von Modal.