Struktur AI Agent Guru Les
Beginilah 9 AI Agent, gate keamanan, cache, dan infrastruktur bekerja bersama. Garis putus-putus bergerak menunjukkan arah data mengalir dari siswa hingga model.
Tier 1 — Siswa
Titik masuk. Siswa membuka aplikasi lalu memilih fitur belajar (chat, papan tulis, quiz, dll). Setiap permintaan diberi tag identitas + fitur.
Tier 2 — Gate Keamanan
4 lapis penjaga: (1) Auth Login untuk memverifikasi sesi & persetujuan admin, (2) Rate Limit sliding window 1 jam per fitur, (3) Kredit Harian yang reset midnight WIB, (4) Jadwal & Lokasi untuk mode kelas.
Tier 3A — Belajar Interaktif
3 agent yang mengajar langsung: Guru Chat (tuntun bertahap), Papan Tulis (materi + LaTeX + animasi SVG), dan Belajar Visual (naskah video penjelasan).
Tier 3B — Latihan & Pengujian
3 agent penguji: Kerjakan Soal (foto/PDF/Excel), Quiz Adaptif (skor server-side anti-curang + 5000+ bank soal), dan Rangkuman (ringkasan lengkap dengan kesalahan umum).
Tier 3C — Bahasa & Konten
Speaking Coach (4 mode, 30 bahasa, skor 12 aspek), Edge TTS (suara neural natural), dan Lesson Studio untuk admin merancang modul ajar siap pakai.
Tier 4 — Otak · Cache · Suara
Claude API (Haiku 4.5 default, Sonnet on-demand) dengan prompt caching yang menghemat 90% biaya. Cache Layer menyimpan hasil generasi 90 hari — cache hit = zero cost. Edge TTS Gateway streaming MP3.
Tier 5 — Infrastruktur
Upstash Redis (semua data), Vercel Edge (hosting Next.js), Anthropic (LLM provider), Microsoft Edge Speech (TTS gratis 30 bahasa).
Data yang Dikelola
Akun & peran, sesi chat, riwayat quiz, bank kata, streak belajar, kredit harian, rate counter, modul ajar, dan cache generasi — semua tersimpan aman di Upstash Redis.
Kurikulum & Prinsip
Selaras Kurikulum Nasional 2025/2026 (Fase A–F, Pembelajaran Mendalam, 8 Dimensi Profil Lulusan). 85+ mata pelajaran dari SD hingga Mahasiswa. Prinsip utama: AI menuntun berpikir, BUKAN memberi jawaban instan.
📖 Cara Membaca Diagram
- 1. Aliran dari atas ke bawah. Permintaan siswa turun melewati gate, lalu masuk ke salah satu AI Agent, lalu ke Claude API atau cache, akhirnya ke infrastruktur.
- 2. Warna garis = jenis aliran. Ungu = permintaan siswa, hijau = latihan/quiz, cyan = bahasa/suara, kuning = cache hit (gratis), abu = hosting.
- 3. Garis putus-putus bergerak. Dashes yang mengalir menandakan data sedang berpindah — bukan gambar statis.
- 4. Cache hit = gratis. Kalau materi/rangkuman/quiz sudah pernah dibuat untuk topik itu, Cache Layer melayani tanpa panggil Claude API sama sekali. Kunci penghematan biaya.
- 5. Setiap gate bisa menolak. Kalau siswa belum disetujui admin, rate limit habis, kredit habis, atau di luar jadwal/lokasi kelas, request langsung ditolak sebelum sampai ke AI Agent — hemat biaya & aman.