Tool Error Design

Raw error codes mean nothing to a language model. An agent that receives 429 either retries in a tight loop or gives up; an agent that receives "Rate limited. Wait 30 seconds, or reduce batchSize to 50 and retry" does the right thing. Errors are the tool's chance to teach. Design them with the same care as the success path.

Procedure