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.

Testen Sie Apidog noch heute

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:

1. Lesen Sie das function_call-Element aus der Antwort.
2. Führen Sie die Funktion in Ihrer Infrastruktur aus.
3. Senden Sie ein function_call_output mit derselben call_id in der nächsten Anfrage.
4. 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 und compact_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.

1. Komponenten zuordnen.
   
   Verschieben Sie Anweisungen, Modell und Tools in agent. Ihren Container modellieren Sie als environment. Ihren Konversationsspeicher ersetzen Sie durch eine Sitzungs-ID.

2. Remote-MCP-Server nach agent.tools verschieben.
   
   Speichern Sie Tokens in einem Tresor, der über vault_ids verbunden ist. Zugangsdaten gehören nicht in Prompts.

3. Funktionshandling umschreiben.
   
   Ersetzen Sie Ihre function_call_output-Schleife durch Handler für:

   • agent.session.requires_action im Stream,
   • agent.session.action_required per Webhook.

Senden Sie Ergebnisse anschließend als agent.session.input.tool_result zurück. Sub-Agents können keine Funktions-Tools aufrufen; behalten Sie diese daher beim Haupt-Agenten.

1. Eigenen Komprimierungscode entfernen.
   
   Der Harness komprimiert Kontext automatisch.

2. Auf Ereignisse umstellen.
   
   Verarbeiten Sie mindestens:

   • agent.session.turn.completed
   • agent.session.turn.failed
   • agent.session.turn.cancelled

Alternativ verwenden Sie Webhooks. Wichtig: Eine inaktive Sitzung bedeutet nicht automatisch Erfolg.

1. Plattformgrenzen prüfen. Berücksichtigen Sie US-Residenz, fehlendes ZDR und den erforderlichen Beta-Header.

Beide Varianten in einem Apidog-Projekt testen

Migrieren Sie nicht blind. Führen Sie Responses API und Agents API zunächst parallel aus.

1. Erstellen Sie in einem Apidog-Projekt zwei Ordner:

   • Responses
   • Agents API

2. Verwenden Sie eine gemeinsame Umgebung:
   

   {{OPENAI_API_KEY}}
   {{OPENAI_MODEL}}

1. Senden Sie identische Prompts an beide Endpunkte.

2. Prüfen Sie:

   • HTTP-Statuscodes,
   • erforderliche Antwortfelder,
   • Tool-Aufrufe,
   • Fehlermeldungen,
   • Latenz und Abschlussereignisse.

3. Öffnen Sie den Agents-API-Stream als SSE-Anfrage, um Durchlaufereignisse direkt zu beobachten.

4. Speichern Sie die Requests als Testszenario und führen Sie sie mit der Apidog CLI in CI aus. So wird eine Änderung in der Beta-API als fehlgeschlagene Prüfung sichtbar.

Der Leitfaden zur Zuverlässigkeit von KI-Agenten in der Produktion zeigt, welche Prüfungen dafür relevant sind. Laden Sie Apidog herunter, um die Requests einzurichten.

FAQ

Ersetzt die Agents API die Responses API?

Nein. Es wurde keine Einstellung angekündigt. OpenAIs Agenten-Übersicht führt Agents API, Agents SDK und Responses API weiterhin als aktuelle Optionen für unterschiedliche Anforderungen.

Ist OpenAI AgentKit eingestellt?

Teilweise. Agent Builder und Evals sollen am 30. November 2026 abgeschaltet werden. ChatKit bleibt verfügbar.

Verwendet das Agents SDK die Agents API?

Nein. Das SDK läuft in Ihrer Anwendung. Die Agents API betreibt einen verwalteten Harness im OpenAI-Dienst.

Was ist mit der Assistants API passiert?

OpenAIs Deprecations-Seite setzte die Entfernung auf den 26. August 2026 und verweist Entwickler auf Responses API und Conversations API.

Welche Option ist am günstigsten?

Die Token-Preise sind identisch. Der Kostenunterschied entsteht durch gehostete Container bei der Agents API gegenüber eigenem Hosting bei Agents SDK oder Responses API.

Wählen Sie diese Woche einen Pfad

Wählen Sie zuerst, wer die Schleife ausführen soll. Validieren Sie diese Entscheidung dann mit echten HTTP-Anfragen, bevor Sie eine Anwendung bauen.

Wenn Sie neu starten, erstellen Sie eine Agents-API-Sitzung und vergleichen Sie deren Ausgabe mit Ihrem bestehenden Responses-Setup in Apidog.