PRODUCTION SCENARIO
A field-service agent exposes 14 tools. In 30 percent of test runs it calls lookup_ticket when search_tickets was needed, because both descriptions read 'Finds tickets' and neither explains its parameters.
Which change should the team make first?
Answering here is anonymous. Nothing is saved unless you sign in.
Show answer and explanation
Answer: Rewrite each tool description to cover its purpose, its parameters and its limits
Detailed descriptions are by far the most important factor in tool performance, and each should say what the tool does, when it should and should not be used, what every parameter means and any caveats - three or four sentences at minimum. Forcing one tool per turn removes the selection the agent exists to make. No model can separate two descriptions that say the same thing. A system-prompt rule fixes this one collision and leaves the other twelve thin descriptions untouched.