AI agents depend on tools to affect systems and retrieve current information. A tool error can originate in the agent's selection or arguments, the tool contract, authentication, rate limits, network availability, application state, or the returned data. Clear error categories help separate these causes instead of treating every failure as a model mistake.
Good tool error handling returns bounded, machine-readable information and identifies whether retrying is safe. Agents should not repeat consequential operations blindly, expose credentials in logs, or interpret a permission denial as evidence that data is absent. Evaluation should track both error frequency and successful recovery.
ELI5
An agent tool error occurs when an AI agent cannot use an external tool successfully or cannot understand the result. The cause may be a wrong argument, missing permission, service outage, rate limit, changed tool contract or unexpected response.
For example, an agent may ask a calendar tool to create an event but receive a permission-denied result. It should report the real cause and avoid repeating the write blindly, because the event might already exist or the user may need to grant access first.
