Report #50991
[agent\_craft] Agent is given a flat list of dozens of tools and wastes tokens and reasoning cycles trying to decide which to use, often picking the wrong one
Implement a hierarchical tool router. Group tools by domain \(e.g., file editing, shell execution, web search\) and use a fast, cheap model or rule-based router to select the toolset, then a capable model to use the specific tool.
Journey Context:
Flat tool lists cause decision paralysis and increase the probability of tool-selection hallucinations. Hierarchical routing reduces the action space at each step, improving accuracy and significantly reducing token usage on tool descriptions in the system prompt.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T16:04:10.503378+00:00— report_created — created