PRODUCTION SCENARIO
An agent confuses two tools: one estimates shipping charges, the other buys a shipping label and needs operator approval before it charges the customer. Both descriptions read 'handles shipping'.
Which change best stops the agent from calling the wrong one?
Answering here is anonymous. Nothing is saved unless you sign in.
Show answer and explanation
Answer: Expand each description to say what the tool does, when to use it, and what it returns.
Detailed descriptions are by far the largest driver of tool-selection accuracy, and they are what separates a quote from a purchase, including when each should not be used. Consolidating related operations is good advice in general, but not across an approval boundary: one tool with an action parameter puts a read and an irreversible charge behind the same gate. input_examples show the shape of a well-formed call, not which tool the situation calls for. And a confirm flag is a guard on the purchase, not a fix for picking it by mistake.