Decision owner
Pricing committee
The named role remains accountable for the consequential decision.
Telecommunications
Designed for Product manager
Help product managers design commercially sound mobile and broadband offers by testing candidate bundles against segment usage, margin, and regulatory constraints before pricing committee approval and launch.
Contract TEL-03 · primary aggregate OfferDesign · 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
Pricing committee
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.
To defend a high-churn family segment the studio composes three bundles adding a streaming pass and shared data, simulates that the mid variant lifts retention 3.1 points with a 4 percent margin dilution, flags that a zero-rating component breaches one market's net-neutrality rule, and the pricing committee approves the compliant variant for launch..
Help product managers design commercially sound mobile and broadband offers by testing candidate bundles against segment usage, margin, and regulatory constraints before pricing committee approval and launch.
Approved offer released to configuration and launch gives Pricing committee 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.
Pricing committee 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: Product manager performs set the commercial objective and target segments using Growth, retention, or ARPU objective with segments and produces OfferDesign shell with target segments. The transition is deterministic and does not require autonomous model approval.
Why it matters: OfferDesign shell with target segments gives Design agent the evidence needed to begin Compose candidate bundles from catalogue components, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/set-the-commercial-objective-and-target-segments
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Design agent performs compose candidate bundles from catalogue components using Component catalogue and segment usage profiles and produces Candidate bundle variants with cost structure. The transition is deterministic and does not require autonomous model approval.
Why it matters: Candidate bundle variants with cost structure gives Financial modelling service the evidence needed to begin Simulate take-rate, margin, and cannibalization, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/compose-candidate-bundles-from-catalogue-components
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Financial modelling service performs simulate take-rate, margin, and cannibalization using Candidate bundles and segment elasticity and produces MarginSimulation set with sensitivity ranges. The transition is deterministic and does not require autonomous model approval.
Why it matters: MarginSimulation set with sensitivity ranges gives Compliance and feasibility agent the evidence needed to begin Screen regulatory and technical feasibility, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/simulate-take-rate-margin-and-cannibalization
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Compliance and feasibility agent performs screen regulatory and technical feasibility using Bundle structure and market constraints and produces Blocking and advisory findings per market. The transition is deterministic and does not require autonomous model approval.
Why it matters: Blocking and advisory findings per market gives Pricing committee the evidence needed to begin Pricing committee approval, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/screen-regulatory-and-technical-feasibility
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Pricing committee performs pricing committee approval using Shortlisted offers with simulations and findings and produces Approved offer released to configuration and launch. A named human approver must review the evidence before the transition completes.
Why it matters: Approved offer released to configuration and launch gives Pricing committee 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/pricing-committee-approval
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 OfferDesign evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
offerDesigns/tenantId + /productPortfolioIdTo defend a high-churn family segment the studio composes three bundles adding a streaming pass and shared data, simulates that the mid variant lifts retention 3.1 points with a 4 percent margin dilution, flags that a zero-rating component breaches one market's net-neutrality rule, and the pricing committee approves the compliant variant for launch.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
offerDesigns |
Primary | /tenantId + /productPortfolioId |
OfferDesign, SegmentUsageProfile, MarginSimulation |
offerComponentCatalog |
Reference | /tenantId + /componentFamilyId |
OfferComponentCatalogItem |
telecomRegulationLibrary |
Reference | /tenantId + /marketCode |
RegulatoryConstraint |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
OfferDesign |
offerDesigns |
/tenantId + /productPortfolioId |
offerdesign::{productPortfolioId}::{offerId} |
objectiveVector |
SegmentUsageProfile |
offerDesigns |
/tenantId + /productPortfolioId |
segment::{productPortfolioId}::{segmentId} |
None |
OfferComponentCatalogItem |
offerComponentCatalog |
/tenantId + /componentFamilyId |
component::{componentFamilyId}::{componentId} |
componentDescriptionVector |
MarginSimulation |
offerDesigns |
/tenantId + /productPortfolioId |
simulation::{offerId}::{simulationId} |
None |
RegulatoryConstraint |
telecomRegulationLibrary |
/tenantId + /marketCode |
constraint::{marketCode}::{constraintId} |
constraintVector |
Read the offer, its simulations, and target segment profiles in one portfolio partition query.
offerDesigns
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.productPortfolioId = @productPortfolioId AND c.type IN ('OfferDesign','MarginSimulation','SegmentUsageProfile') ORDER BY c.updatedUtc DESC
Keep only candidate offers whose projected margin clears the portfolio floor.
offerDesigns
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.productPortfolioId = @productPortfolioId AND c.type = 'MarginSimulation' AND c.projectedMargin >= @marginFloor ORDER BY c.projectedMargin DESC
Knowledge-container query against telecomRegulationLibrary (bounded fan-out across the /tenantId + /marketCode partitions named by the shortlist): retrieve the regulatory rules in force for the launch markets, fanned out across the small fixed list of target market partitions.
telecomRegulationLibrary
partition-key-fan-out
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.marketCode IN (@launchMarkets) AND c.type = 'RegulatoryConstraint' AND c.effectiveFromUtc <= @launchDateUtc ORDER BY c.effectiveFromUtc DESC
Prioritize segments where churn and ARPU justify a retention offer.
offerDesigns
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.productPortfolioId = @productPortfolioId AND c.type = 'SegmentUsageProfile' AND c.churnRate > @churnThreshold ORDER BY c.averageRevenuePerUser DESC