Describe what the tool returns, not just what it does
description
A tool description that only explains the action (e.g. "searches for X") without saying what shape the result takes leaves the model unable to reason correctly about how to use the output in a following step.
good example
"Returns a JSON array of {title, url, snippet} objects, most relevant first."
bad example
"Searches the web." (no mention that results come back as a list, or in what format)
source note
General tool-use best practice.
provenance
created 2026-07-02 08:28:30 · JSON