Decision owner
Policyholder and representative
The named role remains accountable for the consequential decision.
Insurance
Designed for Service representative
Let a service representative resolve policyholder billing, coverage, and endorsement requests in one contact by grounding answers in the live policy, billing ledger, and endorsement rules, with human approval before any policy change is committed.
Contract INS-03 · primary aggregate ServiceInteraction · mode loading
Decision brief
This brief starts with the decision, evidence, and accountable owner. The guided workflow then shows how the recommendation was produced.
The evidence and control points that shape this recommendation.
Decision owner
Policyholder and representative
The named role remains accountable for the consequential decision.
Governed evidence
5 record types
Structured records and cited text ground the recommendation.
Workflow
5 controlled stages
Each transition records its input, output, status, and audit context.
Human controls
1 approval gate
Approval gates prevent the copilot from making consequential decisions.
A policyholder calls about a lapse notice after moving; the agent assist reconstructs three billing events showing a returned payment, explains the reinstatement window using approved state wording, quotes a garaging-address endorsement with a 48 dollar premium increase, and commits the change only after the policyholder verbally confirms..
Let a service representative resolve policyholder billing, coverage, and endorsement requests in one contact by grounding answers in the live policy, billing ledger, and endorsement rules, with human approval before any policy change is committed.
Committed endorsement and confirmation document gives Policyholder and representative the evidence needed to begin the final governed business outcome, with the decision trail retained for review.
Step 1 of 5
| Field | Value |
|---|
| Field | Value |
|---|
The output appears here immediately. More technical evidence remains available below.
The demonstration keeps deterministic controls, AI assistance, and approval separate.
Source systems enforce identity, workflow order, policy filters, and record updates.
Retrieval and generation assemble relevant evidence into a cited recommendation or draft.
Policyholder and representative verifies material claims and approves the consequential action.
Run the stages in order before using the Copilot. Every stage explains what happens, why it matters, the evidence it uses, and the complete API request and response.
Automated stage
What happens: Service representative performs verify caller and load policy context using Caller identity and policy number and produces Verified ServiceInteraction with policy summary. The transition is deterministic and does not require autonomous model approval.
Why it matters: Verified ServiceInteraction with policy summary gives Intent agent the evidence needed to begin Classify the service intent, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/verify-caller-and-load-policy-context
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Intent agent performs classify the service intent using Caller statement or chat message and produces Ranked intents such as billing, endorsement, or coverage question. The transition is deterministic and does not require autonomous model approval.
Why it matters: Ranked intents such as billing, endorsement, or coverage question gives Retrieval agent the evidence needed to begin Retrieve grounded answer or balance explanation, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/classify-the-service-intent
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Retrieval agent performs retrieve grounded answer or balance explanation using Intent plus billing ledger and knowledge articles and produces Cited answer with the exact figures. The transition is deterministic and does not require autonomous model approval.
Why it matters: Cited answer with the exact figures gives Rating service the evidence needed to begin Quote the endorsement and premium impact, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/retrieve-grounded-answer-or-balance-explanation
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Rating service performs quote the endorsement and premium impact using Requested change and eligibility checks and produces EndorsementRequest with premium delta. The transition is deterministic and does not require autonomous model approval.
Why it matters: EndorsementRequest with premium delta gives Policyholder and representative the evidence needed to begin Confirm and commit the policy change, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/quote-the-endorsement-and-premium-impact
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Policyholder and representative performs confirm and commit the policy change using Quoted endorsement with effective date and produces Committed endorsement and confirmation document. A named human approver must review the evidence before the transition completes.
Why it matters: Committed endorsement and confirmation document gives Policyholder and representative the evidence needed to begin the final governed business outcome, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/confirm-and-commit-the-policy-change
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Run a stage to see its explanation, evidence, full request, and full response.
Ask a question and receive an answer grounded in retrieved ServiceInteraction evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
serviceInteractions/tenantId + /policyholderIdA policyholder calls about a lapse notice after moving; the agent assist reconstructs three billing events showing a returned payment, explains the reinstatement window using approved state wording, quotes a garaging-address endorsement with a 48 dollar premium increase, and commits the change only after the policyholder verbally confirms.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
serviceInteractions |
Primary | /tenantId + /policyholderId |
ServiceInteraction, PolicySummary, BillingLedgerEntry, EndorsementRequest |
insuranceKnowledgeLibrary |
Reference | /tenantId + /articleId |
ProductKnowledgeArticle |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
ServiceInteraction |
serviceInteractions |
/tenantId + /policyholderId |
interaction::{policyholderId}::{interactionId} |
None |
PolicySummary |
serviceInteractions |
/tenantId + /policyholderId |
policy::{policyholderId}::{policyNumber} |
None |
BillingLedgerEntry |
serviceInteractions |
/tenantId + /policyholderId |
billing::{policyholderId}::{entryId} |
None |
EndorsementRequest |
serviceInteractions |
/tenantId + /policyholderId |
endorsement::{policyholderId}::{requestId} |
None |
ProductKnowledgeArticle |
insuranceKnowledgeLibrary |
/tenantId + /articleId |
knowledge::{articleId}::{chunkIndex} |
bodyVector |
Read policies, recent billing, and open requests for the caller in one partition query.
serviceInteractions
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.policyholderId = @policyholderId AND c.type IN ('PolicySummary','BillingLedgerEntry','EndorsementRequest') ORDER BY c.postedUtc DESC
Reconstruct the billing timeline that produced the current balance or lapse notice.
serviceInteractions
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.policyholderId = @policyholderId AND c.type = 'BillingLedgerEntry' AND c.policyNumber = @policyNumber AND c.postedUtc > @cycleStartUtc ORDER BY c.postedUtc ASC
Knowledge-container query against insuranceKnowledgeLibrary (bounded fan-out across the /tenantId + /articleId partitions named by the shortlist): return only approved wording valid in the policyholder's state or province, over the bounded article id set returned by vector shortlisting.
insuranceKnowledgeLibrary
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.articleId IN (@shortlistedArticleIds) AND c.type = 'ProductKnowledgeArticle' AND c.jurisdiction IN (@policyJurisdiction,'all') ORDER BY c.approvedUtc DESC
Partition-key fan-out control-plane query: find quoted changes that policyholders have not yet confirmed. It cannot carry the second partition key because the follow-up campaign covers the whole book rather than one caller, so it runs as a tenant-scoped scheduled sweep off the interactive path, bounded by quoted endorsements awaiting confirmation inside the seven-day quote validity window, executed with MaxItemCount paging and continuation tokens.
serviceInteractions
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.type = 'EndorsementRequest' AND c.approvalState = 'quotedAwaitingConfirmation' ORDER BY c.premiumDelta DESC