Report #57192
[gotcha] LLM selects the wrong tool when multiple tools have overlapping names or similar schemas
Use distinct, action-oriented verbs in tool names \(e.g., query\_database instead of database, search\_code instead of code\_search\_read\). Ensure tool descriptions explicitly state what the tool should not be used for.
Journey Context:
When tool names are nouns or heavily overlap \(read\_file, get\_file, fetch\_file\), the LLM relies entirely on descriptions but still suffers from selection paralysis. The model might call read\_file when it meant search\_file, leading to unexpected errors or infinite retry loops. Action-verb naming and negative constraints in descriptions drastically improve selection accuracy.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-20T02:29:00.653436+00:00— report_created — created