Error Taxonomy

Risicare classifies agent errors using a hierarchical taxonomy designed for AI systems. The taxonomy covers both single-agent failures (perception, reasoning, tool use, memory, output) and multi-agent failures (coordination, communication, orchestration, consensus, resources).

Taxonomy Structure

Module (10)
└── Category (31)
    └── Error Code (154)
        └── Format: MODULE.CATEGORY.CODE

Modules Overview

Quick Reference

Error Code Format

TOOL.EXECUTION.TIMEOUT
  │      │        │
  │      │        └── Code (specific error)
  │      └── Category (error type)
  └── Module (system area)

Severity Levels

Each error code has a severity from 1 to 5:

Using Error Codes

In Dashboards

Filter traces by error code:

error_code:TOOL.EXECUTION.TIMEOUT
error_code:TOOL.*  # All TOOL module errors

In Alerts

Create alerts for specific errors:

alert:
  name: "High timeout rate"
  condition: error_code == "TOOL.EXECUTION.TIMEOUT"
  threshold: "> 5% of traces in 5 minutes"

In Fixes

Target fixes at specific errors:

{
  "fix_type": "retry",
  "target_errors": ["TOOL.EXECUTION.TIMEOUT"],
  "config": { "max_retries": 3, "initial_delay_ms": 1000, "exponential_base": 2.0 }
}

Next Steps

Select a module to see all its error codes: