Skip to content

Appendix C: Failure Quick Map ​

SymptomFirst layer to inspectWhat to check
Agent ignores system ruleContextIs the rule present, early, and not truncated?
Agent invents a toolStructured output / toolsIs tool allowlist validation enforced?
Tool arguments are wrongTool contract / validationAre schemas and argument policies clear?
Agent loopsControl loopAre iteration caps and repetition detection active?
Context overflowMemory / contextIs summarization or truncation triggered early?
Unsafe action happensGuardrails / permissionsDid a deterministic boundary fail?
Tool result is uselessTool designDoes the observation give enough actionable state?
Final answer is unsupportedFinal-answer verificationIs completion evidence required?
Cannot debug runObservabilityAre run IDs, spans, raw outputs, and stop reasons recorded?
Cost is too highLoop / context / toolsAre budgets, context size, and tool calls controlled?