Start with one reproducible failure
A screenshot of a bad answer is rarely enough to identify the cause. Keep the input, the source documents and the tool response together. Write down the expected behavior in a sentence someone else can judge.…
Turn a failing AI workflow into a practical debugging checklist and a clear support ticket.
An agent cites a policy that is absent from the retrieved documents.
Example · customize the fields to beginRule-based troubleshooting paths selected by failure category; all inputs are processed in your browser.
A screenshot of a bad answer is rarely enough to identify the cause. Keep the input, the source documents and the tool response together. Write down the expected behavior in a sentence someone else can judge.…
Agent failures often start before the final model response. Missing documents belong to retrieval, expired tokens belong to the integration, and repeated write actions belong to orchestration. Test each layer…
Keep a short collection of real failures, normal requests and deliberately incomplete inputs. After each change, run the entire set and record what improved and what regressed. A fluent answer is not evidence…
No. It builds a symptom-based troubleshooting plan locally. It does not access logs or change your systems.
No. Use a redacted description. Secrets are not needed to create the checklist.
No. It suggests tests to distinguish likely causes; it does not observe your runtime.
Yes. Copy or download the brief, then add a minimal reproducible example and sanitized error details.