> ## Documentation Index > Fetch the complete documentation index at: https://docs-eos.fpt.ai/llms.txt > Use this file to discover all available pages before exploring further. # Kho tri thức > Đơn vị agent thực sự tra cứu và đơn vị được cấp quyền - Tạo, cấu hình, rà soát và kết nối kho. **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 ![Màn danh sách kho tri thức (kiểu Bảng)](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/kho-danh-sach.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=1504f8dec8dbc7596a98d49c68d0062e) Màn danh sách kho tri thức (kiểu Bảng) | 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**. ![Bước 1 – Chọn dữ liệu: tích chọn nguồn hoặc từng thư mục, tệp](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/tao-kho-b1.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=6cb77662ecfd34ec5647983c089e2d4d) Bước 1 – Chọn dữ liệu: tích chọn nguồn hoặc từng thư mục, tệp **1. 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 →**. **2. 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. **3. 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. **4. 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](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/tao-kho-b2.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=cf6a715b2bd2f92e72cbc3af4d04e6c8) 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](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/tao-kho-b3.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=23199506c38be0380eab98e84bffb6d7) 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 ![Màn chi tiết kho – tab Tài liệu](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/kho-tai-lieu.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=138d2e53e9ad63ac9deb9c14043e990d) Màn chi tiết kho – 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](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/trinh-xem-chunk.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=e65248f5084ef64e4d13817002885237) 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 ![Tab Cần rà soát – hàng chờ chia theo nguyên nhân](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/kho-can-ra-soat.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=fdcdc26aa957e41ea1c63985cf4cc263) Tab Cần rà soát – hàng chờ chia theo nguyên nhân 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 ![Tab Cấu hình của kho – pipeline, chỉ mục & truy hồi, trường metadata](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/kho-cau-hinh.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=0073a1371c38f84f7ad426398b5cc705) Tab Cấu hình của kho – pipeline, chỉ mục & truy hồi, trường metadata | 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:///api/mcp/kb/` và URL REST `.../api/v1/kb//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_`, `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 | > [!WARNING] > > **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. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.