Education

Personalized Learning Tutor

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

Teacher review of proposed learning path: 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

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.

Business problem

A grade 7 student repeatedly misses items on proportional relationships, always inverting the ratio when a unit rate is expressed as a fraction.

Decision to make

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.

Outcome to show

approvedLearningPath gives Teacher of record the evidence needed to begin the final governed business outcome, with the decision trail retained for review.

  1. 1Mastery diagnosis from attempt history
  2. 2Standard-aligned content retrieval
  3. 3Scaffolded explanation and hinting
  4. 4Adaptive practice and misconception tagging
  5. 5Teacher review of proposed learning path

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

Teacher of record 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 LearnerMasteryProfile 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
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.
Primary aggregate
LearnerMasteryProfile
Primary container
learnerMasteryProfiles
Hierarchical key
/tenantId + /learnerId
Schema version
1

Sample scenario

A 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.

Physical Cosmos DB containers

Every container provisioned for this accelerator with its hierarchical partition key.
Container Role Hierarchical partition key Document types
learnerMasteryProfiles Primary /tenantId + /learnerId LearnerProfile, MasteryState, PracticeAttempt, TutoringTurn, LearningPathPlan
curriculumLibrary Reference /tenantId + /standardCode CurriculumChunk

Document types

Contract document types, their owning container, and their identifier pattern.
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

Query patterns