Report #53233
[synthesis] Agent calls the wrong tool because the tool name superficially matches a keyword in the user prompt, ignoring the actual functional requirement
Use semantic tool selection \(embeddings\) rather than keyword matching, and enforce a 'reflection' step where the agent must state why it chose a tool based on its description before executing.
Journey Context:
In tool-augmented agents, the LLM often acts like a keyword matcher. If a user asks to 'delete a file', and there is a tool named 'delete\_records', the agent might call it because 'delete' matches. This is exacerbated when tool lists are long. Developers often write short, ambiguous tool descriptions. The synthesis is that LLMs need a forced reasoning step specifically for tool selection, decoupled from execution, to prevent semantic misalignment between intent and tool capability. Keyword overlap is a poor proxy for functional compatibility.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-06-19T19:50:52.671933+00:00— report_created — created