Decision owner
Field sales representative
The named role remains accountable for the consequential decision.
Consumer Packaged Goods
Designed for Field sales representative
Prepare the field sales representative for each retail account call with a grounded pre-call plan: what the account bought and stopped buying, which planogram gaps and promotion compliance issues exist, and what the trade terms permit them to offer, all cited to the account record and the trade playbook.
Contract CON-03 · primary aggregate RetailAccountCallPlan · 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
Field sales representative
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 representative's 9:00 call is a 38-store grocery banner in the southeast territory.
Prepare the field sales representative for each retail account call with a grounded pre-call plan: what the account bought and stopped buying, which planogram gaps and promotion compliance issues exist, and what the trade terms permit them to offer, all cited to the account record and the trade playbook.
CallOutcome gives Field sales 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.
Field sales 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: Sales execution copilot performs account performance analysis using OrderHistoryFact and produces performanceGapSet. The transition is deterministic and does not require autonomous model approval.
Why it matters: performanceGapSet gives Assortment analyzer the evidence needed to begin Distribution void and compliance detection, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/account-performance-analysis
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Assortment analyzer performs distribution void and compliance detection using AssortmentPosition and produces voidAndComplianceFindings. The transition is deterministic and does not require autonomous model approval.
Why it matters: voidAndComplianceFindings gives Retrieval orchestrator the evidence needed to begin Trade terms grounding, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/distribution-void-and-compliance-detection
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Retrieval orchestrator performs trade terms grounding using voidAndComplianceFindings and produces TradePlaybookChunk. The transition is deterministic and does not require autonomous model approval.
Why it matters: TradePlaybookChunk gives Sales execution copilot the evidence needed to begin Pre-call plan generation, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/trade-terms-grounding
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Sales execution copilot performs pre-call plan generation using TradePlaybookChunk and produces CallPlan. The transition is deterministic and does not require autonomous model approval.
Why it matters: CallPlan gives Field sales representative the evidence needed to begin Representative call execution and commitment capture, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/pre-call-plan-generation
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Field sales representative performs representative call execution and commitment capture using CallPlan and produces CallOutcome. A named human approver must review the evidence before the transition completes.
Why it matters: CallOutcome gives Field sales 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/representative-call-execution-and-commitment-capture
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 RetailAccountCallPlan evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
retailAccountCallPlans/tenantId + /accountIdA representative's 9:00 call is a 38-store grocery banner in the southeast territory. The copilot finds three authorized SKUs absent from shelf for nine weeks, showing 640 cases of foregone volume, and one promotion where the agreed end-cap was never executed although the deduction was taken. It retrieves the tier-2 trade terms clause permitting a 3 percent volume incentive on reinstated distribution without director approval, and the objection-handling passage for the buyer's usual space argument. The representative opens with the void, secures reinstatement of two SKUs plus a corrective end-cap, records the commitments at the shelf, and the unexecuted-display evidence feeds the deduction dispute.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
retailAccountCallPlans |
Primary | /tenantId + /accountId |
RetailAccount, AssortmentPosition, OrderHistoryFact, CallPlan, CallOutcome |
tradePlaybookLibrary |
Reference | /tenantId + /termsTier |
TradePlaybookChunk |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
RetailAccount |
retailAccountCallPlans |
/tenantId + /accountId |
account::{accountId} |
None |
AssortmentPosition |
retailAccountCallPlans |
/tenantId + /accountId |
account::{accountId}::assortment::{skuCode} |
None |
OrderHistoryFact |
retailAccountCallPlans |
/tenantId + /accountId |
account::{accountId}::orders::{periodEndUtc}::{skuCode} |
None |
TradePlaybookChunk |
tradePlaybookLibrary |
/tenantId + /termsTier |
tier::{termsTier}::playbook::{playbookDocId}::{chunkOrdinal} |
chunkVector |
CallPlan |
retailAccountCallPlans |
/tenantId + /accountId |
account::{accountId}::callplan::{callPlanId} |
planVector |
CallOutcome |
retailAccountCallPlans |
/tenantId + /accountId |
account::{accountId}::outcome::{callCompletedUtc}::{callPlanId} |
None |
List authorized SKUs that are not on shelf so the representative can open the call with a specific gap.
retailAccountCallPlans
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.accountId = @accountId AND c.type = 'AssortmentPosition' AND c.authorizationState = 'authorized' AND c.shelfPresenceState IN ('void','outOfStock') ORDER BY c.expectedFacings DESC
Find SKUs whose ordered cases fell materially across the trailing periods for this account.
retailAccountCallPlans
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.accountId = @accountId AND c.type = 'OrderHistoryFact' AND c.periodEndUtc >= @trailingStartUtc ORDER BY c.periodEndUtc DESC
Retrieve only the trade terms and promotion rules that apply to this account's terms tier and the topic at hand.
tradePlaybookLibrary
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.termsTier = @tradeTermsTier AND c.type = 'TradePlaybookChunk' AND c.topicCategory = @topicCategory AND c.effectiveFromUtc <= @callDateUtc ORDER BY RANK RRF(VectorDistance(c.chunkVector, @queryVector), FullTextScore(c.chunkText, @queryTerms))
Show commitments and follow-ups owed across the representative's route. Application-side partition-key fan-out rep worklist: bounded by the tenantId prefix, one representative and a due-date horizon.
retailAccountCallPlans
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.type = 'CallOutcome' AND c.repUpn = @repUpn AND c.followUpDueUtc <= @horizonUtc ORDER BY c.followUpDueUtc ASC