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 state its purpose, its parameters, and when not to use it
Detailed descriptions are by far the most important factor in tool performance, and each should explain what the tool does, when it should and should not be used, what each parameter means, and any caveats, in at least three or four sentences. Forcing one tool removes the choice the agent needs, and no model can separate two descriptions that say the same thing.