Kho tri thức

Kho tri thức gom một hoặc nhiều nguồn thành thứ agent tra cứu được. Mọi việc đọc, cắt chunk, nhúng vector diễn ra ở đây, nên cùng một nguồn có thể nuôi nhiều kho với cách xử lý khác nhau. Mỗi kho có điểm kết nối MCP / REST riêng để cấp cho từng agent và thu hồi độc lập.

Màn danh sách kho

Vùng	Nội dung
Đầu trang	Nút Tạo kho tri thức
Bộ lọc	Tất cả · Của tôi; ô Tìm kho tri thức
Kiểu hiển thị	Bảng hoặc Thẻ
Bảng kho	Các cột bên dưới; nhấn một dòng để mở kho

Cột	Ý nghĩa
Kho tri thức	Tên, mô tả hoặc số nguồn; nhãn Chỉ mục ngoài nếu kho do pipeline bên ngoài quản lý
Chỉ mục	Trạng thái chỉ mục: Hoạt động, Cần rà soát
Tài liệu	Số tài liệu trong kho
Điểm TB	Điểm truy hồi trung bình
Cần rà soát	Số tài liệu lỗi hoặc cần xử lý
Cập nhật	Lần thay đổi gần nhất
Thao tác	Menu ⋯ với Xoá kho tri thức

Tạo kho tri thức

Trình tạo có bốn bước: Chọn dữ liệu → Pipeline xử lý → Tên & truy cập → Xem lại & tạo.

Chọn dữ liệu

Tích chọn một hoặc nhiều nguồn; mở cây thư mục để chọn tới từng thư mục, từng tệp. Bảng hiện số tệp và số kho đang dùng mỗi nguồn. Mục Nguồn hệ thống có sẵn Văn bản pháp luật - Chỉ mục ngoài, cập nhật tự động hằng ngày. Thiếu dữ liệu thì nhấn Tạo nguồn mới →.

Pipeline xử lý

Chọn pipeline có sẵn cho từng nguồn - Khuyến nghị Tự động theo từng tệp. Màn hình liệt kê số tệp theo loại và cách mỗi loại được xử lý. Mô hình nhúng mặc định của workspace được dùng và khoá sau khi tạo kho.

Tên & truy cập

Nhập Tên kho và Mô tả cho agent (agent đọc dòng này để biết khi nào gọi kho; sửa lại được ở tab Kết nối). Thêm Người quản lý kho - Người sửa cấu hình, rà soát chunk và cấp khoá API.

Xem lại & tạo

Kiểm tra lại toàn bộ rồi tạo kho. Hệ thống bắt đầu xử lý và lập chỉ mục.

Bước 2 – Pipeline xử lý: mỗi loại tệp được xử lý thế nào

Bước 3 – Tên & truy cập: tên kho, mô tả cho agent, người quản lý kho

Loại tệp	Cách xử lý của pipeline Tự động theo từng tệp
DOCX	Cắt theo tiêu đề
PDF	Trích chữ trực tiếp; tự bật OCR nếu là bản scan
XLSX / CSV	Cắt theo hàng, giữ tiêu đề cột
HTML	Bỏ menu, giữ nội dung

Màn chi tiết một kho

Đầu trang tóm tắt số tài liệu, số chunk, chủ sở hữu và số tài liệu cần rà soát, cùng các nút Thử truy hồi, Thêm dữ liệu vào kho và khối Lấy dữ liệu từ (nguồn nào, toàn bộ hay một phần, nút Sửa phạm vi).

Tab Tài liệu

Bảng tài liệu với các cột Tài liệu, Nguồn, Trạng thái (Đã xử lý, Lỗi xử lý), Chunk. Lọc Tất cả / Cần rà soát / Đã tắt, chọn Cột hiển thị, Lọc theo metadata. Nhấn một tài liệu để mở trình xem chunk:

Trình xem chunk: file gốc bên trái, danh sách chunk bên phải

Thành phần	Công dụng
File gốc và danh sách chunk	Đặt cạnh nhau; Cuộn đồng bộ để hai bên chạy theo nhau, phóng to / thu nhỏ file gốc
Lọc chunk	Tất cả · Bản nạp gốc · Đã sửa tay; xem Theo trang
Mỗi chunk	Mã chunk, công tắc Bật / tắt (chunk tắt không được truy hồi), nhãn đã sửa tay
Sửa chunk	Sửa tay nội dung một chunk khi máy cắt sai
Metadata	Trạng thái, nguồn, số chunk, số lượt truy hồi 30 ngày, giá trị metadata, hiệu lực từ / đến ngày, thời điểm tạo, ID tài liệu

