Claude Certified Architect – Foundations Practice Question 8: Detailed Tool Descriptions

Claude Certified Architect, Foundations · Test 1 · question 8 of 10

Tool Design & MCP Integrationmedium

An agent has two tools, search_orders and search_invoices. In testing, Claude frequently calls search_orders when users ask about billing documents. Both tools have one-line descriptions ("Search orders", "Search invoices") and the schemas are fine. What is the most effective first fix, according to Anthropic's tool-use guidance?

Select one answer
Show answer and explanation

Answer:

  • C. Rewrite each description to say what the tool does, when to use it and when not to, and what it returns

C is correct. Anthropic's guidance states that providing extremely detailed tool descriptions is by far the most important factor in tool performance: what the tool does, when it should and should not be used, what each parameter means, and what it returns and any caveats. Telling Claude that billing documents belong to search_invoices, and that search_orders does not return them, resolves the ambiguity directly.

A is wrong because opaque names remove useful signal instead of adding it. B is wrong because it is heavy and unnecessary; tool descriptions are the cheap, first lever to try. D is wrong because brittle keyword routing in code adds maintenance and misroutes edge cases that a clear description would handle.

Reference: Define tools - Claude Platform Docs

Practice Test 1 ›

Study guides for Claude Certified Architect, Foundations