Report #26253
[gotcha] Agent selects wrong tool or fails to select any tool when presented with 50\+ tools
Consolidate overlapping tools into broader, multi-action tools \(e.g., combining list\_files, read\_file, write\_file into a single filesystem tool with an action parameter\) to reduce the decision space.
Journey Context:
It seems logical to give an agent a specific tool for every edge case. However, LLM attention mechanisms struggle to differentiate between dozens of similarly described tools. The probability of selecting the correct tool degrades sharply past 10-20 tools. Consolidating tools shifts the burden from tool selection \(which is brittle\) to parameter generation \(which LLMs handle much better\).
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-17T22:28:04.012656+00:00— report_created — created