Root-cause analysis (RCA) agent
Preview
The RCA agent exists in the platform but may not be enabled by default. Contact us for early access.
The RCA agent is a read-only diagnostic agent. Given a failure - a failed run, test, or query - it examines the available evidence and reports the likely root cause. It does not apply fixes.
Input
- A failure context - a run ID, model name, and/or the error message.
Output
- The likely root cause, with the exact error quoted verbatim.
- The affected assets and relevant lineage.
- A suggested direction for the fix - handed off to the Pipeline Creation agent to actually apply.
How it works
The agent reads the relevant logs, compiled SQL, warehouse metadata, and lineage, classifies the failure (for example, a SQL compilation failure, a dependency-chain failure, or a warehouse resource failure), and reports a structured diagnosis.
Boundaries
- Read-only. The RCA agent cannot edit files, run dbt, or change warehouse state.
- Focused. It diagnoses the specific failure asked about and hands off fixes to the build agent rather than applying them itself.