Überblick

Die Agents API ist als Betaversion verfügbar. Damit können Entwicklungsteams Anwendungen mit einem von OpenAI verwalteten Codex-Agenten erstellen, der über mehrere Schritte hinweg arbeiten und die Arbeit in derselben Sitzung fortsetzen kann.

Deine Anwendung stellt die Aufgabe, die Tools und die Konfiguration bereit. OpenAI verwaltet die Sitzung des Agenten und koordiniert das Zusammenspiel zwischen seinem Modell und seinen Tools.

Was kann ein Agent tun?

Je nach Tools und Ausführungsumgebung kann ein Agent Code ausführen, Dateien bearbeiten, MCP-Verbindungen nutzen und Dateien für deine Anwendung erstellen. Du kannst zusätzliche Anweisungen senden oder in derselben Sitzung mit einer weiteren Aufgabe fortfahren.

Unterstützte Funktionen und Beispiele findest du in der Übersicht zur Agents API.

Wie fange ich an?

1. Erstelle in deinem Projekt auf der OpenAI Platform einen API-Schlüssel für deine Anwendung. Erteile die Berechtigungen api.agents.read und api.agents.write für Sitzungen sowie api.responses.write für Modellanfragen.

2. Folge der Schnellstartanleitung, um einen Agenten zu konfigurieren, eine Sitzung zu erstellen und eine Aufgabe zu übermitteln.

3. Verfolge die Ereignisse der Sitzung, um Fortschritt und Ergebnisse zu überprüfen. Speichere die Sitzungs-ID, wenn du die Arbeit fortsetzen möchtest.

Bewahre deinen API-Schlüssel außerhalb der Sandbox des Agenten auf. Anfragen erfordern den Header OpenAI-Beta: agents=v1. Die OpenAI-SDKs fügen diesen Header automatisch hinzu.

Braucht mein Agent eine Sandbox?

Wähle die Umgebung, die zur Aufgabe passt:

• Keine Umgebung: Der Agent beantwortet Fragen oder nutzt externe Tools, ohne integrierte Shell-Befehle oder Dateien im Arbeitsverzeichnis zu benötigen.

• Von OpenAI gehostete Sandbox: Der Agent muss Skripte ausführen oder mit Dateien arbeiten, und du möchtest, dass OpenAI seine Sandbox verwaltet.

• Selbst gehostete Sandbox: Du benötigst eigene Infrastruktur, eigene Software oder ein privates Netzwerk. Deine Anwendung verwaltet den Lebenszyklus der Umgebung.

Details zur Konfiguration findest du in der Beschreibung der Architektur der Agents API.

Wo kann ich eine Sitzung überprüfen?

Öffne die Protokolle im Plattform-Dashboard, wähle Agenten aus und suche nach der Sitzungs-ID. Du kannst Interaktionsschritte, Tool-Aufrufe und die Aktivitäten von Unteragenten einsehen.

Der Leitfaden zur Beobachtbarkeit erklärt auch, wie du den erfassten Token-Verbrauch überprüfst.

Was passiert, wenn der Ereignisstream abbricht?

Rufe die bestehende Sitzung und ihre gespeicherten Elemente ab, bevor du es erneut versuchst. So kannst du prüfen, was passiert ist, bevor du weitere Aufgaben übermittelst.

Ein abgeschlossener Interaktionsschritt bedeutet nicht, dass jedes Tool erfolgreich ausgeführt wurde. Überprüfe das gemeldete Ergebnis. Eine Sitzung im Leerlauf allein belegt nicht, dass die Aufgabe erfolgreich abgeschlossen wurde.

Wie wird die Nutzung abgerechnet?

Für Modellanfragen gelten die API-Preise des ausgewählten Modells. Für OpenAI-Tools und von OpenAI gehostete Sandboxes gelten die jeweiligen Tool- und Containerpreise.

Die aktuellen Preise findest du in der API-Preisübersicht.

Wie wird mit Sitzungsdaten und Dateien umgegangen?

Die Agents API speichert den Sitzungszustand, damit die Arbeit über mehrere Interaktionsschritte hinweg fortgesetzt werden kann. Du kannst Sitzungen und veröffentlichte Artefakte löschen, wenn du sie nicht mehr benötigst. Sichere alle benötigten Dateien, bevor du eine Sitzung löschst.

Die Agents API unterstützt derzeit nur Datenresidenz in den USA. Sie unterstützt die Einstellung „keine Datenaufbewahrung“ nicht, auch nicht bei Verwendung einer selbst gehosteten Sandbox. Details zu den Datenkontrollen findest du in der Dokumentation zur Agents API.