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

Daytona

Führe eine Sitzung der Agents API in einer Daytona-Sandbox aus.

Im OpenAI Cookbook findest du Beispiele für die Verwaltung von Sandboxes durch 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:

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

Verwaltung über Webhooks

Verwende einen Controller, um eingehende Webhooks von OpenAI zu verifizieren und Bereitstellungsaufträge in eine Warteschlange einzureihen. Betreibe den Controller getrennt von der Worker-Sandbox, in der der Executor der jeweiligen Sitzung läuft. Folge der Anleitung Handler bereitstellen und verbinden, um den Endpunkt und das Signaturgeheimnis zu registrieren.

Starte bei environment_connection-Anfragen den Worker oder stelle die Verbindung zu ihm wieder her. Gib den Worker frei, wenn die Sitzung fehlschlägt. Lege die Timeouts für Worker und Controller explizit fest. Wenn du Rechenressourcen bei Inaktivität stoppen möchtest, brauchst du eine Richtlinie, die das Stoppen mit eingehenden Aufträgen abstimmt. Details dazu findest du im Abschnitt Verhalten während des Lebenszyklus.

Verwaltung durch die Anwendung

Voraussetzungen

Du brauchst einen API-Schlüssel für dein OpenAI-Projekt, einen Daytona-API-Schlüssel und das Paket für die Codex CLI.

Setze DAYTONA_API_KEY und 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. Daytona-Umgebung einrichten

Erstelle eine selbst gehostete Sitzung und speichere ihre Umgebungs-ID. Erstelle mit dem Daytona SDK oder der Daytona API eine isolierte Sandbox mit dem konfigurierten Arbeitsverzeichnis. Installiere die Codex CLI in der Sandbox und starte dann den Executor mit der gespeicherten Umgebungs-ID und dem Umgebungsschlüssel.

Der Executor baut eine langlebige ausgehende Verbindung zu OpenAI auf. Daytona berücksichtigt diese Verbindung bei der Erkennung von Inaktivität nicht. Setze auto_stop_interval=0, damit Daytona die Sandbox nicht stoppt, während der Agent arbeitet. Lege außerdem eine maximale Laufzeit fest, damit die Rechenressourcen nach einem unterbrochenen Lauf nicht unbegrenzt weiterlaufen.

Wenn du die Sandbox regelmäßig nutzt, nimm Codex und ripgrep in einen Daytona-Snapshot auf. So kann die Sandbox die Verbindung schneller herstellen.

2. Sitzung ausführen

Sobald der Daytona-Executor verbunden ist, kannst du anhand der HTTP-Beispiele im Leitfaden 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 beim Anbieter separat.

Starte die Sandbox, bevor du eine Eingabe sendest. Der Turn wartet, bis die Umgebung verbunden ist. Die Sitzung meldet die Verbindung mit dem Ereignis agent.session.environment.connected im Ereignisstream.

An agent.session.turn.completed erkennst du, dass ein Turn erfolgreich abgeschlossen wurde. Auch nach einem fehlgeschlagenen oder abgebrochenen Turn kann agent.session.idle folgen. Eine inaktive Sitzung allein belegt daher keinen erfolgreichen Abschluss. Wenn du die Sitzung unmittelbar nach einem Ereignis abrufst, kann der Abruf kurzzeitig noch den vorherigen Status liefern.

Referenzen