/pattern/capability-routing/

04 · ProductionTool IntegrationTool SelectionCapability MatchingSkill Routing

Capability Routing.
Das Tool nach dem auswählen, was es kann, nicht wie es heißt.

Eine Anfrage wird dem Tool, Agenten oder Dienst zugeordnet, dessen deklarierte Fähigkeit zu ihr passt — Auswahl über Fähigkeits-Metadaten statt einer hartkodierten Bedingung —, und eine fehlende Fähigkeit wird explizit erkannt statt still fehlgeroutet.

In der PraxisEin Kundenservice-Orchestrator leitet eine 'Mein Paket verfolgen'-Anfrage an das Logistik-Tool und eine 'Erstattung bearbeiten'-Anfrage an das Zahlungs-Tool weiter, ausgewählt anhand eines Fähigkeits-Tags statt einer hartkodierten Bedingung.

Wann man dazu greift

  • Viele Fähigkeiten verfügbar sind.
  • Die Auswahl Metadaten oder Richtlinien folgen muss.
  • Fehlende Fähigkeiten explizit erkannt werden müssen.

Wann es nach hinten losgeht

  • Die Tool-Auswahl trivial ist.
  • Fähigkeitsbeschreibungen ungenau sind.
  • Das Routing nicht beobachtbar getestet werden kann.

Die Abwägung

Flexible Auswahl wird auf Kosten des Risikos von Fehlzuordnung und Richtlinienkomplexität gewonnen.

Die Wirkung

Was es tatsächlich tut.

Die Anfrage wird an das passende Tool geroutet.

agentbest toolresult
Fallstricke

Zwei Wege, wie dieses Pattern Probleme verursachen kann.

Zwei Tools beanspruchen dieselbe Fähigkeit

Mehrdeutige Fähigkeits-Tags lassen zwei Tools für dieselbe Anfrage matchen. Der Router wählt nicht-deterministisch; das nachgelagerte Verhalten variiert von Durchlauf zu Durchlauf.

Lösung · Nach Fähigkeitsspezifität bewerten und Gleichstände mit einem expliziten Prioritätsfeld auflösen. Bewertung protokollieren, damit das gewählte Tool auditierbar ist.

Kein Tool passt, also wählt der Router trotzdem das nächstgelegene

Eine Anfrage außerhalb jeder Tool-Fähigkeit wird zwangsweise dem nächstgelegenen zugeordnet. Der Agent führt ein Tool aus, das nie für die Aufgabe gedacht war, und liefert ein selbstsicheres falsches Ergebnis.

Lösung · Einen Mindest-Match-Score verlangen und dem Router einen expliziten No-Match-Zweig geben, der ablehnt oder eskaliert, statt immer ein Best-of-Bad zu wählen.

Framework-Unterstützung

Wo Capability Routing nativ ist.

LangGraphbedingtes RoutingNativ
OpenAI Agents SDKHandoffsNativ
Microsoft Agent FrameworkRouting-LogikNativ
Google ADKAgenten-RoutingNativ
AWS StrandsCapability-RoutingNativ

Suche

Patterns, Frameworks und Seiten durchsuchen.