Igapäevane LLM-ülevaade

Mis see on

Nupp → Pages Function → Anthropic API → lühike tekstiline ülevaade. Kaks sihtrühma:

• Õpetaja. Klassi kokkuvõte: tugevused, kohad, kus jäädakse maha, ZPD-s olevad mikroskillid, keda jälgida.
• Õpilane. Isiklik vaade: mis on omandatud, mis kasvuvööndis, kus tasub veel proovida.

✦ Loo ülevaade

demo-cohort · 2026-05-08

Nupp kutsub Pages Function'it /api/daily-review, mis arvutab agregaadid koodis, saadab need Claude'ile ja saab lühikese kokkuvõtte. Arvud, mis mudelisse läksid, on avatavas plokis.

LLM-i piir

Projektis on jäik reegel: matemaatilised faktid ei lähe LLM-i kaudu (vt web/lib/explain.ts). See funktsioon piirist kinni peab — mudelisse läheb ainult eelarvutatud koondnäidik failist src/lib/review-stats.ts. Ja süsteemse juhise sees on otsene keeld pKnown-väärtusi, nimesid või teemasid välja mõelda. Avatav plokk “Lähtearvud” näitab täpselt seda JSON-i, mis mudelisse saadeti.

Kapoti all

[DailyReviewPanel widget]
        │  POST /api/daily-review { audience, snapshotKey, focusUserId? }
        ▼
[Pages Function functions/api/daily-review.ts]
   1. valideerib payload'i
   2. FileSnapshotLoader → student_skill_state-kujuline JSON
   3. cohortAggregates / studentAggregates (mediaanid, ZPD-vööndid)
   4. system + user → Anthropic Messages API (prompt caching)
   5. parsib mudeli JSON-vastuse
   6. tagastab { markdown, actionItems, rawNumbers, usage }

Snapshot loetakse hetkel failist src/data/snapshots/demo-cohort.json (loodud skriptiga scripts/seed-demo-snapshot.mjs üle data/matx-define). Kui MATx companion avab student_skill_state lõpp-punkti (PR-1), vahetatakse Pages Function’is üks rida HttpSnapshotLoader-i vastu — skeem vastab kujule (user_id, competency_id, pKnown, attempts, last_updated).

Mudel ja kulu

Vaikimisi: claude-haiku-4-5-20251001. Lühikesed ülevaated ei vaja pikka arutlust. Süsteemiplokile on lisatud cache_control: ephemeral, nii et korduvad vajutused 5 min jooksul loevad selle vahemälust. Ainult nupp käivitab päringu — pole crone’i ega taustavalvet.

Produktsiooniseaded

Cloudflare Pages → Settings → Environment variables: lisa ANTHROPIC_API_KEY (Encrypted). Kohalikult: cp study-guide/.dev.vars.example study-guide/.dev.vars, kleebi võti ja käivita npx wrangler pages dev dist.