# ai-report-writer-for-insurance-claims

*/Software/ai-report-writer-for-insurance-claims*

## Solution Overview

This digital worker ingests raw field adjuster notes, damage photographs, and policy declarations to generate complete property and casualty insurance claim reports. It maps localized damage descriptions against standard industry repair code databases to build an initial line-item estimate. The concrete output is a formatted claim narrative and itemized repair schedule delivered directly into the carrier's claims management system.

Independent adjusting firms and desk adjusters at regional carriers hire this agent to eliminate the transcription and data-entry backlog that follows field inspections. Instead of spending hours translating dictated field notes and sorting unlabeled roof photos into a coherent liability narrative, the desk adjuster receives a completed draft the moment the field inspector uploads the raw site packet.

Operating as an autonomous agent within the core workflow, it consumes unstructured field data via API from mobile inspection apps and outputs structured XML to core platforms like Guidewire or Duck Creek. Because claim approvals carry significant financial and regulatory weight, the agent does not authorize payouts. It routes the drafted narrative to a licensed human adjuster who verifies the coverage determinations, finalizes the indemnity figure, and formally closes the claim.

## Headless Saas Data Model

**Entities**:
- Name: ClaimReport · Description: The generated claim narrative and consolidated repair estimate.
- Name: CarrierWorkspace · Description: The independent adjusting firm or regional carrier tenant environment.
- Name: FieldNote · Description: Raw dictation or transcribed notes uploaded by the field inspector.
- Name: DamagePhoto · Description: Site photographs documenting localized property or structural damage.
- Name: PolicyDeclaration · Description: Coverage rules, limits, and deductibles extracted for the claim.
- Name: RepairLineItem · Description: An itemized schedule entry mapped to a standard industry repair code.
**Relations**:
- To: ClaimReport · From: CarrierWorkspace · Label: manages claims · Cardinality: one-to-many
- To: FieldNote · From: ClaimReport · Label: ingests notes for · Cardinality: one-to-many
- To: DamagePhoto · From: ClaimReport · Label: analyzes photos for · Cardinality: one-to-many
- To: PolicyDeclaration · From: ClaimReport · Label: applies coverage rules from · Cardinality: one-to-one
- To: RepairLineItem · From: ClaimReport · Label: estimates costs via · Cardinality: one-to-many
**Tenant Anchor**: CarrierWorkspace
**Primary Resource**: ClaimReport

## Api Definition

**Protocols**:
- REST
- SDK
- MCP
- Webhooks
**Consumed By**:
- [Claims Orchestration Agent](/Agents/Claims_Orchestration_Agent)
- [Field Triage Agent](/Agents/Field_Triage_Agent)
- [Policy Verification Agent](/Agents/Policy_Verification_Agent)
**Integrations**:
- [Guidewire](/Products/Guidewire)
- [Duck Creek](/Products/Duck_Creek)
- [Xactimate](/Products/Xactimate)
- [AWS S3](/Products/AWS_S3)
**Consumption Model**: An orchestration agent registers the MCP server, calls generate_claim_draft with a payload of S3 image URIs and raw dictation, and subscribes to the claim.drafted webhook to retrieve the XML payload for core system routing.
**Workflow Wrappers**:
- Name: Generate Claim Draft · Wraps: Ingests field notes, photos, and policies to output a complete narrative and estimate.
- Name: Map Repair Codes · Wraps: Translates raw damage descriptions into itemized industry repair codes with material and labor costs.
- Name: Push Core XML · Wraps: Formats the finalized claim report into structured XML for Guidewire or Duck Creek.

## Api Function Cascade

