Patterns · Anti-Patterns
Wie Multi-Agenten-Systeme
in Produktion scheitern.
9 Fehlermodi, die ein erfahrenes Team in Produktion beobachtet hat. Jeder liest sich wie eine Gegenüberstellung — links der Fehler, rechts seine Gegenmaßnahme — gruppiert nach der Sprosse, auf der der Fehler entsteht, weil frühes Benennen das meiste bereits behebt.
Die Karte
Wo jeder Fehler zuschlägt.
Jeder Fehler entsteht auf einer Sprosse der Leiter — doch einige bleiben nicht dort. Das Gros sitzt unten, wo ein einzelner Agent allein schlussfolgert; die selteneren, teureren tauchen erst unter Produktionslast auf. Wähle einen Knoten, um zu seinem Eintrag zu springen.
Sprossenübergreifende Ausbreitung — drei Fehler bleiben nicht dort
Hidden State in Prompts
Verhalten driftet über lange Gespräche. Fehler reproduzieren sich nur sporadisch.
Pydantic-v2-Zustand an jeder Knotengrenze. Zusätzliche Attribute verbieten. Zustand gehört in den Code.
Tool Explosion
Die Tool-Auswahlgenauigkeit bricht ein. Das Modell halluziniert Aufrufe und Parameternamen.
Minimal-Rechte pro Rolle. Große Kataloge hinter einer Tool Registry plus Capability-Routing absichern.
Unbounded Loop
Ein L1-Agent steckt wegen fehlerhaften Reasonings in unproduktiven Endloszyklen fest, ohne programmiertes Rekursionslimit oder Schritt-Budget.
Entstammt L1 mit ReAct; tritt hier erneut auf, wenn eine primitive Loop keine Terminierung hat.
Ein hartes recursion_limit und ein Schritt-Budget auf Harness-Ebene setzen. Ein Reflexion-Gate oder einen Tool-Call-Zähler hinzufügen, um Endlosschleifen zu unterbrechen.
Self-Graded Hallucination
Ein Modell, das seine eigene Antwort kritisiert, kann dem eigenen Fehler zustimmen — eine Reflexionsschleife konvergiert selbstsicher auf etwas Falsches.
Das Versagen, um das die Reflexionsschicht der Entscheidungs-Heuristik herumlenkt — Selbstkritik ist nur so vertrauenswürdig wie der Check, an dem sie verankert ist. Gegenstück in der Wissensdatenbank: Teil IX §8.
Das Urteil an einem externen Check verankern: einem ausführbaren Test, einem Orakel oder einem Menschen — nicht an einer weiteren Stichprobe desselben Modells.
Hallucinated Routing
Reflexionsschleifen konvergieren nie. Rekursionslimits schlagen erst zur Laufzeit an statt zur Entwurfszeit.
Router-Entscheidungen schema-validieren. Hartes recursion_limit, hartes max_handoffs.
Over-Agentification
Hohe Latenz, teure Token-Rechnungen, Debugging, das emergentes Verhalten aus Logs rekonstruieren muss.
Spiegelt das L3-Anti-Pattern: nach Multi-Agent greifen, wenn ein L2-Workflow gereicht hätte.
Die Entscheidungs-Heuristik durchlaufen. Die einfachere Alternative skizzieren und vergleichen, bevor man sich festlegt.
God Orchestrator
Ein einziger Punkt für Koordination, Ausfall — und für die Exposition privater Daten.
Dezentralisierter Stern. Prompt und Tools des Orchestrators klein halten; Arbeit in Spezialisten auslagern.
Cascading Security Failures
Ein vergiftetes Dokument in einem gemeinsamen Index kontaminiert jeden nachgelagerten Konsumenten. Prompt-Injection propagiert über Übergaben.
Jede Agent-zu-Agent-Nachricht als Vertrauensgrenze behandeln. Wissensdatenbanken nach Vertrauensniveau partitionieren.
SQLite Under Concurrency
Schreibsperren serialisieren alles. Timeouts unter Last. Sitzungen vermischen sich.
Ein L4-Anti-Pattern, das L2 am härtesten trifft — jeder checkpointierte Workflow wächst irgendwann über SQLite hinaus.
AsyncPostgresSaver. Thread-IDs als user×session zusammensetzen.