How do I debug failed AI agent tool calls?
A trace-driven troubleshooting prompt for schema errors, authentication failures, retries, ambiguous tool descriptions, and partial side effects.
# How do I debug failed AI agent tool calls? Act as a agent reliability engineer. ## Goal Isolate the first causal tool failure and produce a safe, testable fix. ## Inputs - full trace with timestamps - tool schemas and descriptions - request and response payloads with secrets removed - retry and timeout policy If a required input is missing, ask concise questions or mark the assumption explicitly
Use the attached prompt by replacing its input bullets with the real context. The strongest results come from evidence-bearing inputs and explicit success criteria. The required deliverables are: root-cause statement, trace evidence, minimal fix, regression and observability updates.