| Tài Liệu Hướng Dẫn Sử Dụng Nền Tảng
Chatbot Knowledge Workspace

Cẩm Nang Hướng Dẫn Sử Dụng Nền Tảng Trợ Lý SGK AI

Tài liệu hướng dẫn dành cho Ban Giám Hiệu, Giáo viên và Học sinh sử dụng Trợ lý Giáo dục SGK AI theo chuẩn Chương trình GDPT 2018.

1. Tổng Quan Hệ Thống & Điểm Đột Phá

SGK AI là trợ lý giáo dục hỗ trợ học tập và công việc chuyên môn. Mọi câu trả lời về học liệu đều được đối chiếu với nguồn tài liệu đã được nhà trường kiểm duyệt.

Chuẩn Hóa GDPT 2018
Đối chiếu 100% với bộ SGK chính thống (Kết nối tri thức, Cánh diều, Chân trời sáng tạo) và Công văn 5512/BGDĐT.
Trợ lý phản hồi nhanh
Hỗ trợ giáo viên và học sinh giải đáp, lập kế hoạch và phân tích theo ngữ cảnh lớp học.
Trích Dẫn Minh Chứng [S1] [S2]
Mỗi luận điểm trả lời đều đánh dấu nguồn trang sách, số bài học và hỗ trợ nhấp chuột để xem trích đoạn trang sách gốc.
Phân Tích Chiều Sâu BI AI
Tự động phát hiện học sinh có nguy cơ hổng kiến thức (At-Risk Early Warning) và viết báo cáo sư phạm chuẩn mực.

2. Khởi Động & Cài Đặt Hệ Thống

2.1. Cấu hình biến môi trường (chatbot/.env.local)

Tệp cấu hình máy chủ cục bộ và kết nối mô hình OpenRouter DeepSeek V4.1 Flash:

chatbot/.env.local 
APP_ENV=development
DEMO_MODE=1
ALLOW_LEGACY_KEYS=1
TEACHER_API_KEY=teacher
STUDENT_API_KEY=student
AUTH_PRINCIPALS_FILE=./chatbot/data/auth_principals.json
CORS_ALLOW_ORIGINS=*

SQLITE_DB=./chatbot/data/train.db
KNOWLEDGE_DB=./chatbot/data/knowledge.db
CHROMA_DIR=./chatbot/data/chroma
CHROMA_COLLECTION=chatbot_examples

# Cấu hình OpenRouter (DeepSeek V4.1 Flash)
LLM_PROVIDER_ORDER=openrouter,deepseek,local
LLM_TIMEOUT_SECONDS=30
OPENROUTER_BASE_URL=https://openrouter.ai/api/v1
OPENROUTER_MODEL=deepseek/deepseek-v4.1-flash
OPENROUTER_HTTP_REFERER=http://127.0.0.1:8001
OPENROUTER_APP_NAME=SGK AI Demo

2.2. Lệnh khởi động máy chủ

Khởi chạy uvicorn trên cổng chính 8001 (kèm hỗ trợ chuyển tiếp cổng 8003):

PowerShell (Windows) 
# Cách 1: Chạy trực tiếp qua file batch tự động
.\start_chatbot.bat

# Cách 2: Chạy lệnh uvicorn chuẩn hóa
.\chatbot\.venv310\Scripts\python.exe -m uvicorn chatbot.app:app --env-file chatbot/.env.local --host 127.0.0.1 --port 8001
Kiểm tra trạng thái máy chủ
Truy cập endpoint http://127.0.0.1:8001/health trên trình duyệt. Kết quả đạt chuẩn khi trả về: "ok": true, "model": "deepseek/deepseek-v4.1-flash".

3. Danh Sách Khóa Truy Cập & Phân Quyền (RBAC)

Hệ thống hỗ trợ cơ chế đa trường (Multi-tenant) cách ly tuyệt đối ngữ liệu và điểm số giữa các đơn vị:

