Appearance
AI Chatbot hỗ trợ học tập
AI Chatbot là trợ lý ảo gắn trong trang học của khóa học — bạn có thể đặt câu hỏi về bài học và nhận trả lời trong vài giây. Chatbot không là LLM tổng quát: nó chỉ trả lời dựa trên nội dung của khóa học bạn đang học, kèm trích dẫn nguồn để bạn kiểm chứng.
Ba trợ lý, ba việc khác nhau — đừng nhầm
| Trợ lý | Ở đâu | Trả lời về |
|---|---|---|
| AI Chatbot (trang này) | Trong trang học của một khoá | Nội dung bài học của chính khoá đó |
| Trợ lý hỗ trợ | Mọi nơi trong Learnspace | Cách dùng hệ thống — không thấy nội dung khoá học của bạn |
| Tư vấn Khoá học AI | Trang công khai, trước khi ghi danh | Nên chọn khoá nào |
Mở chatbot
Trong trang học của một bài (activity bất kỳ), tìm icon AI Chatbot trên thanh công cụ phải (tools sidebar). Nhấn vào → một panel chatbot trượt từ bên phải vào, không che nội dung bài học — bạn vẫn đọc/xem được trong khi chat.
Nhấn X trên header panel hoặc click ra ngoài để đóng — câu hỏi/trả lời được lưu lại, mở lại sau vẫn còn.
Trạng thái khi mở lần đầu
Đang khởi tạo
Lần đầu mở (mỗi session), bạn thấy:
"Đang khởi tạo chatbot..."
Hệ thống:
- Kiểm tra chatbot đã được admin bật chưa.
- Khởi tạo chat session cho bạn trong khóa học này.
- Load lại lịch sử chat trước đó (nếu có).
- Kiểm tra trạng thái index — chatbot có nội dung khóa học để tham chiếu chưa.
Quá trình này thường < 2 giây.
Lời chào mặc định
Nếu chưa từng chat trong khóa này, AI gửi tin chào:
"Xin chào! Tôi là trợ lý AI cho khóa học này. Tôi có thể giúp bạn trả lời các câu hỏi về nội dung bài học. Hãy đặt câu hỏi của bạn!"
Chatbot chưa sẵn sàng
Nếu nội dung khóa học chưa được index (admin chưa đồng bộ vector), bạn thấy banner vàng:
⚠ Chatbot chưa sẵn sàng
Khi đó nút Gửi bị xám, không gửi được. Nhấn Thử lại sau ít phút (admin có thể đang index) hoặc liên hệ quản trị tổ chức.
Đặt câu hỏi
- Gõ câu hỏi vào ô textarea ở dưới cùng.
- Nhấn Enter để gửi (hoặc nút Gửi).
- Dùng Shift+Enter để xuống dòng trong câu hỏi (cho câu hỏi nhiều dòng).
Giới hạn: mỗi câu hỏi tối đa 2.000 ký tự.
Trong lúc AI xử lý, ô input bị disable + hiển thị bullet "Đang xử lý..." (3 chấm bouncing).
Câu trả lời
AI trả lời với:
- Nội dung Markdown — heading, bullet, code block, công thức được render đẹp
- Nguồn tham khảo (Sources) — danh sách bài học/section liên quan AI đã dùng
- Thời điểm gửi (HH:MM)
Nguồn tham khảo (Source citations)
Đây là điểm mạnh nhất so với chatbot tổng quát: mỗi câu trả lời AI sinh ra đính kèm các đoạn nội dung gốc mà nó tham chiếu.
Nguồn được chia làm hai khối, vì chúng dẫn đi hai nơi khác nhau:
Nguồn tham khảo — nội dung trong khoá học. Mỗi dòng hiển thị:
- Tiêu đề bài học — link mở thẳng tới activity gốc trong tab mới (icon link)
- Badge % similarity — độ liên quan giữa câu hỏi của bạn và đoạn nội dung này
Đọc thêm trong hướng dẫn — trang tài liệu sử dụng, mở ra ngoài hệ thống. Xuất hiện khi câu hỏi của bạn chạm tới cách vận hành của hệ thống chứ không phải nội dung bài (vd "đánh dấu đoạn này kiểu gì?"). Khối này không có badge % — với một trang hướng dẫn thì con số đó chẳng nói lên điều gì.
Không thấy khối "Đọc thêm trong hướng dẫn"?
Tổ chức của bạn chưa khai địa chỉ tài liệu hướng dẫn. Nhắc Tenant Admin điền Cài đặt → Chung → Thương hiệu → Đường dẫn tài liệu hướng dẫn — cùng một cấu hình bật mục Trợ giúp ở avatar dropdown.
Màu badge similarity
| Màu | Ý nghĩa |
|---|---|
| Xanh lá | Liên quan cao (≥ 80%) — đoạn này nói thẳng vào câu hỏi |
| Vàng | Liên quan trung bình (60–80%) — có liên quan nhưng cần đọc thêm context |
| Đỏ | Liên quan thấp (< 60%) — chỉ tham chiếu lỏng |
TIP
Nếu tất cả nguồn đều có badge đỏ, có thể câu hỏi của bạn nằm ngoài phạm vi khóa học — câu trả lời AI sinh ra có thể bịa. Hãy đối chiếu kỹ.
Mở nguồn
Nhấn vào tiêu đề bài học → mở activity tương ứng trong tab mới. Mọi loại hoạt động có nội dung chữ mà chatbot đọc được đều mở được theo cách này. Nếu hoạt động thuộc một tính năng tổ chức đã tắt, tiêu đề vẫn hiện nhưng không bấm được.
Đánh giá câu trả lời
Dưới mỗi câu trả lời có hai nút Hữu ích (👍) và Không hữu ích (👎).
- Bấm một nút để đánh giá; bấm lại đúng nút đó để bỏ đánh giá; bấm nút kia để đổi.
- Mỗi câu trả lời chỉ có một đánh giá của bạn.
- Đánh giá giúp tổ chức phát hiện câu trả lời kém để cải thiện nội dung khóa học. Nó không ảnh hưởng tới credit của bạn.
Chatbot biết lộ trình của bạn
Nếu bạn đang có một lộ trình học tập cá nhân và tổ chức bật tính năng này, chatbot nhận thêm một bản tóm tắt ngắn về lộ trình: giai đoạn bạn đang ở và mục kế tiếp. Nhờ đó bạn có thể hỏi kiểu "Tôi nên học gì tiếp?" hay "Bài này liên quan gì tới mục tiêu của tôi?". Bản tóm tắt được lấy một lần khi bắt đầu phiên chat.
Ngữ cảnh hoạt động hiện tại
Khi bạn mở chatbot từ trang một activity cụ thể, AI biết bạn đang ở bài nào (activityId được truyền vào). Câu hỏi của bạn được hiểu trong ngữ cảnh đó:
- "Giải thích lại đoạn vừa rồi" — AI hiểu là đoạn trong bài đang xem
- "Cho ví dụ minh họa" — AI ưu tiên ví dụ liên quan tới activity hiện tại
- "Khái niệm X trong bài này khác X ở bài 3 thế nào?" — AI có thể so sánh giữa bài hiện tại và bài 3
Khi mở chatbot ở trang khóa học (không phải trang activity cụ thể), AI trả lời theo phạm vi toàn khóa học.
Lịch sử chat (persistence)
- Mỗi học viên có một chat session cho mỗi khóa học (
type = 'learning') - Tin nhắn lưu vào DB — quay lại khóa học sau vài ngày, lịch sử vẫn còn nguyên
- Panel hiển thị tối đa 50 tin gần nhất — tin cũ hơn vẫn lưu trong DB nhưng không hiển thị trên UI
TIP
Lịch sử chat không reset giữa các bài học trong cùng khóa — chuyển từ Bài 1 sang Bài 2, chatbot vẫn nhớ những gì bạn vừa hỏi.
AI Credits
Mỗi tin nhắn bạn gửi → trừ AI Credit theo cấu hình chatbot.message của tổ chức.
- Số dư còn lại hiển thị trên một badge phía trên ô nhập — tự cập nhật mỗi lần dùng.
- Hết credit → khi gửi tiếp, AI trả tin báo hết quota (do
AiQuotaExceededException), không tốn credit thêm. Bạn cần nạp credit hoặc đợi admin tăng quota.
Xem chi tiết tại trang AI Credits.
Câu hỏi nên hỏi
AI Chatbot tận dụng tốt nhất khi bạn hỏi về nội dung khóa học:
| Loại | Ví dụ |
|---|---|
| Giải thích khái niệm | "Giải thích cho tôi định nghĩa X trong bài 3 bằng ví dụ thực tế" |
| Tóm tắt | "Tóm tắt 3 điểm chính của bài đọc vừa rồi" |
| So sánh | "Sự khác biệt giữa thuật toán A và B trong khóa này là gì?" |
| Tìm trong khóa | "Khái niệm X được nói ở những bài nào?" |
| Hỏi ngữ cảnh | "Đoạn code ở dòng 12 bài này hoạt động như thế nào?" |
| Ôn tập | "Tạo cho tôi 5 câu hỏi ngắn để ôn lại chương 2" |
| Bổ trợ | "Cho tôi mnemonic để nhớ công thức Y" |
Câu hỏi không nên hỏi
| Tình huống | Vì sao |
|---|---|
| Hỏi tin tức / kiến thức ngoài khóa | Chatbot không có dữ liệu — sẽ trả lời bịa hoặc nói "không có thông tin" |
| Yêu cầu đáp án bài thi/bài tập | Vi phạm liêm chính học thuật, có thể bị tổ chức kỷ luật |
| Yêu cầu code chạy hệ thống bên ngoài | Không thực thi code — chỉ giải thích |
| Hỏi về dữ liệu cá nhân của học viên khác | Bảo mật, không có quyền truy cập |
| Hỏi quá tổng quát "Hôm nay học gì?" | Thiếu ngữ cảnh — AI không hiểu "hôm nay" |
Khi câu trả lời sai / không như mong đợi
AI có thể:
- Hiểu sai ý câu hỏi
- Trả lời chung chung
- Bỏ sót thông tin quan trọng
- "Bịa" (hallucinate) khi nội dung không có trong khóa
Nếu gặp tình huống này:
- Kiểm tra nguồn tham khảo — nếu badge đều đỏ → AI đang đoán mò.
- Hỏi lại cụ thể hơn — thêm bối cảnh (vd: "Trong bài 2 chương 3...").
- Yêu cầu trích dẫn — "Trích lại đúng câu trong bài đọc nói về X".
- Đối chiếu với nội dung gốc — luôn click nguồn để xác minh.
Mẹo dùng AI Chatbot hiệu quả
- Đặt câu hỏi rõ ràng, có ngữ cảnh — "Trong bài đọc về Cấu trúc dữ liệu, giải thích lại Stack vs Queue" tốt hơn "Stack vs Queue khác gì?".
- Tận dụng follow-up — AI nhớ lịch sử trong session: hỏi "Cụ thể hơn được không?" sau câu trả lời chung chung là hợp lệ.
- Yêu cầu định dạng — "Trả lời dạng bullet point" / "Đưa thành bảng so sánh" / "Code ví dụ Python".
- Học chủ động qua chatbot — yêu cầu nó đặt câu hỏi cho bạn thay vì luôn hỏi nó: "Hỏi tôi 3 câu kiểm tra hiểu chương vừa đọc".
- Ghi chú lại trả lời tốt — copy phần hữu ích vào Bookmark của bạn để ôn lại.
Câu hỏi thường gặp
Chatbot có "nhớ" tôi giữa các khóa khác nhau không? Không. Mỗi cặp (user, course) có session riêng. Hỏi về Khóa A xong sang Khóa B → chatbot bắt đầu mới, không tham chiếu chéo.
Khi tôi đăng nhập từ thiết bị khác, lịch sử có còn không? Có. Lịch sử lưu trong DB, không lưu cookie — đăng nhập lại ở thiết bị nào cũng thấy đầy đủ.
Chatbot trả lời tiếng Anh khi tôi hỏi tiếng Việt? Bạn có thể chủ động yêu cầu: "Trả lời tôi bằng tiếng Việt." Mặc định model (Gemini) chọn ngôn ngữ theo câu hỏi của bạn.
Tôi có thể xoá lịch sử chat? Hiện tại chưa có nút xoá ở giao diện học viên. Nếu cần xoá vì lý do riêng tư, liên hệ admin tổ chức.
Chatbot bị treo / loading mãi không trả lời?
- Refresh trang → mở lại chatbot.
- Kiểm tra số dư AI Credit.
- Nếu chatbot trả lời "Hệ thống tra cứu tài liệu đang tạm thời không phản hồi…": đây là sự cố tạm thời ở phần tra cứu nội dung khóa học, không phải do câu hỏi của bạn. Câu hỏi đó không bị tính credit; thử lại sau ít phút.
- Nếu thường xuyên fail, báo admin — có thể API key (Gemini/Pinecone) đã hết quota hoặc lỗi cấu hình.
Tôi có thể tải xuống / export lịch sử chat? Hiện chưa có. Cách tạm: chọn nội dung tin nhắn → copy-paste sang notes cá nhân.
Chatbot có chấm điểm bài tập không? Không. Chatbot chỉ giải thích/hỗ trợ học. Chấm bài tập tự động được làm bởi tính năng riêng (xem Bài tập, Code Practicing).