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.