Insurance

Policyholder Service Agent

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

Confirm and commit the policy change: evidence ready for review

This brief starts with the decision, evidence, and accountable owner. The guided workflow then shows how the recommendation was produced.

Decision signals

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.

Business problem

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..

Decision to make

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.

Outcome to show

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.

  1. 1Verify caller and load policy context
  2. 2Classify the service intent
  3. 3Retrieve grounded answer or balance explanation
  4. 4Quote the endorsement and premium impact
  5. 5Confirm and commit the policy change

Step 1 of 5

Ready: Start with the business question, then use the single button above.

The output appears here immediately. More technical evidence remains available below.

System logic, GenAI, and human accountability

The demonstration keeps deterministic controls, AI assistance, and approval separate.

System logic

Source systems enforce identity, workflow order, policy filters, and record updates.

GenAI contribution

Retrieval and generation assemble relevant evidence into a cited recommendation or draft.

Human accountability

Policyholder and representative verifies material claims and approves the consequential action.

Workflow stages

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.

Seeded record
Loading
Document type
Loading
Container
Loading
Partition key
Loading
Current stage
Loading

API demonstration guidance

Run a stage to see its explanation, evidence, full request, and full response.

Grounded chat

Ask a question and receive an answer grounded in retrieved ServiceInteraction evidence.

Answer and evidence

Select a starter question or enter your own.

Evidence

Domain implementation workspace

Loaded live from /api/config, /api/domain/model, and /api/domain/sample.

Domain objective
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.
Primary aggregate
ServiceInteraction
Primary container
serviceInteractions
Hierarchical key
/tenantId + /policyholderId
Schema version
1

Sample scenario

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.

Physical Cosmos DB containers

Every container provisioned for this accelerator with its hierarchical partition key.
Container Role Hierarchical partition key Document types
serviceInteractions Primary /tenantId + /policyholderId ServiceInteraction, PolicySummary, BillingLedgerEntry, EndorsementRequest
insuranceKnowledgeLibrary Reference /tenantId + /articleId ProductKnowledgeArticle

Document types

Contract document types, their owning container, and their identifier pattern.
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

Query patterns