Retail & E-commerce

Conversational Shopping Copilot

Designed for Customer

Let a shopper describe a need in natural language and receive grounded product recommendations with live price, promotion, and fulfillment promise, while the basket and consent state stay authoritative in Cosmos DB.

Contract RET-01 · primary aggregate ShoppingSession · mode loading

Decision brief

Confirm basket update or checkout handoff: 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

Shopper

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.

Business problem

A shopper asks for a waterproof running jacket under 150 dollars that can arrive before Saturday's race; the copilot retrieves three candidates, filters to the two promisable from the nearby fulfillment node, cites review evidence on breathability, applies a stackable 15 percent seasonal offer, and waits for the shopper to confirm before adding the jacket to the basket..

Decision to make

Let a shopper describe a need in natural language and receive grounded product recommendations with live price, promotion, and fulfillment promise, while the basket and consent state stay authoritative in Cosmos DB.

Outcome to show

Committed cart lines and order handoff token gives Shopper the evidence needed to begin the final governed business outcome, with the decision trail retained for review.

  1. 1Capture shopping intent and constraints
  2. 2Retrieve candidate SKUs with vector plus attribute filter
  3. 3Validate price, promotion, and availability
  4. 4Present cited recommendation and fit rationale
  5. 5Confirm basket update or checkout handoff

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

Shopper 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 ShoppingSession 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 shopper describe a need in natural language and receive grounded product recommendations with live price, promotion, and fulfillment promise, while the basket and consent state stay authoritative in Cosmos DB.
Primary aggregate
ShoppingSession
Primary container
shoppingSessions
Hierarchical key
/tenantId + /shopperId
Schema version
1

Sample scenario

A shopper asks for a waterproof running jacket under 150 dollars that can arrive before Saturday's race; the copilot retrieves three candidates, filters to the two promisable from the nearby fulfillment node, cites review evidence on breathability, applies a stackable 15 percent seasonal offer, and waits for the shopper to confirm before adding the jacket to the basket.

Physical Cosmos DB containers

Every container provisioned for this accelerator with its hierarchical partition key.
Container Role Hierarchical partition key Document types
shoppingSessions Primary /tenantId + /shopperId ShoppingSession, ConversationTurn, ShopperPreferenceProfile
merchandisingCatalog Reference /tenantId + /productCategoryId ProductCard, PromotionOffer
inventoryPromise Reference /tenantId + /skuId InventorySignal

Document types

Contract document types, their owning container, and their identifier pattern.
Type Container Partition key Identifier pattern Embedding fields
ShoppingSession shoppingSessions /tenantId + /shopperId session::{shopperId}::{sessionId} None
ConversationTurn shoppingSessions /tenantId + /shopperId turn::{sessionId}::{turnSequence} utteranceVector
ProductCard merchandisingCatalog /tenantId + /productCategoryId product::{productCategoryId}::{skuId} descriptionVector, reviewDigestVector
InventorySignal inventoryPromise /tenantId + /skuId inventory::{skuId}::{fulfillmentNodeId} None
PromotionOffer merchandisingCatalog /tenantId + /productCategoryId promo::{productCategoryId}::{promotionId} offerTextVector
ShopperPreferenceProfile shoppingSessions /tenantId + /shopperId preference::{shopperId} affinityVector

Query patterns