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

Agenten

Wähle eine Laufzeitumgebung, binde Tools an und steuere Abläufe mit mehreren Schritten.

Agenten können mithilfe von Tools Aufgaben planen und erledigen, mit anderen Agenten zusammenarbeiten und den Kontext über mehrere Schritte hinweg beibehalten. Welche Laufzeitumgebung zu dir passt, hängt davon ab, wo die Orchestrierung laufen soll und wer den Zustand zwischen Aufgaben verwalten soll.

Finde den passenden Einstieg

Du möchtest Hier geht’s los
Einen Agenten mit dem von OpenAI verwalteten Codex-Harness ausführen Agents API
Die Agentenschleife in deiner Anwendung mit wiederverwendbaren Agenten, Tools und Übergaben steuern Agents SDK
Direkt mit Modellantworten arbeiten und die Integration selbst steuern Responses API
Einen Chat in deine Anwendung einbetten ChatKit

Laufzeitumgebungen für Agenten im Vergleich

Agents API Agents SDK Responses API
Einsatzgebiet Länger laufende Aufgaben, bei denen OpenAI den Agenten verwaltet und seinen Fortschritt speichert Agenten mit eigenen Tools und Workflows in deiner Anwendung entwickeln Modelle direkt aufrufen oder einen Agenten von Grund auf entwickeln
Wo der Agent läuft OpenAI betreibt einen verwalteten Codex-Harness Das SDK läuft in deiner Anwendung In deiner Anwendung, optional mit gehosteter Orchestrierung
Aufwand für die Integration eines Agenten Gering Mittel Hoch
Zustand zwischen Aufgaben Gespeicherte Sitzungskonfiguration, Gesprächsrunden und Elemente Dein eigener Speicher und SDK-Sitzungen oder der Gesprächszustand der Responses API Manuell verwalteter Verlauf, verkettete Antworten oder Conversations
Ausführung von Tools An Dienste angebundene Tools, Funktionshandler deiner Anwendung und eine optionale Sandbox Tools und Integrationen, die du in deiner Anwendung konfigurierst Gehostete Tools und Tools, die deine Anwendung ausführt
Ausführungsumgebung Von OpenAI gehostete Sandbox, selbst gehostete Sandbox oder keine Sandbox Deine Laufzeitumgebung und deine Integrationen mit Sandbox-Anbietern Deine eigene Ausführungsumgebung
Einstieg Überblick über die Agents API Überblick über das Agents SDK Leitfaden zur Responses API

Die Agents API führt den Codex-Harness aus und verwaltet die zugrunde liegende Infrastruktur. So kannst du dich auf die Aufgaben deiner Agenten konzentrieren. Die API bietet automatische Kontextverdichtung, orchestriert mehrere Agenten und unterstützt programmatische Tool-Aufrufe sowie MCP-Server. Mehr dazu erfährst du im Abschnitt Architektur.

Mit dem Agents SDK steuerst du in deiner Anwendung die Bereitstellung, die Datenspeicherung, Genehmigungen und die Integration in deine Laufzeitumgebung. Der Runner des SDK übernimmt die Agentenschleife und die Übergaben zwischen Agenten. Mehr dazu erfährst du im Leitfaden Agenten ausführen.

Tools, Skills und Prompt-Caching hinzufügen

Für die Gestaltung von Tools, den Einsatz wiederverwendbarer Skills und das Prompt-Caching gelten in verschiedenen Agenten-Workflows dieselben Grundlagen. Konfiguration und Lebenszyklus können sich je nach API unterscheiden.

  • Der Leitfaden Tools verwenden führt dich in Funktionsaufrufe, MCP und gehostete Funktionen ein.
  • Im Leitfaden Programmatische Tool-Aufrufe erfährst du, wie du Tools mit JavaScript orchestrierst und welche Konfiguration du für die jeweilige API brauchst.
  • Der Leitfaden Skills erklärt, wie du Anweisungen wiederverwendest und welche Möglichkeiten zum Laden von Skills unterstützt werden.
  • Lies Prompt-Caching, um zu erfahren, wie das Caching API-übergreifend funktioniert. Wie die Nutzung pro Sitzung erfasst wird, erfährst du anschließend im Leitfaden Beobachtbarkeit und Nutzung der Agents API.

Eine Sitzung der Agents API, eine SDK-Sitzung, eine Konversation der Responses API und eine Sandbox sind unterschiedliche Ressourcen. Befolge für die gewählte Laufzeitumgebung die Anweisungen zur Zustandsverwaltung und zur Bereinigung der Ressourcen.