Decision owner
Consumer insight manager
The named role remains accountable for the consequential decision.
Consumer Packaged Goods
Designed for Brand manager
Let the brand manager synthesize what consumers are actually saying across reviews, panel surveys, social conversation and qualitative research into brand-level insight that separates a genuine product problem from a packaging, price or availability complaint, with every claim traceable to verbatims.
Contract CON-01 · primary aggregate BrandInsightWorkspace · 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
Consumer insight manager
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
2 approval gates
Approval gates prevent the copilot from making consequential decisions.
A liquid laundry brand sees its 4.4 star average slip to 3.9 in North America over six weeks.
Let the brand manager synthesize what consumers are actually saying across reviews, panel surveys, social conversation and qualitative research into brand-level insight that separates a genuine product problem from a packaging, price or availability complaint, with every claim traceable to verbatims.
approvedBrief gives Brand manager and regulatory reviewer 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.
Consumer insight manager 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: Listening and survey connectors performs multi-source verbatim ingestion using ConsumerVerbatim and produces normalizedVerbatimSet. The transition is deterministic and does not require autonomous model approval.
Why it matters: normalizedVerbatimSet gives Consumer insight synthesis copilot the evidence needed to begin Theme clustering and driver classification, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/multi-source-verbatim-ingestion
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Consumer insight synthesis copilot performs theme clustering and driver classification using normalizedVerbatimSet and produces InsightTheme. The transition is deterministic and does not require autonomous model approval.
Why it matters: InsightTheme gives Consumer insight synthesis copilot the evidence needed to begin Commercial corroboration, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/theme-clustering-and-driver-classification
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Consumer insight synthesis copilot performs commercial corroboration using SalesPerformanceFact and produces corroboratedTheme. The transition is deterministic and does not require autonomous model approval.
Why it matters: corroboratedTheme gives Consumer insight manager the evidence needed to begin Insight manager theme validation, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/commercial-corroboration
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Consumer insight manager performs insight manager theme validation using corroboratedTheme and produces validatedThemeSet. A named human approver must review the evidence before the transition completes.
Why it matters: validatedThemeSet gives Brand manager and regulatory reviewer the evidence needed to begin Brief approval with claim guardrails, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/insight-manager-theme-validation
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Brand manager and regulatory reviewer performs brief approval with claim guardrails using InsightBrief and produces approvedBrief. A named human approver must review the evidence before the transition completes.
Why it matters: approvedBrief gives Brand manager and regulatory reviewer 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/brief-approval-with-claim-guardrails
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 BrandInsightWorkspace evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
brandInsightWorkspaces/tenantId + /brandIdA liquid laundry brand sees its 4.4 star average slip to 3.9 in North America over six weeks. The copilot clusters 6,100 verbatims and finds that 61 percent of the decline traces not to cleaning performance but to a redesigned pour spout that drips, concentrated on the 92-ounce SKU and absent on the 46-ounce. It corroborates with a 3.1 point velocity decline on the 92-ounce in the same period while the 46-ounce is flat, and cites a 2024 usage-and-attitude study noting spout handling as a top-three irritation. The insight manager validates the theme, regulatory clears the language, and the approved brief routes the packaging issue to innovation rather than to formulation.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
brandInsightWorkspaces |
Primary | /tenantId + /brandId |
Brand, ConsumerVerbatim, SalesPerformanceFact, InsightTheme, InsightBrief |
marketResearchLibrary |
Reference | /tenantId + /marketCode |
ResearchStudyChunk |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
Brand |
brandInsightWorkspaces |
/tenantId + /brandId |
brand::{brandId} |
None |
ConsumerVerbatim |
brandInsightWorkspaces |
/tenantId + /brandId |
brand::{brandId}::verbatim::{sourceCode}::{verbatimId} |
verbatimVector |
ResearchStudyChunk |
marketResearchLibrary |
/tenantId + /marketCode |
market::{marketCode}::study::{studyDocId}::{chunkOrdinal} |
chunkVector |
SalesPerformanceFact |
brandInsightWorkspaces |
/tenantId + /brandId |
brand::{brandId}::performance::{periodEndUtc}::{skuCode}::{marketCode} |
None |
InsightTheme |
brandInsightWorkspaces |
/tenantId + /brandId |
brand::{brandId}::theme::{themeId} |
themeVector |
InsightBrief |
brandInsightWorkspaces |
/tenantId + /brandId |
brand::{brandId}::brief::{briefId} |
briefVector |
Surface themes rising fastest in prevalence for the brand's priority markets.
brandInsightWorkspaces
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.brandId = @brandId AND c.type = 'InsightTheme' AND c.trendDirection = 'rising' AND c.validationState != 'rejected' ORDER BY c.prevalencePct DESC
Pull the representative and supporting verbatims backing a theme so a claim can be audited to source.
brandInsightWorkspaces
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.brandId = @brandId AND c.type = 'ConsumerVerbatim' AND c.capturedAtUtc >= @windowStartUtc ORDER BY RANK RRF(VectorDistance(c.verbatimVector, @themeVector), FullTextScore(c.verbatimText, @queryTerms))
Join a theme's affected SKUs to velocity and share movement to test whether the complaint is commercially material.
brandInsightWorkspaces
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.brandId = @brandId AND c.type = 'SalesPerformanceFact' AND ARRAY_CONTAINS(@affectedSkuCodes, c.skuCode) AND c.periodEndUtc >= @trailingPeriodsUtc ORDER BY c.periodEndUtc DESC
Retrieve qualitative study passages relevant to a theme, favoring larger and more recent samples.
marketResearchLibrary
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.marketCode IN (@activeMarkets) AND c.type = 'ResearchStudyChunk' ORDER BY RANK RRF(VectorDistance(c.chunkVector, @queryVector), FullTextScore(c.chunkText, @queryTerms))