Vai trò API Key Phân vùng dữ liệu Quyền hạn chính
Học sinh Demo student-demo-29 hoặc student Trường 29 (Lớp 124) Hỏi đáp bài học, tra cứu lý thuyết SGK, làm bài tương tự, nghe đọc TTS.
Giáo viên Bộ môn teacher hoặc teacher-demo-29 Trường 29 (Toàn trường) Soạn KHBD CV 5512, tạo ma trận đề thi TT 22, tra cứu điểm học sinh, xem Dashboard BI.
Quản trị viên admin Toàn hệ thống Nạp & thẩm định tri thức, duyệt xuất bản SGK, cấu hình tham số AI & Connectors.

4. Hướng Dẫn Sử Dụng Giao Diện Học Sinh

Mở nền tảng theo đường dẫn do nhà trường cung cấp và đăng nhập bằng tài khoản được cấp.

1
Thiết lập cấu hình bài học

Chọn vai trò Học sinh, khối lớp và môn học. Hệ thống sẽ dùng quyền của tài khoản đã đăng nhập.

2
Tận dụng Thanh Chip Gợi Ý Nhanh (#quickStarterBar)

Ngay trên ô gõ nội dung, hệ thống hiển thị thanh cuộn ngang các câu hỏi trọng tâm theo chương trình bài học. Nhấp vào chip (ví dụ: "So sánh 8 và 5, số nào lớn hơn?" hoặc "Số tròn chục lớn nhất có hai chữ số là số nào?") để gửi tức thì.

3
Tương tác Socratic & Nghe Giọng Đọc Chuẩn

Cô giáo AI sẽ hướng dẫn từng bước trực quan, khen ngợi học sinh và đính kèm thẻ trích dẫn SGK. Bấm nút "Dừng đọc / Nghe đọc" để nghe phát âm tiếng Việt tự nhiên chuẩn xác.

4
Luyện tập nâng cao qua Next Action Chips

Dưới câu trả lời, nhấp vào các nút gợi ý: [Cho em bài tương tự], [Giải thích dễ hiểu hơn], hoặc [Em đã hiểu rồi!] để tiếp tục rèn luyện kỹ năng.

5. Hướng Dẫn Sử Dụng Giao Diện Giáo Viên

Chọn chế độ Giáo viên và đăng nhập bằng tài khoản nhà trường cấp.

Các lệnh nghiệp vụ sư phạm được tối ưu hóa:

  • Soạn Kế hoạch bài dạy (KHBD) theo Công văn 5512:
    Câu lệnh mẫu: Soạn KHBD bài Căn bậc hai môn Toán 9 chuẩn CV 5512.
    Hệ thống trả về đầy đủ 4 hoạt động: Mở đầu, Hình thành kiến thức, Luyện tập, Vận dụng; kèm chuẩn YCCĐ cần đạt và thiết bị dạy học.
  • Xây dựng Ma trận & Bản đặc tả đề thi (Thông tư 22/2021/TT-BGDĐT):
    Câu lệnh mẫu: Lập ma trận đặc tả đề kiểm tra giữa kì 1 môn Toán 9 gồm 4 mức độ: Biết, Hiểu, Vận dụng, Vận dụng cao.
  • Tra cứu cơ sở dữ liệu học tập thực tế của học sinh & lớp học:
    Câu lệnh mẫu: Điểm kiểm tra môn Toán của lớp 9C thế nào? hoặc Học sinh ST00142 có điểm kiểm tra và chuyên cần ra sao?.
    Hệ thống tra cứu dữ liệu học tập được phân quyền và hiển thị theo thông tin thực tế, không tự suy diễn.

6. Kiểm Tra Nguồn Tài Liệu

Mỗi nhận định học thuật đều có dấu nguồn để giáo viên, học sinh và phụ huynh kiểm tra lại:

Minh bạch thông tin học liệu
Cuối mỗi tin nhắn phản hồi, hệ thống trình bày bảng Nguồn tài liệu tham khảo bao gồm:
  • Tên sách & Bài học: Sách Giáo Khoa Toán 1 (Bộ Cánh Diều) — Bài 11: So sánh các số.
  • Số trang & Vị trí đoạn: Trang 24 - 25, Chunk #3.
  • Nút [Xem trang sách]: Hiển thị trích đoạn nguyên bản giúp phụ huynh và giáo viên kiểm chứng đối soát.

7. Quản Lý Kho Học Liệu

Mở mục Knowledge từ thanh điều hướng. Chỉ người được phân quyền mới có thể thêm hoặc xuất bản học liệu.

Quy trình 4 bước nạp và xuất bản bài học:

  1. Thêm học liệu: Bấm "+ Thêm nguồn học liệu" và tải lên tài liệu của nhà trường.
  2. Chuẩn bị học liệu: Hệ thống tự động xử lý và sắp xếp nội dung theo bài học.
  3. Kiểm tra nội dung: Giáo viên đối chiếu tài liệu với bản gốc và sửa lỗi nếu có.
  4. Đưa vào sử dụng: Người có quyền xác nhận để học liệu được dùng trong trả lời.

8. Báo Cáo Điều Hành Lớp Học

Mở mục Workspace từ thanh điều hướng để xem báo cáo của lớp được phân quyền.

8.1. Hàng 5 Thẻ Chỉ Số KPI Điều Hành

  • Sĩ số & Chuyên cần: Tỷ lệ đi học và tham gia tiết học đầy đủ (%).
  • Điểm trung bình (ĐTB) & Hệ số dốc (Slope): Đo lường tốc độ tiến bộ qua từng tuần của tập thể lớp.
  • Tỷ lệ nộp bài tập: Đánh giá mức độ chuyên cần tự học ở nhà.
  • Học sinh cần lưu ý (At-Risk): Tự động lọc học sinh có điểm trung bình thấp hoặc vắng học nhiều buổi.
  • Làm chủ chuẩn đầu ra: Tỷ lệ đạt chuẩn kiến thức kỹ năng theo phân phối chương trình.

8.2. Báo Cáo Sư Phạm

Nhấp vào nút "Phân tích" để nhận báo cáo gồm: điểm mạnh, nội dung cần củng cố, học sinh cần hỗ trợ và đề xuất phối hợp với phụ huynh. Có thể in hoặc xuất báo cáo để lưu hồ sơ chuyên môn.

9. Tích Hợp Web Widget Vào Hệ Thống Bên Thứ Ba

Dễ dàng nhúng Trợ lý SGK AI vào bất kỳ website nhà trường, cổng thông tin điện tử, hoặc LMS (Moodle, Canvas, vnEdu, SMAS):

HTML Embed Code 
<!-- Nhúng Trợ lý SGK AI vào Website Nhà Trường -->
<script 
  src="http://127.0.0.1:8001/static/widget.js" 
  data-bot-url="http://127.0.0.1:8001"
  data-grade="1"
  data-subject="Toán"
  data-api-key="student-demo-29"
  data-title="SGK AI — Trợ lý Học tập">
</script>

10. Kịch Bản Bài Học Mẫu (Benchmark Prompts)

Lớp / Môn Câu hỏi / Nhiệm vụ mẫu Kết quả đầu ra chuẩn mực
Lớp 1 — Toán So sánh 8 và 5, số nào lớn hơn? Gợi ý đếm que tính từ 1 đến 10, phân tích số 8 đứng sau số 5 nên 8 lớn hơn 5 ($8 > 5$), trích dẫn SGK Toán 1 Cánh diều trang 24.
Lớp 1 — Toán Số tròn chục lớn nhất có hai chữ số là số nào? Liệt kê các số tròn chục (10, 20, ..., 90), giải thích số 90 đứng cuối cùng nên là số lớn nhất.
Lớp 9 — Toán Soạn KHBD bài Căn bậc hai theo CV 5512 Giáo án 4 hoạt động bài bản, có chuẩn YCCĐ môn Toán 9, tiêu chí đánh giá học sinh.
Lớp 9 — Điểm số Học sinh ST00142 có điểm số môn Toán thế nào? Tra cứu điểm miệng, 15 phút, 1 tiết và chuyên cần của học sinh theo quyền được cấp.

11. Xử Lý Sự Cố Thường Gặp (Troubleshooting)

Không kết nối được
Kiểm tra kết nối mạng, đăng nhập lại và thử lại sau ít phút. Nếu lỗi vẫn tiếp diễn, gửi thời điểm xảy ra lỗi và ảnh màn hình cho quản trị viên nhà trường.
© 2026 Nền tảng Giáo dục SGK AI — Thiết kế và phát triển theo chuẩn Chương trình GDPT 2018 Bộ GD&ĐT.