**Ai Role**: As a stateless headless primitive, AI models execute straight-through data extraction, repair code mapping, and narrative generation entirely unattended, relying on the consuming orchestration agents to handle any upstream or downstream human-in-the-loop oversight unless a mapping confidence score triggers an exception flag.
**Cascade**:
- Kind: Code · Note: Retrieves S3 images and raw dictation from the orchestrating agent's payload. · Step: Ingest Payload Assets · Verb: ingest · Realizes: Ingest Claim Documentation · Oversight: none
- Kind: Generative · Note: Pulls damage types, locations, and scope from field notes and photos. · Step: Extract Damage Entities · Verb: extract · Realizes: Analyze Damage Evidence · Oversight: none
- Kind: Generative · Note: Translates extracted damages into industry-standard Xactimate repair codes. · Step: Map Repair Codes · Verb: map · Realizes: Estimate Repair Costs · Oversight: review-on-exception
- Kind: Generative · Note: Generates the full adjuster narrative and itemized estimates. · Step: Draft Report Narrative · Verb: draft · Realizes: Draft Claim Report · Oversight: none
- Kind: Code · Note: Structures the finalized narrative and codes into Guidewire or Duck Creek XML. · Step: Format Core XML · Verb: transform · Realizes: Format System Payload · Oversight: none
- Kind: Code · Note: Fires the claim.drafted event to return the structured XML to the orchestrator. · Step: Emit Drafted Webhook · Verb: emit · Realizes: Notify Subscribing Agents · Oversight: none
**Optimizes**:
- [Report Generation Latency](/Metrics/Report_Generation_Latency)
- [First-Pass Payload Acceptance](/Metrics/First-Pass_Payload_Acceptance)
- [Repair Code Accuracy](/Metrics/Repair_Code_Accuracy)
- [Claim Cycle Time](/Metrics/Claim_Cycle_Time)

## Headless Saas Crud Surface

**Auth Model**: API Key
**Endpoints**:
- GET /claim-reports — list all claim reports
- POST /claim-reports — create a new claim report
- GET /claim-reports/{id} — fetch a specific claim report
- PATCH /claim-reports/{id} — update a claim report
- POST /claim-reports/{id}/finalize — finalize the narrative and consolidate the estimate
- GET /carrier-workspaces — list all carrier workspaces
- POST /carrier-workspaces — provision a new carrier workspace
- GET /carrier-workspaces/{id} — fetch a carrier workspace
- PATCH /carrier-workspaces/{id} — update a carrier workspace
- GET /claim-reports/{claimReportId}/field-notes — list field notes for a claim report
- POST /claim-reports/{claimReportId}/field-notes — ingest a raw field note dictation
- GET /claim-reports/{claimReportId}/field-notes/{id} — fetch a specific field note
- PATCH /claim-reports/{claimReportId}/field-notes/{id} — update a field note
- GET /claim-reports/{claimReportId}/damage-photos — list damage photos for a claim report
- POST /claim-reports/{claimReportId}/damage-photos — upload a new damage photo
- GET /claim-reports/{claimReportId}/damage-photos/{id} — fetch a specific damage photo
- PATCH /claim-reports/{claimReportId}/damage-photos/{id} — update a damage photo
- GET /claim-reports/{claimReportId}/policy-declaration — fetch the policy declaration for a claim report
- PUT /claim-reports/{claimReportId}/policy-declaration — create or replace the policy declaration
- PATCH /claim-reports/{claimReportId}/policy-declaration — update policy declaration coverage terms
- GET /claim-reports/{claimReportId}/repair-line-items — list repair line items for a claim report
- POST /claim-reports/{claimReportId}/repair-line-items — add a repair line item
- GET /claim-reports/{claimReportId}/repair-line-items/{id} — fetch a specific repair line item
- PATCH /claim-reports/{claimReportId}/repair-line-items/{id} — update a repair line item
**Multitenancy**: Row-level isolation
**Webhook Events**:
- claim_report.narrative_finalized
- field_note.transcribed
- damage_photo.analyzed
- policy_declaration.extracted
- repair_line_item.estimated

## Headless Saas Erd

```mermaid
erDiagram
    CarrierWorkspace {
        UUID id PK "tenant key"
        VARCHAR name
        VARCHAR coreSystemPlatform
        TIMESTAMP createdAt
    }
    ClaimReport {
        UUID id PK
        UUID carrierWorkspaceId FK
        VARCHAR claimReference
        VARCHAR draftingStatus
        TEXT finalizedNarrative
        DECIMAL totalIndemnity
    }
    FieldNote {
        UUID id PK
        UUID claimReportId FK
        VARCHAR inspectorName
        TEXT rawDictation
    }
    DamagePhoto {
        UUID id PK
        UUID claimReportId FK
        VARCHAR imageUrl
        VARCHAR localizedDescription
    }
    PolicyDeclaration {
        UUID id PK
        UUID claimReportId FK
        VARCHAR policyNumber
        DECIMAL deductibleAmount
        JSONB coverageTerms
    }
    RepairLineItem {
        UUID id PK
        UUID claimReportId FK
        VARCHAR industryRepairCode
        DECIMAL materialCost
        DECIMAL laborCost
    }
    CarrierWorkspace ||--o{ ClaimReport : "manages claims"
    ClaimReport ||--o{ FieldNote : "ingests notes for"
    ClaimReport ||--o{ DamagePhoto : "analyzes photos for"
    ClaimReport ||--|| PolicyDeclaration : "applies coverage rules from"
    ClaimReport ||--o{ RepairLineItem : "estimates costs via"
```

