Cognition · Software component
Failure Analyzer
Software componentCognitionCognition & Memoryarc:FailureAnalyzer
A cognition component that interprets verification failures, such as failed test output, into human-readable error analysis and categorized recurring error patterns that guide the next generation attempt.
Responsibility. Converts failed verification results into error context for the next refinement iteration.
Also known as: analyze_failures node, Error analysis node, Analysis plugin, Error pattern extraction, Root cause analysis
Relationships
invokes dependency
is invoked by dependency
- Agent Controller abstract Ch3.8
reads dependency
- Trace Store Ch3.6
- Working Memory Buffer abstract Ch2.2
writes dependency
- Working Memory Buffer abstract Ch2.2
is routed to by dynamic
sends data to dynamic
is orchestrated by control
produces lifecycle
Design guidance
- SHOULD run with deterministic model settings (temperature 0) because its purpose is analysis rather than creative generation.
- SHOULD record recurring error categories in state so systematic failures can change prompting strategy or trigger termination.
Quantitative guidance
As stated by the sources; verify before use.
- Structured error analysis with a two-attempt limit eliminated 87% of inefficient retry loops (Ch3.8).
Classification
- Patterns
- Generate-test-regenerate loopError pattern detectionStructured failure-type classification (resource unavailable, parameter incorrect, dependency not met) before retry
- Technologies
- LangGraph
- Quality attributes
- Reliability (ISO/IEC 25010 | NIST AI RMF: valid and reliable)Maintainability (ISO/IEC 25010)
- Risks mitigated
- Repeating failed approaches across iterationsUndetected systematic failure
Sources
- Ch2.1: T. Nguyen, "Framework Landscape and Selection," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 2.1. ISBN: 9798244538229.
- Ch2.2: T. Nguyen, "LangGraph," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 2.2. ISBN: 9798244538229.
- Ch3.6: T. Nguyen, "Trace Analysis and Execution Debugging," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 3.6. ISBN: 9798244538229.
- Ch3.8: T. Nguyen, "Action Accuracy Metrics," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 3.8. ISBN: 9798244538229.