Ein Agent-Handoff ist die strukturierte Übergabe von Arbeit zwischen zwei KI-Agenten. In jedem Multi-Agent-Workflow mit mehr als einer Rolle ist der Handoff zwischen Rollen der Ort, an dem die meisten Failure-Modes leben. Handoffs als typisierte Kontrakte zu behandeln — nicht als Prosa-Anweisungen — kollabiert die Failure-Rate.
Der Handoff-Kontrakt.
Jeder Handoff hat drei explizite Teile:
- Input-Shape. Das typisierte Objekt, das der empfangende Agent erwartet. Als TypeScript-Interface oder JSON-Schema definiert, nicht als Paragraph im Prompt.
- Erwarteter Output. Was der empfangende Agent produzieren soll. Ebenfalls typisiert, ebenfalls schema-durchgesetzt.
- Erfolgskriterium. Die Rubrik, die der nächste Agent in der Kette (oder die Eval-Harness) verwendet, um zu bewerten, ob dieser Handoff tatsächlich produziert hat, was gebraucht wurde.
Warum typisierte Kontrakte Prosa schlagen.
Prosa-Handoffs («der Planer sollte dem Executor genug Kontext zum Handeln geben») klingen vernünftig, bis Sie einen davon debuggen. Jeder Agent interpretiert die Prosa leicht unterschiedlich, und das System produziert still falsche Outputs. Typisierte Kontrakte machen Mehrdeutigkeit zu einem Compile-Zeit-Fehler. Sie machen Handoff-Qualität auch zu einer Rubrik, die die Eval-Harness automatisch bewerten kann.
Wann man keine Multi-Agent-Handoffs nutzt.
Wenn der Workflow linear ist und jeder Schritt dieselbe Rolle hat (transform, filter, output), nutzen Sie einen einzelnen Agenten mit deterministischen Funktionsaufrufen, nicht einen Multi-Agent-Handoff. Handoffs zu einer linearen Pipeline hinzuzufügen, fügt Latenz, Kosten und drei neue Failure- Stellen hinzu, ohne irgendetwas zu lösen. Wenn der Workflow mehrere Rollen braucht, ist das Muster ein Multi-Agent-Workflow mit Agent Tool Use an den Rändern.
Häufige Fragen.
- Was ist ein Agent-Handoff?
- Ein Agent-Handoff ist die strukturierte Übergabe von Arbeit zwischen zwei KI-Agenten — zum Beispiel ein Planer, der einen Plan an einen Executor übergibt, oder ein Router, der an einen Spezialisten dispatchen. Der Handoff ist ein typisierter Kontrakt mit explizitem Input-Shape, erwartetem Output und Erfolgskriterium statt einer Prosa-Anweisung.
- Warum sind Handoffs der Failure-Point in Multi-Agent-Workflows?
- Weil die meisten Teams Handoffs als Prosa schreiben. Prosa-Handoffs klingen vernünftig, bis Sie einen davon debuggen: Jeder Agent interpretiert die Worte unterschiedlich, und das System produziert still falsche Outputs. Typisierte Kontrakte beheben das, indem sie Mehrdeutigkeit zu einem Compile-Zeit-Fehler machen.
- Wie bewerte ich Handoff-Qualität in einer Eval-Harness?
- Definieren Sie das Erfolgskriterium des Handoff-Kontrakts als Rubrik (deterministisch wenn der erwartete Output strukturell ist, LLM-gegradet wenn er gefühlsbasiert ist). Die Harness bewertet die Ausgabe jedes Agenten gegen den Kontrakt, bevor sie weitergereicht wird. Schlechte Handoffs erscheinen als Regressionen in den Metriken des Upstream-Agenten, nicht als mysteriöse Downstream-Failures.
- Sollte jedes Multi-Agent-System typisierte Handoffs nutzen?
- Ja. Die Kosten, ein TypeScript-Interface für den Handoff zu schreiben, sind klein; die Kosten, einen Prosa-only-Handoff in Produktion zu debuggen, sind enorm. Jedes Morvion-Multi-Agent-Engagement definiert Handoffs als typisierte Kontrakte und bewertet sie in der Eval-Harness.
Englische Fassung: Agent-Handoff on the EN edition.