## Neighborhood

### What it uses

- [Guidewires](/Products/Guidewires) — uses · Products
- [Duck Creek](/Products/Duck_Creek) — uses · Products
- [AWS S3](/Products/AWS_S3) — uses · Products
- [Xactimate](/Products/Xactimate) — uses · Products
- [Hover](/Software/Hover) — uses · Software
- [Amazon S3](/Software/Amazon_S3) — uses · Software
- [S3](/Products/S3) — uses · Products

### Optimizes

- [Report Generation Latency](/Metrics/Report_Generation_Latency) — optimizes · Metrics
- [Claim Cycle Time](/Metrics/Claim_Cycle_Time) — optimizes · Metrics
- [Repair Code Accuracy](/Metrics/Repair_Code_Accuracy) — optimizes · Metrics
- [First-Pass Payload Acceptance](/Metrics/First-Pass_Payload_Acceptance) — optimizes · Metrics
- [Code Mapping Accuracy](/Metrics/Code_Mapping_Accuracy) — optimizes · Metrics
- [Claim Intake Throughput](/Metrics/Claim_Intake_Throughput) — optimizes · Metrics
- [Report Generation Cycle Time](/Metrics/Report_Generation_Cycle_Time) — optimizes · Metrics
- [First-Pass Extraction Rate](/Metrics/First-Pass_Extraction_Rate) — optimizes · Metrics

### Who consumes this

- [Claims Orchestration Agent](/Agents/Claims_Orchestration_Agent) — consumed by · Agents
- [Field Triage Agent](/Agents/Field_Triage_Agent) — consumed by · Agents
- [Policy Verification Agent](/Agents/Policy_Verification_Agent) — consumed by · Agents
- [Desk Adjuster Agent](/Agents/Desk_Adjuster_Agent) — consumed by · Agents
- [Field Intake Agent](/Agents/Field_Intake_Agent) — consumed by · Agents
- [Claim Triage Agent](/Agents/Claim_Triage_Agent) — consumed by · Agents
- [Claims Intake Agent](/Agents/Claims_Intake_Agent) — consumed by · Agents

### Similar Agents

- [Claims Triage Agent](/Agents/Claims_Triage_Agent) — similar · Agents
- [Damage Detection Agent](/Agents/Damage_Detection_Agent) — similar · Agents
- [Policy Verification Worker](/Agents/Policy_Verification_Worker) — similar · Agents
- [Parametric Insurance Agent](/Agents/Parametric_Insurance_Agent) — similar · Agents
- [Risk Pricing Actuary](/Agents/Risk_Pricing_Actuary) — similar · Agents
- [Ag-Risk Assessment Agent](/Agents/Ag-Risk_Assessment_Agent) — similar · Agents
- [Roster Intake Agent](/Agents/Roster_Intake_Agent) — similar · Agents
- [Document Intake Agent](/Agents/Document_Intake_Agent) — similar · Agents
- [Compliance Reporting Agent](/Agents/Compliance_Reporting_Agent) — similar · Agents
- [Document Triage Agent](/Agents/Document_Triage_Agent) — similar · Agents
- [Clause Classifier Agent](/Agents/Clause_Classifier_Agent) — similar · Agents
- [Exception Adjudication Agent](/Agents/Exception_Adjudication_Agent) — similar · Agents

### Similar Startups

- [Adjudicatedock](/Startups/Adjudicatedock) — similar · Startups
- [Manual adjustment firms](/Startups/Manual_adjustment_firms) — similar · Startups
- [Uglydamage](/Startups/Uglydamage) — similar · Startups
- [Adjudicatemanor](/Startups/Adjudicatemanor) — similar · Startups

### Similar Occupations

- [Claims Adjusters, Examiners, and Investigators](/Occupations/Claims_Adjusters,_Examiners,_and_Investigators) — similar · Occupations

### Similar Markets

- [AI-Native Claims Processors](/Markets/AI-Native_Claims_Processors) — similar · Markets

### Similar Problems

- [Field Damage Assessment](/Problems/Field_Damage_Assessment) — similar · Problems

### Similar Software

- [Visual Repair Estimator](/Software/Visual_Repair_Estimator) — similar · Software