Decision owner
Manager on duty
The named role remains accountable for the consequential decision.
Retail & E-commerce
Designed for Store associate
Answer a store associate's floor question in seconds from current policy, planogram, inventory, and service bulletins, so the customer is served without leaving the aisle or escalating to a manager.
Contract RET-03 · primary aggregate AssociateAssist · 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
Manager on duty
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.
An associate scans a discontinued blender a customer wants to return 45 days after purchase; the copilot cites the 30-day policy, surfaces an active recall bulletin that overrides it, instructs the associate to accept the return and quarantine the unit, and routes the refund exception to the manager on duty for approval..
Answer a store associate's floor question in seconds from current policy, planogram, inventory, and service bulletins, so the customer is served without leaving the aisle or escalating to a manager.
Approved or denied exception with reason gives Manager on duty 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.
Manager on duty 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: Store associate performs ask a floor question on the handheld using Spoken or typed question with scanned SKU and produces Normalized question bound to store context. The transition is deterministic and does not require autonomous model approval.
Why it matters: Normalized question bound to store context gives Retrieval agent the evidence needed to begin Retrieve policy, bulletins, and stock, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/ask-a-floor-question-on-the-handheld
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Retrieval agent performs retrieve policy, bulletins, and stock using Question, storeId, and region scope and produces Ranked evidence with effective-date filter. The transition is deterministic and does not require autonomous model approval.
Why it matters: Ranked evidence with effective-date filter gives Policy reasoning agent the evidence needed to begin Resolve bulletin override against standing policy, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/retrieve-policy-bulletins-and-stock
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Policy reasoning agent performs resolve bulletin override against standing policy using Conflicting policy and bulletin evidence and produces Single authoritative instruction with precedence note. The transition is deterministic and does not require autonomous model approval.
Why it matters: Single authoritative instruction with precedence note gives Associate copilot the evidence needed to begin Deliver a step-by-step floor answer, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/resolve-bulletin-override-against-standing-policy
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Associate copilot performs deliver a step-by-step floor answer using Authoritative instruction and stock location and produces Cited answer with aisle and backroom location. The transition is deterministic and does not require autonomous model approval.
Why it matters: Cited answer with aisle and backroom location gives Manager on duty the evidence needed to begin Escalate exception to the manager on duty, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/deliver-a-step-by-step-floor-answer
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Manager on duty performs escalate exception to the manager on duty using Proposed exception such as an out-of-policy return and produces Approved or denied exception with reason. A named human approver must review the evidence before the transition completes.
Why it matters: Approved or denied exception with reason gives Manager on duty 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/escalate-exception-to-the-manager-on-duty
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 AssociateAssist evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
associateAssists/tenantId + /storeIdAn associate scans a discontinued blender a customer wants to return 45 days after purchase; the copilot cites the 30-day policy, surfaces an active recall bulletin that overrides it, instructs the associate to accept the return and quarantine the unit, and routes the refund exception to the manager on duty for approval.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
associateAssists |
Primary | /tenantId + /storeId |
AssociateAssist, StoreInventorySnapshot, TaskHandoff |
storeOperationsKnowledge |
Reference | /tenantId + /documentId |
PolicyArticle, ServiceBulletin |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
AssociateAssist |
associateAssists |
/tenantId + /storeId |
assist::{storeId}::{associateId}::{shiftDate} |
None |
PolicyArticle |
storeOperationsKnowledge |
/tenantId + /documentId |
policy::{documentId}::{chunkIndex} |
bodyVector |
ServiceBulletin |
storeOperationsKnowledge |
/tenantId + /documentId |
bulletin::{documentId} |
instructionVector |
StoreInventorySnapshot |
associateAssists |
/tenantId + /storeId |
storeinv::{storeId}::{skuId} |
None |
TaskHandoff |
associateAssists |
/tenantId + /storeId |
task::{storeId}::{taskId} |
None |
Knowledge-container query against storeOperationsKnowledge (bounded fan-out across the /tenantId + /documentId partitions named by the shortlist): confirm whether an unexpired recall or correction bulletin overrides standing policy for the scanned SKU, over the bounded bulletin id set returned by the SKU-to-bulletin index.
storeOperationsKnowledge
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.documentId IN (@candidateBulletinIds) AND c.type = 'ServiceBulletin' AND ARRAY_CONTAINS(c.affectedSkus, @skuId) AND c.expiresUtc > @nowUtc ORDER BY c.severity DESC
Tell the associate where the item sits on the floor or in the backroom.
associateAssists
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.storeId = @storeId AND c.type = 'StoreInventorySnapshot' AND c.skuId = @skuId ORDER BY c.refreshedUtc DESC
Knowledge-container query against storeOperationsKnowledge (bounded fan-out across the /tenantId + /documentId partitions named by the shortlist): pull the in-force chunks of the policy documents shortlisted by vector search, narrowed to the store's region so a Texas associate never sees a California-only rule, as a bounded fan-out across the at most ten policy document ids returned by vector shortlisting.
storeOperationsKnowledge
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.documentId IN (@shortlistedDocumentIds) AND c.type = 'PolicyArticle' AND ARRAY_CONTAINS(c.regionScope, @storeRegion) AND c.effectiveFromUtc <= @nowUtc ORDER BY c.effectiveFromUtc DESC
Show tasks created from assists that are still open for this store.
associateAssists
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.storeId = @storeId AND c.type = 'TaskHandoff' AND c.status != 'closed' ORDER BY c.createdUtc ASC