Im OpenAI Cookbook findest du Beispiele dafür, wie du Sandboxes über deine Anwendung oder über Webhooks verwaltest.
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
Verwende ein Vercel-Projekt mit Zugriff auf Vercel Sandbox. Wie sich das Vercel Sandbox SDK authentifiziert, hängt davon ab, wo deine Anwendung läuft:
- Bei lokaler Ausführung: Setze
VERCEL_TOKEN,VERCEL_TEAM_IDundVERCEL_PROJECT_IDin deiner Umgebung. - Bei Bereitstellung auf Vercel: Verwende Vercel OIDC.
Verwende OPENAI_API_KEY für Anfragen deiner Anwendung. Setze OPENAI_EXECUTOR_API_KEY auf einen Umgebungsschlüssel und übergib nur diesen Schlüssel als CODEX_API_KEY an die Sandbox.
1. Vercel-Umgebung einrichten
Erstelle eine selbst gehostete Sitzung und speichere ihre Umgebungs-ID. Erstelle mit dem SDK oder der API von Vercel eine isolierte Sandbox mit dem konfigurierten Arbeitsverzeichnis. Installiere die Codex CLI in der Sandbox und starte anschließend ihren Executor mit der gespeicherten Umgebungs-ID und dem Umgebungsschlüssel.
Nimm Codex für die regelmäßige Nutzung in einen Vercel-Snapshot auf, damit die Sandbox die Verbindung früher herstellen kann.
2. Sitzung ausführen
Sobald der Vercel-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 bei Vercel separat.