All Lessons
A developer is building a customer support agent with tools for looking up orders, processing refunds, and updating shipping addresses. They have written the tool definitions but are unsure where to place them in the API request to the Claude Messages API. Where should tool definitions be placed in the API request?
1 / 3
intermediate 25 min
Tool Definition Schemas
Based on Anthropic Claude documentation and the CCA-F exam blueprint. Updated June 2026.
Loading lesson content...
A developer defines a tool with parameter 'email': {type: 'string'}. When Claude calls it, the value is sometimes 'user@example.com' and sometimes 12345. What's wrong?
1 / 2
A team has 100+ tools. Claude frequently calls the wrong tool for the task. What architectural fix helps most?
1 / 2