AI 101

Tool description

Also known as: description (of a tool)

Agents

A tool description is the prose inside a tool’s schema: what the tool does, when to use it, and what to watch out for.

  • It’s the model’s only manual for that tool.
  • Good: precise inputs, expected outputs, failure modes.
  • Bad: vague one-liners that leave everything to guesswork.

Pro move: treat tool descriptions like API documentation for a smart but context-blind intern. The better the description, the fewer wrong calls you'll see.