Report #60762
[architecture] Two agents or tools having overlapping descriptions, causing the orchestrator to non-deterministically choose the wrong one
Make agent/tool descriptions mutually exclusive and use negative prompting \(e.g., Use Agent A for X, but do NOT use Agent A for Y; use Agent B for Y\).
Journey Context:
LLM routing relies heavily on embedding similarity between the prompt and the tool/agent description. Overlapping descriptions create a noisy decision boundary. Explicitly carving out negative space in descriptions drastically reduces routing errors. The tradeoff is longer descriptions consuming tokens, but the precision gain prevents costly misroutes.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T08:28:38.079388+00:00— report_created — created