Agent Engineering
The Art of Tool Descriptions
The same task — failure on the left, success on the right — the only difference is the description. Select an experiment scenario and click Run to see the comparison.
❌ Bad Description
Vague, missing key info
✅ Good Description
Precise, with constraints
Conclusions & Critical Thinking
Core conclusion: A tool description = the user manual for the model. The clearer the manual, the more accurately the model uses the tool. This is not just an engineering problem. Product managers should write tool descriptions the way they write a PRD.
Critical thinking: Is tool description an extension of Prompt Engineering? Yes. A tool description is fundamentally a structured Prompt. All Prompt techniques (specificity, examples, constraints) apply equally here.