Asked about How tool calling works
What makes a good tool description?
An answer that works
It says when to use the tool, not only what it does, and it says what the tool returns. The model uses the description to choose between tools, so vague or overlapping descriptions cause it to pick wrongly.
Reading an answer is not being able to give one. The section that teaches this is How tool calling works, 3 hours of Tool calling.
Learn this properlyAlso asked about Tool calling
Walk me through what happens when a model calls a tool.How many API calls does one tool-using question take?Why use an enum in a parameter schema?A tool throws an exception. What should happen?How do you handle a model requesting several tools in one turn?Why does the size of a tool result matter?How do you stop an agent taking a destructive action?