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

Modelle und Anbieter

Wähle Modelle, Standardwerte und Transportverfahren für Agentenläufe mit dem SDK.

Bei jedem Lauf ermittelt das SDK, welches Modell und welches Transportverfahren es verwendet. Für die meisten Anwendungen genügt eine einfache Konfiguration. Wähle die Modelle explizit aus, nutze standardmäßig die OpenAI-Anbindung des SDK und ändere den Anbieter oder das Transportverfahren nur, wenn dein Workflow es erfordert.

Modelle explizit auswählen

Wähle das Modell im Produktivbetrieb möglichst explizit aus. Der Standardwert, den das SDK zur Laufzeit verwendet, hängt von der SDK-Version ab.

  • Setze model direkt am Agenten, wenn für seine Aufgabe regelmäßig andere Anforderungen an Qualität, Latenz oder Kosten gelten.
  • Lege einen Standardwert für den Lauf fest, wenn du in einem Workflow die Modellwahl für mehrere Agenten gleichzeitig überschreiben möchtest.
  • Setze OPENAI_DEFAULT_MODEL, wenn du für den gesamten Prozess ein Standardmodell für Agenten ohne model festlegen möchtest.
Modelle pro Agent und pro Lauf festlegen
import { Agent, Runner } from "@openai/agents";

const fastAgent = new Agent({
  name: "Fast support agent",
  instructions: "Handle routine support questions.",
  model: "gpt-5.6-terra",
});

const generalAgent = new Agent({
  name: "General support agent",
  instructions: "Handle support questions carefully.",
});

const runner = new Runner({
  model: "gpt-6-astra",
});

await runner.run(fastAgent, "Summarize ticket 123.");
const result = await runner.run(
  generalAgent,
  "Investigate the billing issue on account 456."
);

console.log(result.finalOutput);

Beginne bei den meisten neuen SDK-Workflows mit gpt-6-astra. Wechsle erst zu einer kleineren Variante, wenn Latenz oder Kosten den Wechsel rechtfertigen. Aktuelle Empfehlungen für die gesamte Plattform findest du im Leitfaden zur Modellwahl.

Standardmodelle möglichst einfach festlegen

Was du brauchst So gehst du vor Warum
Ein explizit gewähltes Modell für jeden spezialisierten Agenten Setze model an jedem Agenten Die Modellwahl im Workflow lässt sich im Code und in den Traces nachvollziehen
Ein Standardmodell für den gesamten Prozess OPENAI_DEFAULT_MODEL Auch bei Agenten ohne model ist klar, welches Modell zum Einsatz kommt
Eine abweichende Modellwahl für einen Workflow Lege einen Standardwert für den Lauf fest Du kannst das Modell für ein Skript, einen Worker oder eine Umgebung wechseln, ohne jeden Agenten einzeln zu ändern
Unterschiedliche Modellgrößen im selben Workflow Wähle je nach Agent unterschiedliche Modelle Ein schneller Agent kann die Ersteinschätzung übernehmen, ein langsamerer die Detailanalyse

Wenn es für dein Team darauf ankommt, welches Modell standardmäßig zum Einsatz kommt, lege es selbst fest. Verlasse dich in diesem Fall nicht auf den Standardwert des SDK.

Anbieter und Transportverfahren

Was du brauchst Womit du beginnst
Reguläre SDK-Läufe mit OpenAI Standardanbindung des SDK an OpenAI
Viele aufeinanderfolgende Modellanfragen und Antworten über die Responses API und denselben Socket WebSocket-Transport des SDK für die Responses API
Modelle anderer Anbieter oder eine Kombination mehrerer Anbieter Schnittstellen für Anbieter oder Adapter in der SDK-Dokumentation für deine Programmiersprache

Achte auf den Unterschied zwischen diesen beiden Fällen.

  • Auch beim WebSocket-Transport für die Responses API nutzt der Agent die übliche Ausführungsschleife für Text und Tool-Aufrufe. Sprachsitzungen laufen separat.
  • Live-Audiositzungen über WebRTC oder WebSocket ermöglichen Interaktionen mit Sprache oder Bildern bei geringer Latenz. Weitere Informationen dazu findest du im Leitfaden zu Sprachagenten und im API-Leitfaden für Live-Audio.

Wie du Anbieter konfigurierst, ihren Lebenszyklus verwaltest und die Hilfs-APIs für den Transport nutzt, hängt von der Programmiersprache ab. Dokumentiere diese Details in der jeweiligen SDK-Dokumentation, damit du sie hier nicht wiederholen musst.

Modelleinstellungen, Prompts und unterstützte Funktionen

Die Modellwahl ist nur ein Teil der Laufzeitkonfiguration.

  • Mit modelSettings kannst du unter anderem den Reasoning-Aufwand, die Ausführlichkeit der Antworten und das Verhalten der Tools anpassen.
  • Verwende prompt, wenn du den Lauf über eine gespeicherte Prompt-Konfiguration steuern möchtest, ohne den vollständigen System-Prompt in den Code einzubetten.
  • Einige SDK-Funktionen setzen die Anbindung an die OpenAI Responses API voraus. Ältere Kompatibilitätsschnittstellen reichen dafür nicht aus. Schau in der SDK-Dokumentation nach, wenn du erweiterte Funktionen zum Laden von Tools oder für den Transport benötigst.

Lege die Modellkonfiguration direkt bei der Agentendefinition fest, wenn sie sich aus der speziellen Aufgabe des Agenten ergibt. Verwende einen Standardwert für den Workflow nur, wenn mehrere Agenten zur Laufzeit dieselbe Konfiguration nutzen sollen.

Nächste Schritte

Sobald die Laufzeitkonfiguration feststeht, wähle den Leitfaden, der zur weiteren Gestaltung deines Workflows passt.