Cognition · Software component
Counterfactual Explainer
Software componentCognitionCognition & Memoryarc:CounterfactualExplainer
An explanation component that identifies which fact values would need to change, relative to rule condition thresholds, for a rule-based decision to come out differently.
Responsibility. Explains decision boundaries by stating the minimal changes that would alter the outcome.
Also known as: Decision boundary explainer, Counterfactual explanation, What-would-need-to-change explanation, Contrastive explanation generator, Diverse counterfactual explanations
Variant of Decision Explainer abstract
When to choose. Choose when users need to know the minimal changes that would flip the decision (why-not / recourse).
Relationships
invokes dependency
- Decision Engine abstract Ch10.5
is invoked by dependency
reads dependency
is routed to by dynamic
sends data to dynamic
alternative to variability
Design guidance
- SHOULD present counterfactuals carefully to avoid implying gaming is appropriate or that changes are easily achievable.
Quantitative guidance
As stated by the sources; verify before use.
- Loan example: credit score 640→680 (40 points) or debt-to-income 0.52→0.43 each flip denial to approval (Ch10.5).
Classification
- Patterns
- DiCE (Diverse Counterfactual Explanations)Contrastive explanation
- Technologies
- DiCE
- Quality attributes
- Explainability (NIST AI RMF: explainable and interpretable)Functional suitability: correctness and validity (ISO/IEC 25010 | NIST AI RMF: valid)
- Frameworks & regulations
- Fair Credit Reporting Act (specific reasons for credit denial)
Sources
- Ch5.11: T. Nguyen, "Rule-Based Decision Making Fundamentals," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 5.11. ISBN: 9798244538229.
- Ch9.3: T. Nguyen, "Sandboxing and Transparency Foundations," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 9.3. ISBN: 9798244538229.
- Ch10.5: T. Nguyen, "Human-over-the-Loop," in Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam, 1st ed. 2026, ch. 10.5. ISBN: 9798244538229.
- Ref10.02: "Explainability and Interpretability in Agent Systems," unpublished reference note (02-Explainability-Interpretability.md), Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam supplementary materials, 2026. unpublished note
- Ref10.07: "Chapter 10 Summary: Human-AI Interaction and Oversight," unpublished reference note (07-Chapter-10-Summary.md), Mastering Agentic AI Systems: Guide for the NVIDIA NCP-AAI Exam supplementary materials, 2026. unpublished note