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

Orchestrierung und Übergaben

Entscheide, ob spezialisierte Agenten das Gespräch übernehmen oder einen steuernden Agenten im Hintergrund unterstützen.

Workflows mit mehreren Agenten eignen sich, wenn spezialisierte Agenten unterschiedliche Teilaufgaben übernehmen sollen. Lege zuerst für jeden Zweig des Workflows fest, welcher Agent für die abschließende Antwort an die Person verantwortlich ist, die die Anfrage gestellt hat.

Orchestrierungsmuster auswählen

Muster Wann es sich eignet Was passiert
Übergaben Ein spezialisierter Agent soll das Gespräch in diesem Zweig übernehmen. Der spezialisierte Agent übernimmt die Steuerung.
Agenten als Tools Der Hauptagent soll den Ablauf steuern und spezialisierte Agenten für klar abgegrenzte Aufgaben aufrufen. Der Hauptagent bleibt für die Antwort verantwortlich.

Mit Übergaben die Verantwortung übertragen

Eine Übergabe eignet sich am besten, wenn ein spezialisierter Agent selbst die nächste Antwort geben soll, statt nur im Hintergrund zu unterstützen.

Verantwortung mit einer Übergabe übertragen
import { Agent, handoff } from "@openai/agents";

const billingAgent = new Agent({ name: "Billing agent" });
const refundAgent = new Agent({ name: "Refund agent" });

const triageAgent = Agent.create({
  name: "Triage agent",
  handoffs: [billingAgent, handoff(refundAgent)],
});

Mach deutlich, wann welcher Agent übernehmen soll:

  • Gib jedem spezialisierten Agenten eine klar begrenzte Aufgabe.
  • Formuliere handoffDescription kurz und konkret.
  • Lege nur dann einen eigenen Zweig an, wenn er tatsächlich andere Anweisungen, Tools oder Richtlinien benötigt.

Bei komplexeren Übergaben kannst du auch strukturierte Metadaten oder einen gefilterten Gesprächsverlauf mitgeben. Wie du die entsprechenden APIs einbindest, hängt von der Programmiersprache ab. Die Einzelheiten findest du in der SDK-Dokumentation.

Agenten als Tools in zentral gesteuerten Workflows einsetzen

Verwende agent.asTool(), wenn der Hauptagent für die abschließende Antwort verantwortlich bleiben und spezialisierte Agenten zur Unterstützung aufrufen soll.

Einen spezialisierten Agenten als Tool aufrufen
import { Agent } from "@openai/agents";

const summarizer = new Agent({
  name: "Summarizer",
  instructions: "Generate a concise summary of the supplied text.",
});

const mainAgent = new Agent({
  name: "Research assistant",
  tools: [
    summarizer.asTool({
      toolName: "summarize_text",
      toolDescription: "Generate a concise summary of the supplied text.",
    }),
  ],
});

Dieses Muster eignet sich meist besser, wenn:

  • der Hauptagent die Ergebnisse zu einer abschließenden Antwort zusammenführen soll
  • der spezialisierte Agent eine klar abgegrenzte Aufgabe erledigt, etwa eine Zusammenfassung oder Klassifizierung
  • du einen stabilen übergeordneten Workflow möchtest, der intern spezialisierte Agenten aufruft, ohne die Verantwortung abzugeben

Spezialisierte Agenten nur bei geänderten Anforderungen hinzufügen

Beginne möglichst mit einem einzelnen Agenten. Füge spezialisierte Agenten nur hinzu, wenn du dadurch Funktionen oder Richtlinien deutlich besser voneinander trennen, Prompts klarer formulieren oder Traces leichter nachvollziehen kannst.

Wenn du den Workflow zu früh aufteilst, entstehen mehr Prompts, mehr Traces und mehr Stellen, an denen eine Genehmigung nötig ist. Der Workflow wird dadurch nicht unbedingt besser.

Nächste Schritte

Sobald feststeht, welcher Agent für die Antwort verantwortlich ist, wähle den Leitfaden, der deine nächste Frage zur Ausführung oder zum Zustand beantwortet.