Skip to main content

What makes a good tool for an agent?

Agents and tools · Intermediate 3

Short answer

A clear name and description that say when to use it, a small strict input schema with meaningful parameter names, outputs that are concise and useful to a model (not raw dumps), helpful error messages the agent can act on, and the least power needed. Fewer, well-designed tools that match tasks beat many thin wrappers around API endpoints.

Deeper answer

Write tool descriptions as you would brief a new colleague: what it does, when not to use it, and examples of inputs. Return identifiers the agent can use in the next call, and paginate or truncate large results with a note saying more exist.

Then test tools with the model: watch traces for wrong tool choices or bad arguments, and fix the description or schema rather than adding more prompt instructions. Anthropic's guide to writing tools for agents is a good reference.

What a strong answer covers

Answer it out loud in the mock interview about 1.5 min

Follow-ups to expect

Common mistakes

Learn it

Designing tools for agents

Today's AI turns are used

Lessons, roadmaps, videos, practice cards and the code playground stay free with your account, with no limit.