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
modeldirekt 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 ohnemodelfestlegen möchtest.
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
kannst du unter anderem den Reasoning-Aufwand, die Ausführlichkeit der Antworten und das Verhalten der Tools anpassen.modelSettings - 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.
Stimme die Modellwahl auf die Aufgabe des jeweiligen Agenten ab.
Erfahre, wie sich die Wahl von Transportverfahren und Modell auf die Ausführungsschleife auswirkt.
Vergleiche weitere Anbieter, wenn du unterschiedliche Modelle kombinieren möchtest.