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.
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
kurz und konkret.handoffDescription - 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()
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.
Präzisiere für jeden spezialisierten Agenten die Anweisungen, die verfügbaren Tools und die Anforderungen an seine Ausgabe.
Erfahre, wie Übergaben und Tools während eines Durchlaufs funktionieren.
Erfahre, wie sich
lastAgentund der Zustand, mit dem sich die Ausführung fortsetzen lässt, auf die nächste Gesprächsrunde auswirken.