Quản lý Cơ sở kiến thức
Quản lý KB: tạo, tải tài liệu, gắn vào chatbot, theo dõi trạng thái
Phiên bản: 1.0 | Ngày: 2025-10-19 | Trạng thái: ✅ Hoàn thành
📋 Tổng Quan
Knowledge Base (KB) lưu trữ tài liệu làm “nguồn tham chiếu” cho chatbot. Chatbot dùng KB để trả lời chính xác hơn và có trích dẫn.
Vị trí: Manage → AI → Knowledge Bases
🔐 Quyền Truy Cập
Xem danh sách:
AI_KB_LIST_VIEWXem chi tiết:
AI_KB_ONE_VIEWTạo:
AI_KB_CREATECập nhật:
AI_KB_UPDATEXóa:
AI_KB_DELETE
🆕 Tạo Knowledge Base
Nhấn “Tạo Cơ sở tri thức”
Điền thông tin:
Tên KB (bắt buộc) — ví dụ: “HR Policies 2024”
Loại:
documents(cố định)Mô tả (tùy chọn)
Nhấn “Tạo”
Chờ KB khởi tạo (5-10 giây)
Trạng thái sau tạo: initializing → active
Lưu ý: KB mới trống (0 tài liệu). Hãy upload tài liệu ngay sau khi tạo.
⤴️ Upload Tài Liệu
Hỗ trợ: PDF, DOCX, TXT, MD (tùy cấu hình hệ thống)
Các bước:
Mở KB → tab Documents
Nhấn “Upload Documents”
Chọn files (kéo-thả hoặc chọn từ máy)
Đợi xử lý (indexing) hoàn tất
Trạng thái tài liệu: queued → processing → indexed (hoặc error)
Mẹo nội dung tốt:
Tài liệu rõ ràng, có tiêu đề, mục lục
Tránh scan kém chất lượng
Ưu tiên văn bản có cấu trúc (DOCX, MD)
Chia nhỏ theo chủ đề thay vì 1 file quá lớn
🗂️ Quản Lý Tài Liệu
Đổi tên: Giữ tiêu đề súc tích, phản ánh nội dung
Thay thế: Upload phiên bản mới khi chính sách thay đổi
Xóa: Loại bỏ tài liệu lỗi thời để giảm nhiễu
Xem log/trạng thái: Kiểm tra tiến trình indexing và lỗi
Checklist chất lượng:
🔗 Gắn KB Vào Chatbot
Bạn có thể gắn nhiều KB cho một chatbot.
Cách 1 (từ Chatbot Settings):
Manage → AI → Chatbots → chọn chatbot
Tab Settings → phần Knowledge Bases
Chọn KB → Attach → Lưu
Cách 2 (từ trang KB): Mở KB → “Attach to Chatbot” (nếu có) → chọn chatbot → Xác nhận
Tham khảo: Configure Chatbot (./04-CONFIGURE-CHATBOT.md)
📊 Trạng Thái & Theo Dõi
KB:
active: sẵn sànginitializing: đang khởi tạoprocessing: đang xử lý tài liệuerror: có lỗi (xem chi tiết lỗi)
Documents:
queued|processing|indexed|error
Khi lỗi phổ biến:
File hỏng/không hỗ trợ → chuyển đổi sang PDF/DOCX
Kích thước quá lớn → chia nhỏ
Lỗi mã hóa ký tự → dùng UTF-8
🧠 Best Practices
Thiết kế KB theo chủ đề (HR/IT/Policy/Training)
Mỗi tài liệu tập trung một chủ điểm rõ ràng
Đặt tên thống nhất: <Bộ phận> - <Chủ đề> - <Năm>
Rà soát định kỳ mỗi quý: cập nhật/xóa tài liệu lỗi thời
Sau khi upload nhiều tài liệu: test ngay trong Console
🧯 Khắc Phục Sự Cố
Không upload được: kiểm tra định dạng/giới hạn dung lượng
Indexing lâu: đợi thêm, thử lại, hoặc chia nhỏ file
Chatbot không trích dẫn: xác minh tài liệu đã
indexedvà chatbot đã attach đúng KBTrả lời sai: cải thiện chất lượng tài liệu, bổ sung heading, mục lục
🔗 Tài Liệu Liên Quan
Create Chatbot (./03-CREATE-CHATBOT.md)
Configure Chatbot (./04-CONFIGURE-CHATBOT.md)
Test Console (./07-TEST-CONSOLE.md)
Phiên bản: 1.0 Cập nhật cuối: 2025-10-19 Trạng thái: ✅ Hoàn thành
Last updated