Tab Cần rà soát

Hàng chờ việc cần xử lý, chia theo nguyên nhân:

Nhóm	Khi nào xuất hiện
Máy phát hiện khi nạp	OCR dưới ngưỡng 0,80 hoặc bảng nhận diện không chắc chắn
Không nạp được	PDF có mật khẩu, ảnh quá mờ, định dạng lạ - Đã thử lại 3 lần
Người dùng cuối báo sai	Từ 2 lượt “không hữu ích” trở lên trên cùng chunk, gửi qua `submit_feedback`
Thiếu metadata bắt buộc	Gom theo trường; nhấn để lọc rồi sang nguồn sửa hàng loạt
Giá trị metadata không hợp lệ	Ngoài danh sách cho phép, sai định dạng ngày / số
Tệp mới trong thư mục đang lấy lẻ	Thư mục chọn lẻ tệp vừa có tệp mới - Thêm vào kho hay bỏ qua
Xung đột với nguồn	Chunk đã sửa tay nhưng đoạn gốc vừa đổi ở nguồn

Mỗi mục có nút Sửa ở nguồn; dùng Sửa hàng loạt và Duyệt các mục đã sửa khi xử lý nhiều mục.

Tab Cấu hình

Khối	Nội dung
Pipeline theo từng nguồn	Phạm vi và pipeline của mỗi nguồn; nút Đổi pipeline
Chỉ mục & truy hồi	Mô hình nhúng; phương pháp truy hồi; Top-K trước rerank, Top-K trả về, ngưỡng điểm, trọng số vector / từ khoá
Tuỳ chọn truy hồi	Mở rộng lên chunk cha (trả về trọn Điều), Chỉ trả tài liệu còn hiệu lực, Lọc theo metadata tự động
Trường metadata dùng ở kho	Bật / tắt từng trường và chọn Dùng làm bộ lọc MCP
Quy tắc tự động	Bật các quy tắc sinh mục Cần rà soát
Metadata đến từ đâu	Trường nào do nguồn quản lý (chỉ đọc), trường nào do nền tảng quản lý
Độ phủ metadata	Tỷ lệ tài liệu đã có giá trị cho từng trường

Phương pháp truy hồi	Hợp với
Vector thuần	Câu hỏi diễn giải tự do; nhanh nhất
Toàn văn (BM25)	Số hiệu văn bản, tên riêng, mã số
Hybrid + rerank	Kết hợp cả hai rồi xếp hạng lại; mặc định 70% vector, 30% BM25

Tab Kết nối

Mục	Nội dung
Điểm cuối MCP của kho	Trạng thái Đang chạy, nút Kiểm tra
URL	URL MCP `https://<domain>/api/mcp/kb/<kb-id>` và URL REST `.../api/v1/kb/<kb-id>/retrieve` - Giữ nguyên khi đổi tên kho
Đăng nhập OAuth cho MCP	Client tự mở trình duyệt để người dùng đăng nhập và nhấn Cho phép; công tắc MCP chỉ nhận OAuth
Công cụ phơi ra cho agent	`search_<tên_kho>`, `get_document`, `submit_feedback` - Bật / tắt từng công cụ, xem số lượt gọi 7 ngày
Tên công cụ & mô tả cho mô hình	Sửa tên (chỉ khi kho chưa có khoá API) và mô tả; Xem lược đồ tham số (inputSchema)
Khoá API của kho	Cấp khoá mới cho kho này, danh sách khoá, thu hồi
Đoạn cấu hình mẫu	OAuth / Khoá API cho MCP chung, Claude Code, VS Code, Cursor - Nút Sao chép
Ứng dụng đã cấp quyền	Người dùng nào đã cho phép ứng dụng nào qua OAuth; thu hồi
Nhật ký gọi	Mọi lượt gọi MCP / REST (câu hỏi được che), lọc theo khoá và kênh

Lưu ý: Hiện chưa có phân quyền theo tài liệu - Ai có khoá API của kho sẽ truy vấn được toàn bộ tài liệu trong kho.

Giới thiệu

Màn hình & tính năng

Màn danh sách kho

Tạo kho tri thức