# aws-samples/sample-agentic-insurance-claims-processing-eks architecture

> Architecture diagram of the GitHub repository aws-samples/sample-agentic-insurance-claims-processing-eks, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/aws-samples/sample-agentic-insurance-claims-processing-eks
- Repository: https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks

## Overview

This is an AI-assisted insurance claims adjudication application. Claimants submit claims through persona portals; the coordinator enriches and analyzes claims, routes high-risk or uncertain cases for human review, and persists claim and decision data. Separate agent modules cover fraud, policy, and investigation, while supervisor analytics, simulated claim intake, and external-data integrations support the broader product. The coordinator’s references to the human workflow, external manager, and database are indexed; unsampled agent wiring is shown only where the README documents it.

Main entry points: [`applications/insurance-claims-processing/src/langgraph_agentic_coordinator.py`](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_agentic_coordinator.py) (Claims Coordinator), [`applications/insurance-claims-processing/src/database_models.py`](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/database_models.py) (Claims Database), [`applications/insurance-claims-processing/src/external_integrations/agentic_external_manager.py`](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/agentic_external_manager.py) (External Data Manager), [`applications/insurance-claims-processing/src/persona_web_interface.py`](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/persona_web_interface.py) (Staff Portals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Portals and Intake"]
  node_claimant["Claimant Portal"]
  node_personas["Staff Portals"]
  node_web["Claims Web UI<br/>[web_interface.py]"]
  node_simulator["Claims Simulator"]
end

subgraph group_adjudication["Claims Adjudication"]
  node_coordinator["Claims Coordinator"]
  node_fraud["Fraud Agent"]
  node_policy["Policy Agent"]
  node_investigation["Investigation Agent"]
  node_memory["Agent Shared Memory"]
  node_human["Human Review Workflow"]
  node_dynamic["Adaptive Workflows"]
  node_negotiation["Agent Negotiation"]
end

subgraph group_support["Domain Services"]
  node_llm["LLM Reasoning"]
  node_external["External Data Manager"]
  node_thirdparty["Third-Party Data APIs"]
  node_coreintegration["Claims Core Integration"]
  node_data["Sample Data Loader<br/>[data_loader.py]"]
  node_externalapi["External Integrations API<br/>[main.py]"]
end

subgraph group_state["Data and Analytics"]
  node_claimsdb[("Claims Database<br/>[database_models.py]")]
  node_models["Enhanced Claim Models<br/>[enhanced_models.py]"]
  node_analytics["Actuarial Analytics"]
end

node_claimant_actor(("Claimant"))
node_adjuster_actor(("Adjuster / SIU"))
node_supervisor_actor(("Supervisor"))
node_mongodb[("MongoDB")]

node_claimant_actor -->|"files claims"| node_claimant
node_adjuster_actor -->|"reviews claims"| node_personas
node_supervisor_actor -->|"views KPIs"| node_personas
node_claimant -->|"reads claims"| node_claimsdb
node_personas -->|"reads claims"| node_claimsdb
node_web -->|"requests human tasks"| node_coordinator
node_coordinator -->|"enriches claims"| node_external
node_coordinator -->|"assigns review"| node_human
node_coordinator -->|"uses claim data"| node_claimsdb
node_coordinator -->|"routes analysis"| node_fraud
node_coordinator -->|"routes analysis"| node_policy
node_coordinator -->|"routes investigation"| node_investigation
node_fraud -->|"requests reasoning"| node_llm
node_externalapi -->|"queries sources"| node_external
node_external -.->|"uses data APIs"| node_thirdparty
node_external -.->|"connects claims core"| node_coreintegration
node_simulator -.->|"submits claims"| node_coordinator
node_data -.->|"loads records"| node_claimsdb
node_claimsdb -->|"persists documents"| node_mongodb
node_models -.->|"defines claim data"| node_claimsdb
node_analytics -.->|"analyzes claim data"| node_claimsdb
node_dynamic -.->|"adapts workflows"| node_coordinator
node_negotiation -.->|"supports collaboration"| node_coordinator
node_memory -.->|"retains agent state"| node_fraud

click node_claimant "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/persona_web_interface.py"
click node_personas "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/persona_web_interface.py"
click node_web "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/web_interface.py"
click node_simulator "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/real_time_claims_simulator.py"
click node_coordinator "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_agentic_coordinator.py"
click node_fraud "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_fraud_agent.py"
click node_policy "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_policy_agent.py"
click node_investigation "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_investigation_agent.py"
click node_memory "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_shared_memory.py"
click node_human "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/human_workflow_manager.py"
click node_dynamic "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/shared/dynamic_workflow_engine.py"
click node_negotiation "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/shared/agent_negotiation_protocol.py"
click node_llm "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/shared/authentic_llm_integration.py"
click node_external "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/agentic_external_manager.py"
click node_thirdparty "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/third_party_data_apis.py"
click node_coreintegration "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/claims_core_integration.py"
click node_data "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/data_loader.py"
click node_claimsdb "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/database_models.py"
click node_models "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/enhanced_models.py"
click node_analytics "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/analytics/actuarial_models.py"
click node_externalapi "https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/main.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_claimant,node_personas,node_web,node_simulator toneBlue
class node_coordinator,node_fraud,node_policy,node_investigation,node_memory,node_human,node_dynamic,node_negotiation,node_mongodb toneAmber
class node_llm,node_external,node_thirdparty,node_coreintegration,node_data,node_externalapi toneMint
class node_claimsdb,node_models,node_analytics toneRose
class node_claimant_actor,node_adjuster_actor,node_supervisor_actor toneIndigo
```

## Components

### Portals and Intake

- [Claimant Portal](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/persona_web_interface.py): `applications/insurance-claims-processing/src/persona_web_interface.py`
- [Staff Portals](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/persona_web_interface.py): `applications/insurance-claims-processing/src/persona_web_interface.py`
- [Claims Web UI](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/web_interface.py): `applications/insurance-claims-processing/src/web_interface.py`
- [Claims Simulator](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/real_time_claims_simulator.py): `applications/insurance-claims-processing/src/real_time_claims_simulator.py`

### Claims Adjudication

- [Claims Coordinator](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_agentic_coordinator.py): `applications/insurance-claims-processing/src/langgraph_agentic_coordinator.py`
- [Fraud Agent](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_fraud_agent.py): `applications/insurance-claims-processing/src/langgraph_fraud_agent.py`
- [Policy Agent](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_policy_agent.py): `applications/insurance-claims-processing/src/langgraph_policy_agent.py`
- [Investigation Agent](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_investigation_agent.py): `applications/insurance-claims-processing/src/langgraph_investigation_agent.py`
- [Agent Shared Memory](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/langgraph_shared_memory.py): `applications/insurance-claims-processing/src/langgraph_shared_memory.py`
- [Human Review Workflow](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/human_workflow_manager.py): `applications/insurance-claims-processing/src/human_workflow_manager.py`
- [Adaptive Workflows](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/shared/dynamic_workflow_engine.py): `applications/insurance-claims-processing/src/shared/dynamic_workflow_engine.py`
- [Agent Negotiation](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/shared/agent_negotiation_protocol.py): `applications/insurance-claims-processing/src/shared/agent_negotiation_protocol.py`

### Domain Services

- [LLM Reasoning](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/shared/authentic_llm_integration.py): `applications/shared/authentic_llm_integration.py`
- [External Data Manager](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/agentic_external_manager.py): `applications/insurance-claims-processing/src/external_integrations/agentic_external_manager.py`
- [Third-Party Data APIs](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/third_party_data_apis.py): `applications/insurance-claims-processing/src/external_integrations/third_party_data_apis.py`
- [Claims Core Integration](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/claims_core_integration.py): `applications/insurance-claims-processing/src/external_integrations/claims_core_integration.py`
- [Sample Data Loader](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/data_loader.py): `applications/insurance-claims-processing/src/data_loader.py`
- [External Integrations API](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/external_integrations/main.py): `applications/insurance-claims-processing/src/external_integrations/main.py`

### Data and Analytics

- [Claims Database](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/database_models.py): `applications/insurance-claims-processing/src/database_models.py`
- [Enhanced Claim Models](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/enhanced_models.py): `applications/insurance-claims-processing/src/enhanced_models.py`
- [Actuarial Analytics](https://github.com/aws-samples/sample-agentic-insurance-claims-processing-eks/blob/main/applications/insurance-claims-processing/src/analytics/actuarial_models.py): `applications/insurance-claims-processing/src/analytics/actuarial_models.py`

### Other components

- **Claimant**
- **Adjuster / SIU**
- **Supervisor**
- **MongoDB**

## Connections

- Claimant → Claimant Portal: files claims (evidence: `README.md`)
- Adjuster / SIU → Staff Portals: reviews claims (evidence: `README.md`)
- Supervisor → Staff Portals: views KPIs (evidence: `README.md`)
- Claimant Portal → Claims Database: reads claims (evidence: `applications/insurance-claims-processing/src/persona_web_interface.py`)
- Staff Portals → Claims Database: reads claims (evidence: `applications/insurance-claims-processing/src/persona_web_interface.py`)
- Claims Web UI → Claims Coordinator: requests human tasks (evidence: `applications/insurance-claims-processing/src/web_interface.py`)
- Claims Coordinator → External Data Manager: enriches claims (evidence: `applications/insurance-claims-processing/src/langgraph_agentic_coordinator.py`)
- Claims Coordinator → Human Review Workflow: assigns review (evidence: `applications/insurance-claims-processing/src/langgraph_agentic_coordinator.py`)
- Claims Coordinator → Claims Database: uses claim data (evidence: `applications/insurance-claims-processing/src/langgraph_agentic_coordinator.py`)
- Claims Coordinator → Fraud Agent: routes analysis (evidence: `README.md`)
- Claims Coordinator → Policy Agent: routes analysis (evidence: `README.md`)
- Claims Coordinator → Investigation Agent: routes investigation (evidence: `README.md`)
- Fraud Agent → LLM Reasoning: requests reasoning (evidence: `applications/insurance-claims-processing/src/langgraph_fraud_agent.py`)
- External Integrations API → External Data Manager: queries sources (evidence: `applications/insurance-claims-processing/src/external_integrations/main.py`)
- External Data Manager → Third-Party Data APIs: uses data APIs
- External Data Manager → Claims Core Integration: connects claims core
- Claims Simulator → Claims Coordinator: submits claims
- Sample Data Loader → Claims Database: loads records
- Claims Database → MongoDB: persists documents (evidence: `applications/insurance-claims-processing/src/database_models.py`)
- Enhanced Claim Models → Claims Database: defines claim data
- Actuarial Analytics → Claims Database: analyzes claim data
- Adaptive Workflows → Claims Coordinator: adapts workflows
- Agent Negotiation → Claims Coordinator: supports collaboration
- Agent Shared Memory → Fraud Agent: retains agent state
