Der Subagents-Leitfaden von LangChain (abgerufen am 6. Oktober 2026) definiert das Muster so: „a central main agent (often referred to as a supervisor) coordinates subagents by calling them as tools.“ Die ältere Bibliothek langgraph-supervisor empfiehlt in ihrer README inzwischen „the supervisor pattern directly via tools rather than this library for most use cases“; das GitHub-Repository ist archiviert, und 0.0.31 (19. November 2025) ist sein letztes Release.
Wie koordiniert ein Supervisor Agent seine Worker?
Der Supervisor liest den gemeinsamen Zustand, wählt einen Worker, schickt ihm eine begrenzte Aufgabe und erhält ein Ergebnis, bevor er die nächste Route wählt. Er sollte nur den Kontext weitergeben, den der nächste Worker braucht, nicht jede Nachricht und jedes Tool-Ergebnis. Ein Subagent kann recherchieren, schreiben oder ein dediziertes System aufrufen, während der Supervisor das Ziel und die Stoppbedingung behält. Das Muster ist eine Form eines Multi-Agent-Systems und liegt nah am Orchestrator-Worker-Pattern, wobei ein Orchestrator auch nach festen Regeln statt per Modell routen kann.
Wann setzen wir bei Soba Labs einen Supervisor Agent ein, und wann nicht?
Unser geplanter Agent, der die Meetings des Tages vorbereitet, ist ein Supervisor. Er klassifiziert jedes Meeting selbst, weil die Klassifizierung über den Tag hinweg konsistent sein muss und günstig ist, und startet dann genau einen Worker pro Meeting für die aufwendige Recherche. Worker liefern Text zurück, und jeden Schreibvorgang führt der Supervisor aus, sodass ein Vorbereitungsdokument pro Meeting per Konstruktion gilt und nicht dadurch, dass jeder Worker sich richtig verhält. Drei Regeln bestimmen, wie unsere Supervisor mit Workern umgehen:
- Berichten Sie nach dem, was zurückkam, nicht nach dem, was gestartet wurde. Ein ausgefallener Worker liefert nichts, und eine Übersichtszeile, die aus der Dispatch-Liste geschrieben wird, erfindet ein Ergebnis; ein fehlendes Ergebnis wird deshalb als fehlend gemeldet.
- Ersetzen Sie einen stummen Worker nach einer Zeitobergrenze. Jede Rolle hat ein Zeitlimit (standardmäßig 30 Minuten); danach startet der Supervisor einen Ersatz mit demselben Briefing, und eine erforderliche Rolle, die erneut scheitert, beendet den Lauf als fehlgeschlagen, statt zu hängen.
- Behandeln Sie eine fehlerhafte Eingabe als Supervisor-Bug. Meldet ein Worker einen Defekt in der Eingabe, sind die anderen sehr wahrscheinlich ebenfalls darauf gestoßen. Eine falsche Annahme in einem Briefing, nämlich dass eine Datenbank nicht erreichbar sei, erreichte einmal dreizehn Subagents und führte zu einer langen, gut belegten Diagnose; ein einziger Befehl über eine andere konfigurierte Route erreichte die Datenbank problemlos.
Stehen die Schritte vorab fest, verzichten wir auf den Supervisor und bauen einen deterministischen LangGraph-Graphen, wie in Deep agents in production (auf Englisch) beschrieben.
Wann ist ein Supervisor die falsche Wahl?
Ein Supervisor bringt zusätzliche Modellaufrufe, Zustand und eine weitere Stelle, an der das Routing scheitern kann. Der Multi-Agent-Forschungsbericht von Anthropic (13. Juni 2025) nennt für Multi-Agent-Systeme etwa 15-mal mehr Tokens als bei Chats, und der Multi-Agent-Leitfaden von LangChain merkt an, dass ein einzelner Agent mit den richtigen Werkzeugen und dem richtigen Prompt „can often achieve similar results.“ Setzen Sie einen Supervisor nur ein, wenn die Worker wirklich getrennte Werkzeuge, Berechtigungen oder Fachkenntnis brauchen. Software, die einen Agenten beurteilt, statt ihn zu steuern, ist ein Guardian Agent, und wenn ein Worker die Kontrolle zurückgibt, hält eine ausdrückliche Agent-Übergabe fest, wer die nächste Entscheidung besitzt.