Decision owner
Customer success manager and CS leader
The named role remains accountable for the consequential decision.
Technology & Software
Designed for Customer success manager
Give the customer success manager a defensible account health picture that ties product usage against entitlement, support burden, contract commitments and stakeholder sentiment into a specific renewal or expansion play grounded in the account's own evidence.
Contract TEC-02 · primary aggregate CustomerAccountHealth · 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
Customer success manager and CS leader
The named role remains accountable for the consequential decision.
Governed evidence
6 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 480,000 dollar ARR account renewing in 74 days shows its health score falling from 78 to 54.
Give the customer success manager a defensible account health picture that ties product usage against entitlement, support burden, contract commitments and stakeholder sentiment into a specific renewal or expansion play grounded in the account's own evidence.
committedPlay gives Customer success manager and CS leader 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.
Customer success manager and CS leader 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: Account data connectors performs signal consolidation across systems using UsageFact and produces consolidatedSignalSet. The transition is deterministic and does not require autonomous model approval.
Why it matters: consolidatedSignalSet gives Customer success intelligence the evidence needed to begin Health scoring with driver attribution, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/signal-consolidation-across-systems
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Customer success intelligence performs health scoring with driver attribution using consolidatedSignalSet and produces healthScoreWithDrivers. The transition is deterministic and does not require autonomous model approval.
Why it matters: healthScoreWithDrivers gives Retrieval orchestrator the evidence needed to begin Commitment and objection retrieval, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/health-scoring-with-driver-attribution
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Retrieval orchestrator performs commitment and objection retrieval using InteractionChunk and produces evidenceBundle. The transition is deterministic and does not require autonomous model approval.
Why it matters: evidenceBundle gives Customer success intelligence the evidence needed to begin Play recommendation, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/commitment-and-objection-retrieval
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Customer success intelligence performs play recommendation using evidenceBundle and produces AccountPlay. The transition is deterministic and does not require autonomous model approval.
Why it matters: AccountPlay gives Customer success manager and CS leader the evidence needed to begin CSM and manager commitment to the play, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/play-recommendation
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Customer success manager and CS leader performs csm and manager commitment to the play using AccountPlay and produces committedPlay. A named human approver must review the evidence before the transition completes.
Why it matters: committedPlay gives Customer success manager and CS leader 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/csm-and-manager-commitment-to-the-play
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 CustomerAccountHealth evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
customerAccountHealths/tenantId + /accountIdA 480,000 dollar ARR account renewing in 74 days shows its health score falling from 78 to 54. The intelligence attributes 18 points to workflow-automation seats sitting at 41 of 300 entitled for two quarters, 9 points to three severity-2 cases averaging 61 hours to resolution in the integrations area, and the remainder to the executive champion going 97 days without contact against a 30-day cadence. It retrieves the onboarding call passage where the customer set a 200-seat activation target by Q3 and drafts a recovery play pairing an enablement sprint with an executive re-engagement, holding back the expansion ask. The CSM commits the play with the cited evidence frozen for the pipeline review.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
customerAccountHealths |
Primary | /tenantId + /accountId |
Account, UsageFact, SupportSignal, StakeholderRecord, InteractionChunk, AccountPlay |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
Account |
customerAccountHealths |
/tenantId + /accountId |
account::{accountId} |
None |
UsageFact |
customerAccountHealths |
/tenantId + /accountId |
account::{accountId}::usage::{periodEndUtc}::{featureCode} |
None |
SupportSignal |
customerAccountHealths |
/tenantId + /accountId |
account::{accountId}::support::{signalTimestampUtc}::{caseNumber} |
None |
StakeholderRecord |
customerAccountHealths |
/tenantId + /accountId |
account::{accountId}::stakeholder::{stakeholderId} |
None |
InteractionChunk |
customerAccountHealths |
/tenantId + /accountId |
account::{accountId}::interaction::{interactionDocId}::{chunkOrdinal} |
chunkVector |
AccountPlay |
customerAccountHealths |
/tenantId + /accountId |
account::{accountId}::play::{playId} |
rationaleVector |
List accounts renewing inside the horizon whose health score sits in a risk band. Application-side partition-key fan-out book-of-business view: bounded by the tenantId prefix, one CSM's assignment, a renewal horizon and the elevated churn-risk bands.
customerAccountHealths
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.type = 'Account' AND c.assignedCsmUpn = @csmUpn AND c.renewalDateUtc <= @horizonUtc AND c.churnRiskBand IN ('high','critical') ORDER BY c.renewalDateUtc ASC
Expose features where consumption is far under or over entitlement, driving recovery or expansion.
customerAccountHealths
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.accountId = @accountId AND c.type = 'UsageFact' AND c.periodEndUtc >= @trailingStartUtc ORDER BY c.periodEndUtc DESC
Surface influential champions with no meaningful engagement inside their expected cadence.
customerAccountHealths
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.accountId = @accountId AND c.type = 'StakeholderRecord' AND c.influenceLevel IN ('high','executive') AND c.advocacyPosture = 'champion' AND c.lastEngagedUtc < @staleEngagementUtc ORDER BY c.lastEngagedUtc ASC
Retrieve the call or contract passage where a success criterion or commitment was made.
customerAccountHealths
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.accountId = @accountId AND c.type = 'InteractionChunk' AND c.commitmentFlag = true ORDER BY RANK RRF(VectorDistance(c.chunkVector, @queryVector), FullTextScore(c.chunkText, @queryTerms))