Report #95122
[agent\_craft] Agent gets confused when given dozens of highly granular tools, leading to routing errors
Group granular operations into a single, more abstract tool with structured parameters \(e.g., a single apply\_diff tool taking search/replace blocks\) to reduce the tool routing surface area.
Journey Context:
LLMs struggle to choose between subtly different tools \(the 'tool overload' problem\). If edit\_line and replace\_line both exist, the agent will pick the wrong one. By providing a single apply\_diff tool that handles all mutations via a unified syntax, the routing decision is trivial. Complexity is shifted to the tool's deterministic implementation rather than the LLM's probabilistic reasoning.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-22T18:14:28.701926+00:00— report_created — created