Diese Anleitung folgt dem Python-Beispiel von Oracle für die Betaversion und nutzt die anwendungsverwaltete Bereitstellung. Dabei erstellt und löscht deine Anwendung sowohl die Sitzung der Agents API als auch die OCI-Sandbox.
Sieh dir das Beispiel zur anwendungsverwalteten Bereitstellung im OpenAI Cookbook an.
Im Leitfaden zum Lebenszyklus der Sandbox erfährst du, welche Bereitstellungsmodi es gibt und wie die Verbindung jeweils funktioniert.
OCI GenAI Sandboxes befinden sich in der Betaphase. Wende dich an die für dein Konto zuständige Ansprechperson bei Oracle, um Zugriff für dein Konto zu beantragen.
Voraussetzungen
Erstelle ein Projekt in OCI Generative AI, für das Sandboxes aktiviert sind. Erteile deiner OCI-Identität die Berechtigung, Projekte und Sandboxes im Compartment des Projekts zu verwalten. Ersetze die Platzhalter in den folgenden IAM-Richtlinien:
allow group <group-name> to manage generative-ai-sandbox in compartment <compartment-name>
allow group <group-name> to manage generative-ai-project in compartment <compartment-name>
Verwende für die Sandbox eine Laufzeitumgebung mit Node.js und npm. Das Beispiel von Oracle fordert standardmäßig python-3.11 an. Falls diese Laufzeitumgebung kein npm enthält, wähle eine kompatible benutzerdefinierte Laufzeitumgebung.
Wenn dein Projekt den ausgehenden Netzwerkverkehr einschränkt, erlaube HTTPS-Verbindungen zu registry.npmjs.org für die Installation von Codex, HTTPS-Verbindungen zu api.openai.com und sichere WebSocket-Verbindungen zu codex-cloud-environments.chatgpt.com. Weitere Informationen findest du im Abschnitt zum Netzwerkzugriff des Executors.
1. OCI CLI und Beta-SDK installieren
Erstelle eine virtuelle Umgebung und installiere die OCI CLI:
uv venv --python 3.14
source .venv/bin/activate
uv pip install --upgrade oci-cli
Installiere anschließend die Betaversion des Python-SDK, die dir Oracle beim Onboarding zur Verfügung stellt:
uv pip install "/path/to/oci-<beta-version>-py3-none-any.whl"
Installiere das Beta-SDK nach der CLI. Wenn du oci-cli danach installierst oder aktualisierst, kann das Paket oci von PyPI das Beta-SDK ersetzen. Installiere in diesem Fall die Wheel-Datei der Betaversion erneut. Das Beta-SDK muss oci.generative_ai_sandbox enthalten.
2. OCI-Umgebung konfigurieren
Authentifiziere dich in der für dein Konto freigeschalteten Region mit einem Profil, das ein Sicherheitstoken verwendet:
oci session authenticate --profile-name Sandbox --region us-chicago-1
Lege die OCID des Projekts und die OpenAI-Zugangsdaten als Umgebungsvariablen fest, ohne sie ins Repository einzuchecken:
export OCI_SANDBOX_PROJECT_ID="ocid1.generativeaiproject..."
export OPENAI_API_KEY="..."
export OPENAI_EXECUTOR_API_KEY="..."
Verwende OPENAI_API_KEY für Anfragen deiner Anwendung. Weise OPENAI_EXECUTOR_API_KEY einen Umgebungsschlüssel zu und übergib ausschließlich diesen Schlüssel als CODEX_API_KEY an die Sandbox.
Das Beispiel von Oracle liest das Profil Sandbox ein und verwendet die Region us-chicago-1. Mit diesen Umgebungsvariablen kannst du die Standardwerte überschreiben:
export OCI_SANDBOX_PROFILE="my-profile"
export OCI_SANDBOX_REGION="us-chicago-1"
Das Beispiel unterstützt außerdem folgende optionale Einstellungen:
| Einstellung | Standardwert |
|---|---|
OCI_SANDBOX_ENDPOINT |
https://inference.generativeai.<region>.oci.oraclecloud.com |
OCI_SANDBOX_RUNTIME |
python-3.11 |
OCI_SANDBOX_SHAPE |
SMALL |
OCI_SANDBOX_EXPIRATION |
PT30M (30 Minuten) |
Wenn du deine eigene Anwendung konfigurierst, verwende das Sicherheitstoken und den privaten Schlüssel des Profils mit oci.auth.signers.SecurityTokenSigner. Erstelle mit GenerativeAiSandboxClient aus oci.generative_ai_sandbox einen Sandbox-Client für die gewählte Region und den gewählten Endpunkt.
3. Eine anwendungsverwaltete Sitzung ausführen
Die Anfragen an die Agents API und den Befehl zum Starten des Executors findest du in der Anleitung zum Verbinden einer selbst gehosteten Umgebung. Gehe wie im Beispiel von Oracle vor:
- Erstelle eine selbst gehostete Sitzung der Agents API mit
/workspaceals Arbeitsverzeichnis. Speichere die Sitzungs-ID und die Umgebungs-ID. - Erstelle eine OCI GenAI Sandbox und warte, bis sie den Status
RUNNINGerreicht. - Installiere Codex und schreibe die Datei
/workspace/brief.txtin die Sandbox. - Starte
codex exec-servermit der Umgebungs-ID der Sitzung und dem Umgebungsschlüssel. - Öffne den Ereignisstream der Sitzung. Sende dann eine Eingabe, in der du den Agenten aufforderst, aus
brief.txteinen Migrationsplan zu erstellen. Warte, bis der Agent fertig ist, und lies die erzeugte Datei/workspace/plan.md. - Stoppe und lösche die OCI-Sandbox. Lösche anschließend die Sitzung der Agents API. Versuche, beide Ressourcen zu löschen, auch wenn einer der Schritte fehlschlägt.
Halte beide Ressourcen für weitere Anfragen in derselben Sitzung aktiv und rufe die Dateien ab, bevor du die Sandbox löschst. Verwende die von Oracle angegebene Version des Beta-SDK. In Vorschauversionen können sich die Namen der Sandbox-APIs ändern.
Weiterführende Informationen
- Lies die Dokumentation zu OCI Generative AI.
- Lies die Dokumentation zum OCI Python SDK.
- Lies die Dokumentation zum OCI TypeScript SDK.
- Lies die Anleitung zur Authentifizierung mit der OCI CLI.