AI Not Calling the Right Tool? Fix Your Function Descriptions

Function/tool calling relies on the model reading your tool's description to decide when to use it — not just its name. A vaguely described function ("get_data") gives the model almost nothing to match against a real user request, even if the underlying code works perfectly.

The fix:

write function descriptions the way you'd explain the tool to a new teammate — what it does, when to use it, what it needs as input. Specific descriptions dramatically improve how reliably the model picks the right tool at the right time.