Appearance
Chatbot học tập: bật, lập chỉ mục, đọc phản hồi
Chatbot học tập là ô trò chuyện trong trang học: học viên hỏi về nội dung khoá, chatbot trả lời dựa trên chính nội dung khoá học và dẫn nguồn. Cách học viên dùng nằm ở AI Chatbot hỗ trợ học tập. Trang này dành cho quản trị viên: bật chatbot, đưa nội dung khoá vào chỉ mục, xử lý "Chatbot chưa sẵn sàng", và đọc đánh giá của học viên.
Một câu
Chatbot chỉ biết những gì đã được lập chỉ mục (index). Sửa nội dung khoá học xong mà không index lại thì chatbot vẫn trả lời theo bản cũ.
Cần chuẩn bị gì
| Thứ cần có | Ở đâu |
|---|---|
| Module AIChatbot (kéo theo AICore, AiCredits, CourseManagement, Learnspace) | Nhà cung cấp bật cho tổ chức |
| Gemini API Key | Cài đặt → Trí tuệ nhân tạo → Khoá API — xem Cài đặt trí tuệ nhân tạo |
| Pinecone API Key + Pinecone Index Host (kho vector) | Cài đặt → Chatbot & Tư vấn AI, tab Cài đặt chung (dưới đây) |
| Ít nhất một khoá học đã index | Cùng trang, tab Index Chatbot |
Trang Cài đặt → Chatbot & Tư vấn AI (tiêu đề Cài đặt Chatbot & Tư vấn AI) gác bằng quyền page_ChatbotSettingsPage; mặc định chỉ quản trị viên có. Nút Khoá API ở đầu trang dẫn sang tab khoá Gemini.
Tab "Cài đặt chung"
Bật/Tắt Chatbot
| Ô | Ý nghĩa |
|---|---|
| Chatbot hỗ trợ học tập | Tắt thì biểu tượng chatbot biến khỏi trang học, và trang Trợ giúp của học viên (/learnspace/help) cũng đóng — cả hai trừ credits theo cùng một tính năng, nên tắt là tắt cả hai. |
Khoá Pinecone
| Ô | Ý nghĩa |
|---|---|
| Pinecone API Key | Khoá từ Pinecone console |
| Pinecone Index Host | URL host của index, dạng https://your-index-xxxxxxx.svc.pinecone.io |
Khoá Pinecone này dùng chung cho chatbot học tập, trợ lý tư vấn và Hỏi kho tri thức.
Cài đặt AI Model
| Ô | Ý nghĩa |
|---|---|
| Nhà cung cấp | Có hai lựa chọn Google Gemini và OpenAI, nhưng chatbot hiện luôn dùng Gemini — chọn OpenAI không có tác dụng |
| Mô hình Embedding | Model biến nội dung khoá học thành vector, ví dụ gemini-embedding-001 |
| Mô hình Sinh văn bản | Model soạn câu trả lời, ví dụ gemini-2.0-flash |
| Nhiệt độ (Temperature) | Độ sáng tạo (0–2). Khuyến nghị 0,1–0,3 cho hỏi đáp bám nội dung. |
| Số token tối đa | Độ dài tối đa một câu trả lời (256–4096) |
Trợ lý tư vấn khoá học có model và tinh chỉnh riêng ở Cài đặt → Trí tuệ nhân tạo → Tư vấn viên khóa học.
Đổi mô hình embedding thì phải index lại toàn bộ
Vector cũ được tạo bằng model cũ. Đổi Mô hình Embedding xong, làm đúng thủ tục ở Lập lại toàn bộ.
Tab "Index Chatbot"
Đầu tab có các nút:
| Nút | Làm gì |
|---|---|
| Làm mới | Tải lại số liệu: Kết nối Pinecone (Đã kết nối / Chưa kết nối), Tổng số vector, Chiều embedding, Độ đầy index |
| Index khóa học | Chọn một khoá. Bật Buộc index lại (bỏ qua cache) nếu khoá đã index trước đó và bạn muốn làm lại. |
| Index tất cả khóa học | Xếp mọi khoá vào hàng đợi; có thể mất vài phút tuỳ số khoá |
| Xóa toàn bộ vectors | Xoá mọi vector của tổ chức ở Pinecone. Đọc khung cảnh báo dưới trước khi bấm. |
Bên dưới là bảng Trạng thái index theo khóa học: lọc theo tên và trạng thái, mỗi dòng có nút Index hoặc Index lại.
| Trạng thái | Nghĩa |
|---|---|
| Chưa index | Khoá chưa có trong chỉ mục; chatbot không biết gì về nó |
| Đang index | Đang chạy trong nền |
| Đã index | Sẵn sàng |
| Thất bại | Lỗi. Thông báo "Thiếu x/y đoạn nội dung…" nghĩa là một phần nội dung không vào được chỉ mục; bấm Index lại để bổ sung. |
| Bị kẹt | Đang index quá 60 phút mà không có kết quả: tiến trình nền có thể đã bị dừng giữa chừng. Bấm Index lại. |
Việc index chạy trong nền: cần tiến trình xử lý hàng đợi của hệ thống đang chạy. Bấm xong mà trạng thái đứng mãi ở Đang index rồi chuyển Bị kẹt thì báo nhà cung cấp dịch vụ.
Chỉ mục gồm nội dung chữ của khoá (khoá, chương, bài) và của mọi loại hoạt động có nội dung chữ. Tổ chức tắt một module thì hoạt động thuộc module đó không bấm mở được từ nguồn trích dẫn.
Khi nào phải index lại
Chatbot chưa tự index lại khi nội dung thay đổi. Index lại khoá (bật Buộc index lại) sau khi:
- thêm, sửa, xoá bài học hay hoạt động có nội dung chữ;
- AI của kho tri thức đổi trạng thái — trang đó có thủ tục riêng.
Không bật Buộc index lại thì khoá đã index sẽ bị bỏ qua.
Lập lại toàn bộ
Khi cần gỡ hẳn nội dung cũ (đổi model embedding, gỡ nội dung nhạy cảm), index lại từng khoá không đủ: dựng lại một khoá không xoá các đoạn thừa của lần trước. Làm vào giờ thấp điểm:
- Xóa toàn bộ vectors → xác nhận.
- Index tất cả khóa học, bật Buộc index lại (bỏ qua cache) → xác nhận.
- Nếu tổ chức dùng trợ lý tư vấn: tab Index Tư vấn → index tất cả.
Xóa toàn bộ vectors xoá mọi vector AI của tổ chức
Không chỉ của chatbot học tập: chỉ mục của trợ lý tư vấn và của Hỏi kho tri thức cũng mất. Chatbot không trả lời được cho tới khi bước 2 xong; trợ lý tư vấn không tự dựng lại (phải làm bước 3). Chi tiết về Hỏi kho: AI của kho tri thức.
Nút báo "Không xoá được nội dung đã index của tenant này…" nghĩa là dịch vụ vector từ chối; dữ liệu chưa bị thay đổi. Thử lại sau hoặc liên hệ nhà cung cấp.
Tab "Index Tư vấn"
Chỉ hiện khi module CourseAdvisor bật. Cùng bộ nút, cho chỉ mục của trợ lý tư vấn khoá học (bong bóng chat trên trang công khai). Bảng chỉ liệt kê khoá đã xuất bản. Cách dùng trợ lý: Trợ lý tư vấn.
"Chatbot chưa sẵn sàng"
Học viên thấy dải vàng "Chatbot chưa sẵn sàng" kèm nút Thử lại khi tổ chức chưa có khoá học nào ở trạng thái Đã index. Cách xử lý:
- Kiểm Kết nối Pinecone ở tab Index Chatbot (bấm Làm mới). Chưa kết nối → kiểm hai ô Pinecone.
- Index ít nhất khoá học viên đang học.
- Chờ trạng thái lên Đã index, nhờ học viên bấm Thử lại.
Dải này xét cả tổ chức, không xét từng khoá: khi đã có một khoá được index, chatbot hiện bình thường ở mọi khoá. Ở khoá chưa index, nó sẽ không tìm được nội dung để trả lời. Vì thế học viên báo "chatbot không biết gì về khoá này" thì xem trạng thái của khoá đó trong bảng.
Hai thông báo khác học viên có thể gặp:
| Thông báo | Nghĩa |
|---|---|
| "Hệ thống tra cứu tài liệu đang tạm thời không phản hồi… câu hỏi này không bị tính tín dụng." | Pinecone không trả lời được. Tạm thời; không trừ credits. Kéo dài thì kiểm kết nối. |
| Câu báo hết credits | Ví của học viên hết → Credits AI |
Chi phí
Mỗi tin nhắn trừ ví học viên theo tính năng chatbot.message (mặc định 1 credit một tin, tối đa 5), chỉnh ở AI → Giá credits theo tính năng. Trang Trợ giúp của học viên tính cùng tính năng này. Việc index không trừ ví ai: nó ghi vào sổ chi phí hệ thống, xem Theo dõi chi phí AI.
Bối cảnh lộ trình
Học viên đang theo một lộ trình học cá nhân thì chatbot được kèm một bản tóm tắt ngắn về lộ trình, giai đoạn và mục đang học, để câu trả lời bám đúng chỗ họ đang đứng. Bản tóm tắt lấy một lần mỗi phiên chat: lộ trình đổi giữa chừng thì phiên sau mới thấy.
Bối cảnh này thêm khoảng 200–800 token đầu vào cho mỗi tin nhắn. Hiện chưa có ô trên giao diện để tắt nó; tổ chức muốn tắt để giảm chi phí thì liên hệ nhà cung cấp dịch vụ.
Đọc phản hồi của học viên
Mỗi câu trả lời của chatbot có hai nút Hữu ích / Không hữu ích. Xem tổng hợp ở AI → Phản hồi chatbot.
- Số trên mục menu là số lượt Không hữu ích trong 7 ngày gần nhất.
- Cột: Đánh giá, Câu trả lời, Học viên, Khóa học, Thời điểm đánh giá. Lọc theo Đánh giá (Hữu ích / Không hữu ích) và theo 7 ngày gần nhất.
- Mở một dòng để đọc Câu trả lời của AI, Câu hỏi trước đó của học viên và Bối cảnh phiên (kể cả bối cảnh lộ trình nếu có).
- Xoá một dòng chỉ xoá bản ghi đánh giá; câu trả lời gốc vẫn giữ trong lịch sử chat của học viên.
Quyền: view_any_chat_feedback, view_chat_feedback, delete_chat_feedback, delete_any_chat_feedback; mặc định chỉ quản trị viên có.
Cách dùng phản hồi: nhiều lượt Không hữu ích dồn vào một khoá thường là dấu hiệu khoá đó chưa được index lại sau khi sửa, hoặc nội dung chữ của khoá quá mỏng để chatbot có gì mà dẫn.
Câu hỏi thường gặp
Học viên không thấy biểu tượng chatbot. Công tắc Chatbot hỗ trợ học tập đang tắt, hoặc module AIChatbot chưa bật cho tổ chức.
Đã sửa bài học mà chatbot vẫn trả lời theo nội dung cũ. Index lại khoá đó với Buộc index lại (bỏ qua cache) — xem Khi nào phải index lại.
Nút index đỏ ngay khi bấm. Thường là khoá Gemini hoặc Pinecone sai. Bấm Khoá API ở đầu trang để kiểm khoá Gemini; kiểm hai ô Pinecone ở tab Cài đặt chung.