OpenAI Agents API vs Responses API vs Agents SDK vs AgentKit: Welches für die Entwicklung wählen?

Diese vier Namen liegen auf unterschiedlichen Ebenen. Die zentrale Frage lautet: Wer führt die Agenten-Schleife aus? Die Responses API ist der Modellaufruf; Ihre Anwendung implementiert die Schleife darum herum. Das Agents SDK ist eine TypeScript- und Python-Bibliothek, deren Runner die Schleife innerhalb Ihrer Anwendung ausführt. Die Agents API befindet sich seit dem 10. September 2026 in öffentlicher Beta und führt OpenAIs Codex-Harness aus, inklusive Sitzungsverwaltung und optionaler Sandbox. AgentKit bündelt Agent Builder, ChatKit, Connector Registry und Evals; Agent Builder soll am 30. November 2026 eingestellt werden. Der DevDay am 29. September ergänzte die Agents API um Computer-Nutzung, wie im DevDay-2026-Rückblick beschrieben. Damit wird die Abgrenzung noch wichtiger: Vergleichen Sie Schleife, Compute, Zustand, Kosten und Reifegrad, bevor Sie sich für eine Laufzeit entscheiden. Eine praktische Einführung zu Sitzungen und Genehmigungen finden Sie im OpenAI Agents API Leitfaden. Alle HTTP-Anfragen können Sie in Apidog testen. OpenAI-Agentenoptionen im Vergleich | Agents API | Responses API | Agents SDK | AgentKit | | |---|---|---|---|---| | Was es ist | Verwaltete Agenten-Laufzeit auf dem Codex-Harness | Modell-Endpunkt: POST /v1/responses | Bibliothek für TypeScript und Python | Bündel aus Agent Builder, ChatKit, Connector Registry und Evals | | Wer die Schleife ausführt | OpenAI | Ihr Code | Der SDK-Runner in Ihrer Anwendung | Agent-Builder-Workflows, als SDK-Code exportiert oder über ChatKit eingebettet | | Wo Compute läuft | OpenAI-gehostete Sandbox, eigene Sandbox oder keine Sandbox | Ihre Umgebung plus gehostete Tools | Ihre Laufzeit und Ihr Sandbox-Anbieter | Nicht zutreffend | | Wo Zustand liegt | OpenAI-Sitzung mit Konfiguration, Durchläufen und Elementen | Ihre Historie, previous_response_id oder Conversations API | Ihr Speicher, SDK-Sitzungen oder Responses-Zustand | Veröffentlichte, versionierte Workflows | | Wofür Sie zahlen | Tokens, Tools und gehostete Container; keine zusätzliche Gebühr | Tokens und Tools | Tokens, Tools und eigenes Hosting | Nutzung der zugrunde liegenden API; kein separates Abonnement | | Integrationsaufwand laut OpenAI | Niedrig | Hoch | Mittel | Nicht bewertet | | Status | Öffentliche Beta: OpenAI-Beta: agents=v1 | Für neue Projekte empfohlen | Aktuell | Agent Builder und Evals enden am 30. November 2026; ChatKit bleibt | | Datenkontrollen | Nur US-Datenresidenz, nicht ZDR-berechtigt, Zustand bis zur Löschung gespeichert | ZDR-berechtigt mit Einschränkungen, regionale Endpunkte | Abhängig von den verwendeten APIs | Nicht zutreffend | Quellen: OpenAIs Vergleich der Agenten-Laufzeiten, die Übersicht zur Agents API und die Deprecations-Seite. Wer führt die Schleife aus? Diese Entscheidung bestimmt fast alle weiteren Architekturfragen: Fehlerbehandlung, Tool-Ausführung, Zustandsverwaltung, Observability und Hosting. Responses API: Ihre Anwendung führt die Schleife aus Die Responses API liefert einen Modellaufruf. Gehostete Tools wie Websuche, Dateisuche, Code Interpreter und Remote MCP können innerhalb einer Anfrage mehrere Schritte ausführen. Eigene Funktions-Tools kommen jedoch zu Ihrer Anwendung zurück. Wenn das Modell eine Funktion aufruft: - Lesen Sie das function_call -Element aus der Antwort. - Führen Sie die Funktion in Ihrer Infrastruktur aus. - Senden Sie ein function_call_output mit derselbencall_id in der nächsten Anfrage. - Wiederholen Sie den Ablauf, bis das Modell eine finale Antwort liefert. Sie steuern außerdem: - wann die Schleife endet, - wie Sie Gesprächsverläufe speichern, - ob Responses gespeichert werden ( store: false deaktiviert dies), - wann lange Kontexte mit context_management undcompact_threshold komprimiert werden. Details finden Sie im Responses API Leitfaden und im Funktionsaufruf-Leitfaden. Agents SDK: Der Runner läuft in Ihrem Prozess Beim Agents SDK übernimmt der SDK-Runner die Agenten-Schleife und Übergaben. Ihre Anwendung bleibt dennoch für die operativen Teile zuständig: - Bereitstellung, - Tool-Implementierungen, - Zustandsspeicherung, - Genehmigungen, - Authentifizierung, - Audit-Logs. Mit Sandbox Agents kann der Harness in Ihrer Infrastruktur laufen. Befehle werden dann beispielsweise in einem lokalen Unix-Arbeitsbereich, Docker-Container oder bei einem gehosteten Anbieter ausgeführt. Dadurch bleiben menschliche Freigaben, Zugangsdaten und Audit-Informationen außerhalb des Containers steuerbar. Agents API: OpenAI führt die Schleife aus Die Agents API betreibt den verwalteten Harness. OpenAI übernimmt Sitzungen, Orchestrierung, Kontextkomprimierung und Wiederherstellung. Zusätzlich stehen Sub-Agents, Tool-Suche und programmatische Tool-Aufrufe zur Verfügung. Remote-MCP-Server ruft OpenAI direkt auf. Eigene Funktions-Tools bleiben Ihre Verantwortung: Meldet eine Sitzung einen function_call in required_actions , senden Sie ein agent.session.input.tool_result -Ereignis mit passender turn_id und call_id zurück. Dieselbe Aufgabe mit beiden APIs # Responses API: ein Modellaufruf; Ihre Anwendung besitzt die Schleife curl https://api.openai.com/v1/responses \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-6.1-sol", "reasoning": {"effort": "low"}, "tools": [{"type": "web_search"}], "input": "Summarize the breaking changes in the latest Node.js release." }' # Agents API: dauerhafte Sitzung; OpenAI besitzt die Schleife curl https://api.openai.com/v1/agents/sessions \ -H "OpenAI-Beta: agents=v1" \ -H "Authorization: Bearer $OPENAI_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "agent": { "model": "gpt-6-astra", "tools": [{"type": "web_search"}] }, "environment": {"type": "none"}, "input": "Summarize the breaking changes in the latest Node.js release." }' Die Beispiele in der Agents-API-Dokumentation verwenden gpt-6-astra . Ob andere Modelle akzeptiert werden, wird dort nicht angegeben. Prüfen Sie die Modellunterstützung, bevor Sie beispielsweise gpt-6.1-sol verwenden. Compute, Zustand und Kosten Compute Die Agents API kann für eine gesamte Sitzung eine Sandbox bereitstellen und verwalten: { "environment": { "type": "openai_hosted" } } Verfügbare Werte für environment.type sind: openai_hosted self_hosted none Mit dem Agents SDK wählen und bezahlen Sie den Sandbox-Anbieter selbst. Bei der Responses API läuft eigener Code in Ihrer Umgebung; ausgenommen davon sind gehostete Tools. Zustand Eine Agents-API-Sitzung speichert Konfiguration, Durchläufe und Elemente auf OpenAI-Seite. Folgeaktionen senden Sie daher als Ereignisse mit derselben Sitzungs-ID. Mit Responses können Sie Zustand auf zwei verbreitete Arten weitergeben: { "previous_response_id": "resp_..." } Oder Sie verwenden die Conversations API. Beim Agents SDK liegt der Zustand in Ihrem eigenen Speicher, in SDK-Sitzungen oder im Responses-Zustand. Kosten Die Token-Preise sind identisch, weil alle Optionen dieselben Modelle aufrufen. Unterschiede entstehen durch die Laufzeit: - Agents API: keine zusätzliche Plattformgebühr, aber Kosten für gehostete Container. - Gehostete Container: 0,03 $ für 1 GB bis 0,48 $ für 16 GB pro 20-minütiger Sitzung. - Agents SDK: Tokens und Tools plus eigenes Hosting und eigener Sandbox-Anbieter. - Responses API: Tokens und Tools; Compute für eigene Funktionen liegt bei Ihnen. - AgentKit: kein separates Abonnement laut AgentKit Erklärer. Datenkontrollen Die Agents API unterstützt aktuell nur US-Datenresidenz und keine Zero Data Retention (ZDR), auch nicht mit selbst gehosteter Sandbox. OpenAIs Seite für Datenkontrollen listet /v1/agents als nicht ZDR-berechtigt. Zustand wird bis zur Löschung gespeichert. Dagegen ist /v1/responses mit Einschränkungen ZDR-berechtigt und über regionale Endpunkte wie eu.api.openai.com verfügbar. Wenn ZDR oder EU-Datenresidenz zwingend erforderlich sind, scheidet die Agents API derzeit aus. AgentKit Ende 2026: Was bleibt? AgentKit wurde am 6. Oktober 2025 in vier Teilen eingeführt. Der aktuelle Status: - Agent Builder: Einstellung am 3. Juni 2026 angekündigt, Abschaltung am 30. November 2026 geplant. Der Migrationsleitfaden beschreibt den Export eines Workflows als Agents-SDK-Code oder die Neuerstellung als ChatGPT Workspace Agent für Business, Enterprise oder Edu. - Evals: Bestehende Evals werden am 31. Oktober 2026 schreibgeschützt. Dashboard und API sollen am 30. November 2026 abgeschaltet werden. - ChatKit: Bleibt für eingebettete Chat-Oberflächen verfügbar. - Connector Registry: Admin-Panel für Konnektoren und MCP-Server über OpenAI-Produkte hinweg. Der dauerhafte Code-First-Pfad aus AgentKit ist laut AgentKit Leitfaden das Agents SDK. Welche Option sollten Sie verwenden? | Wählen Sie | Wenn | |---|---| | Agents API | Aufgaben minutenlang laufen, Dateien, Befehle oder Browserzugriff benötigen und Sie Schleife, Sandbox und Sitzungsspeicherung nicht selbst betreiben möchten. US-Residenz und Beta-Header sind akzeptabel. | | Responses API | Sie einzelne Aufrufe ausführen, jede Phase selbst kontrollieren möchten, ZDR oder Datenresidenz außerhalb der USA benötigen oder bereits eine funktionierende Schleife haben. | | Agents SDK | Getypter Anwendungscode Tools, Speicher, Genehmigungen und Übergaben verwalten muss und die Schleife in Ihrer Infrastruktur laufen soll. | | ChatKit | Sie eine eingebettete Chat-Benutzeroberfläche in Ihrem Produkt benötigen. | | Agent Builder | Starten Sie nicht neu damit. Exportieren Sie bestehende Workflows vor dem 30. November 2026. | Auf AWS bieten Bedrock Managed Agents, powered by OpenAI die Kernfunktionen der Agents API für eine native AWS-Ausführung. Für die MCP-Integration in beiden Code-First-Ansätzen lesen Sie MCP-Server mit OpenAI-Agents. Umstieg von einer eigenen Responses-Schleife zur Agents API Wenn Sie bereits eine Responses-Schleife betreiben und OpenAI die Orchestrierung übernehmen soll, gehen Sie schrittweise vor. Komponenten zuordnen. Verschieben Sie Anweisungen, Modell und Tools inagent . Ihren Container modellieren Sie alsen