documents_get_risks
Get the latest AI risk analysis for a document the agent owns.
Get the latest AI risk analysis for a document the agent owns. Returns findings (each with id, severity P0/P1/P2, title, description, citation, recommendation), summary counts (p0_count, p1_count, p2_count, overall_severity, headline), and the analysis state (pending / in_review / acknowledged / escalated / resolved). Returns null if no analysis has been run on this document yet — the agent must trigger analysis from the web app first (Risk Analysis modal on the document detail page). The findings are AI-generated risk signals, not legal advice; always defer to the agent's broker or attorney for actual decisions.
Parameters#
| Parameter | Type | Required | Description |
|---|---|---|---|
document_id | string | Yes | The document_id (e.g. "doc_7022796200ff"). Get this from the documents tool or from an escrow's document list. · Max length: 50 · Min length: 1 |
Example prompts#
- "Any red flags in the risk analysis on the Birchwood purchase agreement?"
- "Show me the P0 findings from the AI review of the Garcias disclosure packet."
Safety#
Read-only. This tool never changes your data — it only looks things up. Safe to run anytime.