Rewrite the tool error `Error 422: invalid request` so that an agent can recover from it in a single step, and explain what makes your version better.

Rewriting a Tool Error So the Agent Can Recover

Match each tool-error response to the agent behaviour it produces.

A tool that returns 'Error 422' teaches the agent nothing. A tool that returns 'since must be an ISO-8601 date; you passed "last week"' turns a dead end into a one-step correction, and is the single highest-leverage change to most tool surfaces.

University of Michigan - Ann Arbor

A topic of the Building AI Agents course. Planned for 2 hours at Medium difficulty.

Designing Tool Schemas

A tool is a named, typed function the model may call, described to it by a name, a natural-language description and a JSON schema for its parameters. The description is prompt engineering, not documentation: it is the only thing standing between the model and a plausible misuse.

Tool

A tool surface designed for a programmer exposes primitives; a tool surface designed for an agent exposes intents. Replacing six granular calls with one that expresses what the agent actually wants removes the six ways it could sequence them wrongly.

Learn Before

Related

Learn After