Decision owner
Viewer
The named role remains accountable for the consequential decision.
Media, Entertainment & Gaming
Designed for Viewer or player
Help a viewer or player find something worth their time right now by combining catalogue metadata, transcripts, entitlements, and viewing history into explainable recommendations that respect rights windows and parental controls.
Contract MED-01 · primary aggregate ViewerDiscoverySession · 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
Viewer
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 viewer asks for a light 40 minute comedy they have not seen; the concierge filters to titles inside the active regional rights window and under the kids profile maturity ceiling, excludes three already-completed series, explains each pick in one line, and starts playback after the viewer selects one..
Help a viewer or player find something worth their time right now by combining catalogue metadata, transcripts, entitlements, and viewing history into explainable recommendations that respect rights windows and parental controls.
Playback start or confirmed transaction gives Viewer 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.
Viewer 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: Viewer or player performs express what to watch or play using Natural-language mood, time budget, or scene memory and produces Structured discovery intent. The transition is deterministic and does not require autonomous model approval.
Why it matters: Structured discovery intent gives Retrieval agent the evidence needed to begin Retrieve candidates across metadata and transcripts, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/express-what-to-watch-or-play
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Retrieval agent performs retrieve candidates across metadata and transcripts using Intent vector and taste profile and produces Ranked candidate titles and scenes. The transition is deterministic and does not require autonomous model approval.
Why it matters: Ranked candidate titles and scenes gives Rights and controls service the evidence needed to begin Enforce entitlements and parental controls, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/retrieve-candidates-across-metadata-and-transcripts
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Rights and controls service performs enforce entitlements and parental controls using Candidate titles, region, and profile settings and produces Playable, age-appropriate shortlist. The transition is deterministic and does not require autonomous model approval.
Why it matters: Playable, age-appropriate shortlist gives Discovery concierge the evidence needed to begin Explain why each title fits, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/enforce-entitlements-and-parental-controls
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Discovery concierge performs explain why each title fits using Shortlist with taste and scene evidence and produces Recommendations with human-readable reasons. The transition is deterministic and does not require autonomous model approval.
Why it matters: Recommendations with human-readable reasons gives Viewer the evidence needed to begin Confirm playback or purchase, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/explain-why-each-title-fits
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Viewer performs confirm playback or purchase using Selected title with any rental or upgrade cost and produces Playback start or confirmed transaction. A named human approver must review the evidence before the transition completes.
Why it matters: Playback start or confirmed transaction gives Viewer 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/confirm-playback-or-purchase
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 ViewerDiscoverySession evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
viewerDiscoverySessions/tenantId + /viewerProfileIdA viewer asks for a light 40 minute comedy they have not seen; the concierge filters to titles inside the active regional rights window and under the kids profile maturity ceiling, excludes three already-completed series, explains each pick in one line, and starts playback after the viewer selects one.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
viewerDiscoverySessions |
Primary | /tenantId + /viewerProfileId |
ViewerDiscoverySession, EntitlementGrant, ViewingHistoryEntry, ProfileControlSetting |
catalogTitleIndex |
Reference | /tenantId + /titleId |
TitleMetadata, TranscriptHighlight |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
ViewerDiscoverySession |
viewerDiscoverySessions |
/tenantId + /viewerProfileId |
discovery::{viewerProfileId}::{sessionId} |
intentVector |
TitleMetadata |
catalogTitleIndex |
/tenantId + /titleId |
title::{titleId} |
synopsisVector, moodVector |
TranscriptHighlight |
catalogTitleIndex |
/tenantId + /titleId |
transcript::{titleId}::{segmentId} |
segmentVector |
EntitlementGrant |
viewerDiscoverySessions |
/tenantId + /viewerProfileId |
entitlement::{viewerProfileId}::{titleId} |
None |
ViewingHistoryEntry |
viewerDiscoverySessions |
/tenantId + /viewerProfileId |
history::{viewerProfileId}::{playbackId} |
None |
ProfileControlSetting |
viewerDiscoverySessions |
/tenantId + /viewerProfileId |
controls::{viewerProfileId} |
None |
Read viewing history and control settings for the profile in one partition query.
viewerDiscoverySessions
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.viewerProfileId = @viewerProfileId AND c.type IN ('ViewingHistoryEntry','ProfileControlSetting') ORDER BY c.watchedUtc DESC
Restrict candidates to titles inside an active rights window for the viewer's region.
viewerDiscoverySessions
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.viewerProfileId = @viewerProfileId AND c.type = 'EntitlementGrant' AND c.windowStartUtc <= @nowUtc AND c.windowEndUtc > @nowUtc ORDER BY c.windowEndUtc ASC
Knowledge-container query against catalogTitleIndex (bounded fan-out across the /tenantId + /titleId partitions named by the shortlist): find the exact episode or moment a viewer half-remembers, as a bounded fan-out across the title ids returned by the vector shortlist rather than a scan of every viewer partition.
catalogTitleIndex
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.titleId IN (@shortlistedTitleIds) AND c.type = 'TranscriptHighlight' AND ARRAY_CONTAINS(c.sceneTags, @sceneTag) ORDER BY c.startOffsetSeconds ASC
Surface partially watched titles with a meaningful resume point.
viewerDiscoverySessions
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.viewerProfileId = @viewerProfileId AND c.type = 'ViewingHistoryEntry' AND c.completionPercent BETWEEN 5 AND 92 ORDER BY c.watchedUtc DESC