Decision owner
Teacher of record
The named role remains accountable for the consequential decision.
Education
Designed for Student
Give each learner a tutor that grounds every explanation, hint and practice item in the district-approved curriculum and the learner's own mastery evidence, adapting pace and representation without ever revealing assessment answers or acting as a grade of record.
Contract EDU-01 · primary aggregate LearnerMasteryProfile · 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
Teacher of record
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 grade 7 student repeatedly misses items on proportional relationships, always inverting the ratio when a unit rate is expressed as a fraction.
Give each learner a tutor that grounds every explanation, hint and practice item in the district-approved curriculum and the learner's own mastery evidence, adapting pace and representation without ever revealing assessment answers or acting as a grade of record.
approvedLearningPath gives Teacher of record 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.
Teacher of record 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: Mastery estimator performs mastery diagnosis from attempt history using PracticeAttempt and produces MasteryState. The transition is deterministic and does not require autonomous model approval.
Why it matters: MasteryState gives Retrieval orchestrator the evidence needed to begin Standard-aligned content retrieval, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/mastery-diagnosis-from-attempt-history
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Retrieval orchestrator performs standard-aligned content retrieval using MasteryState and produces CurriculumChunk. The transition is deterministic and does not require autonomous model approval.
Why it matters: CurriculumChunk gives Personalized learning tutor the evidence needed to begin Scaffolded explanation and hinting, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/standard-aligned-content-retrieval
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Personalized learning tutor performs scaffolded explanation and hinting using CurriculumChunk and produces TutoringTurn. The transition is deterministic and does not require autonomous model approval.
Why it matters: TutoringTurn gives Student with tutor the evidence needed to begin Adaptive practice and misconception tagging, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/scaffolded-explanation-and-hinting
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Automated stage
What happens: Student with tutor performs adaptive practice and misconception tagging using TutoringTurn and produces PracticeAttempt. The transition is deterministic and does not require autonomous model approval.
Why it matters: PracticeAttempt gives Teacher of record the evidence needed to begin Teacher review of proposed learning path, with the decision trail retained for review.
Loading relevant sample records.
Ready to run.
POST /api/domain/workflow/adaptive-practice-and-misconception-tagging
Run this API to see its formatted outcome.
| Field | Value |
|---|
| Field | Value |
|---|
Human approval required
What happens: Teacher of record performs teacher review of proposed learning path using LearningPathPlan and produces approvedLearningPath. A named human approver must review the evidence before the transition completes.
Why it matters: approvedLearningPath gives Teacher of record 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/teacher-review-of-proposed-learning-path
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 LearnerMasteryProfile evidence.
Select a starter question or enter your own.
Loaded live from /api/config, /api/domain/model, and
/api/domain/sample.
learnerMasteryProfiles/tenantId + /learnerIdA grade 7 student repeatedly misses items on proportional relationships, always inverting the ratio when a unit rate is expressed as a fraction. The tutor detects the shared misconception tag across five attempts, stops offering the same algebraic hint, and instead retrieves an approved double-number-line example at the student's reading band. After three correct attempts the mastery estimate for the standard crosses threshold, and the tutor proposes a path that moves to percent change while flagging that the prerequisite on equivalent ratios is still weak. The teacher reviews the transcript, confirms no answer was disclosed during the unit assessment window, and approves the path.
| Container | Role | Hierarchical partition key | Document types |
|---|---|---|---|
learnerMasteryProfiles |
Primary | /tenantId + /learnerId |
LearnerProfile, MasteryState, PracticeAttempt, TutoringTurn, LearningPathPlan |
curriculumLibrary |
Reference | /tenantId + /standardCode |
CurriculumChunk |
| Type | Container | Partition key | Identifier pattern | Embedding fields |
|---|---|---|---|---|
LearnerProfile |
learnerMasteryProfiles |
/tenantId + /learnerId |
learner::{learnerId} |
None |
MasteryState |
learnerMasteryProfiles |
/tenantId + /learnerId |
learner::{learnerId}::mastery::{standardCode} |
None |
CurriculumChunk |
curriculumLibrary |
/tenantId + /standardCode |
standard::{standardCode}::content::{contentDocId}::{chunkOrdinal} |
chunkVector |
PracticeAttempt |
learnerMasteryProfiles |
/tenantId + /learnerId |
learner::{learnerId}::attempt::{attemptTimestampUtc}::{itemId} |
None |
TutoringTurn |
learnerMasteryProfiles |
/tenantId + /learnerId |
learner::{learnerId}::session::{sessionId}::turn::{turnOrdinal} |
None |
LearningPathPlan |
learnerMasteryProfiles |
/tenantId + /learnerId |
learner::{learnerId}::path::{planId} |
None |
Identify standards below the mastery threshold in a course to drive the next practice set.
learnerMasteryProfiles
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.learnerId = @learnerId AND c.type = 'MasteryState' AND c.courseCode = @courseCode AND c.masteryEstimate < @masteryThreshold ORDER BY c.masteryEstimate ASC
Retrieve approved explanations for a standard matched to the learner's reading band and preferred representation.
curriculumLibrary
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.standardCode = @standardCode AND c.type = 'CurriculumChunk' AND c.readingLevelBand = @readingLevelBand AND c.approvalStatus = 'approved' ORDER BY RANK RRF(VectorDistance(c.chunkVector, @queryVector), FullTextScore(c.chunkText, @queryTerms))
Surface repeated misconception tags on a standard so the tutor changes representation instead of repeating the same hint.
learnerMasteryProfiles
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.learnerId = @learnerId AND c.type = 'PracticeAttempt' AND c.standardCode = @standardCode AND c.isCorrect = false AND c.attemptTimestampUtc >= @sinceUtc ORDER BY c.attemptTimestampUtc DESC
Return a cited tutoring transcript for teacher oversight and academic-integrity review.
learnerMasteryProfiles
single-partition
SELECT * FROM c WHERE c.tenantId = @tenantId AND c.learnerId = @learnerId AND c.type = 'TutoringTurn' AND c.sessionId = @sessionId ORDER BY c.turnOrdinal ASC