> ## 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. # Bắt đầu nhanh > Từ tải tài liệu lên đến kết nối agent - Từng bước trên giao diện Enterprise Data Platform. Trang này đi theo đúng thứ tự bạn sẽ làm trong thực tế: Đưa tài liệu vào nguồn, gom thành kho tri thức, thử truy hồi, rồi mới giao kho cho agent. Mỗi bước đều làm được trên giao diện, không cần viết code. ## Đăng nhập và làm quen giao diện **1. Đăng nhập** Mở địa chỉ nền tảng do quản trị viên cung cấp, nhấn **Login with FPT** hoặc đăng nhập bằng email và mật khẩu. **2. Chọn workspace** Ô đầu thanh bên hiện workspace đang làm việc và vai trò của bạn (*Chủ workspace*, *Thành viên*). Nhấn vào để đổi sang workspace khác. Các nhóm chức năng chính trên thanh bên: | Nhóm | Mục | Dùng để | | - | - | - | | Nạp & xử lý | Nguồn dữ liệu | Đưa tài liệu vào nền tảng | | Tri thức | Kho tri thức | Gom tài liệu thành thứ agent tra cứu được | | Chất lượng | Thử truy hồi · Đánh giá chất lượng | Kiểm tra agent nhận được gì, đo bằng số liệu | | Quản trị | Quản trị dữ liệu · Thành viên & vai trò | Lược đồ metadata, người dùng | Màn **Tổng quan** là nơi nên nhìn mỗi sáng: Bao nhiêu nguồn đang sẵn sàng, bao nhiêu tài liệu đã lập chỉ mục, khối lượng nạp 14 ngày gần nhất, và mục **Cần chú ý** liệt kê những gì đang ảnh hưởng tới chất lượng câu trả lời - Ví dụ một tài liệu xử lý lỗi. Sơ đồ **Dòng dữ liệu** cuối trang cho thấy nguồn nào chảy vào kho nào, kho nào đang được agent gọi; bấm vào từng nút để mở màn tương ứng. ![Màn Tổng quan sau khi đăng nhập](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/tong-quan.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=597aa78c71f4d206ff3773e8578b3fc1) Màn Tổng quan sau khi đăng nhập ## Bước 1: Tạo nguồn dữ liệu Mọi tài liệu đi vào nền tảng đều qua một nguồn. Hiện tại nguồn được tạo bằng cách tải tệp và thư mục lên. ![Trình tạo nguồn – kéo thả tệp, đặt tên và chọn tuỳ chọn](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/them-nguon-b2.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=6856d0f43e8e1759e4d2adf2fd978726) Trình tạo nguồn – kéo thả tệp, đặt tên và chọn tuỳ chọn **1. Mở trình tạo nguồn** Vào **Nguồn dữ liệu** → **Thêm nguồn dữ liệu** → chọn **Tải tệp & thư mục lên** → **Tiếp tục**. **2. Kéo thả tệp hoặc cả thư mục** Bỏ thẳng thư mục tài liệu vào khung, hoặc nhấn *chọn tệp* / *chọn thư mục*. Hàng đợi bên phải hiện số tệp và dung lượng. **3. Đặt tên và chọn tuỳ chọn** Đặt **Tên nguồn** dễ nhận ra, ví dụ *Quy trình Kế toán 2026*. Hai tuỳ chọn nên bật: * **Giữ nguyên cây thư mục** - Tên thư mục trở thành metadata để lọc khi truy hồi. * **Chỉ lưu một bản của tài liệu giống nhau** - Tránh một văn bản bị trả về hai lần. **4. Tạo nguồn** Xem lại **Tóm tắt nguồn** rồi nhấn **Tạo nguồn**. Tệp bắt đầu tải lên; bạn đóng cửa sổ và làm việc khác được. > [!NOTE] > > Hai tuỳ chọn ở bước 3 được chốt lúc tạo nguồn, không đổi được về sau. ### Quản lý tệp trong nguồn Trang chi tiết nguồn có các tab: | Tab | Dùng để | | - | - | | Duyệt tệp | Xem cây thư mục, tạo thư mục, đổi tên, di chuyển, xoá; lọc *Đã nạp* / *Thiếu metadata bắt buộc*; **Sửa ngoài Excel** để sửa metadata hàng loạt | | Nhật ký tải lên | Xem từng lô đã tải, tệp nào lỗi hoặc bị bỏ qua để tải lại | | Thùng rác | Tệp đã xoá nằm đây 30 ngày, đã gỡ khỏi chỉ mục nên agent không còn thấy | | Cấu hình | Đổi tên nguồn, xem kho nào đang dùng nguồn, đặt **quy tắc metadata theo thư mục**, xoá nguồn | Menu **⋯** ở từng tệp có: **Tải xuống**, **Đổi tên**, **Di chuyển**, **Metadata**, **Xoá**. **Quy tắc metadata theo thư mục** giúp khỏi gắn tay từng tệp: Đặt cho thư mục *Hợp đồng/2026* giá trị *muc\_do\_mat = 2*, mọi tệp bỏ vào thư mục đó tự nhận. Thư mục con kế thừa quy tắc của thư mục cha; giá trị gán tay ở một tệp luôn thắng quy tắc. ## Bước 2: Tạo kho tri thức Kho tri thức là thứ agent thực sự tra cứu. Mọi việc đọc, cắt đoạn, nhúng vector diễn ra ở kho, không ở nguồn - Nên cùng một nguồn có thể dùng cho nhiều kho với cách xử lý khác nhau. ![Trình tạo kho tri thức – bước Chọn dữ liệu](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/tao-kho-b1.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=6cb77662ecfd34ec5647983c089e2d4d) Trình tạo kho tri thức – bước Chọn dữ liệu **1. Chọn dữ liệu** Vào **Kho tri thức** → **Tạo kho tri thức**. Tích chọn một hoặc nhiều nguồn; mở cây thư mục nếu chỉ muốn lấy vài thư mục hay vài tệp. Mục **Nguồn hệ thống** có sẵn kho *Văn bản pháp luật*, cập nhật tự động hằng ngày. **2. Chọn pipeline xử lý** Để mặc định **Tự động theo từng tệp** - Màn hình hiện luôn mỗi loại tệp sẽ được xử lý thế nào. **3. Đặt tên và mô tả cho agent** Viết **Mô tả cho agent** thật cụ thể - Agent đọc dòng này để quyết định khi nào gọi kho. Thêm **Người quản lý kho** nếu có người cùng phụ trách. **4. Xem lại và tạo** Kiểm tra lại rồi tạo kho. Hệ thống bắt đầu xử lý và lập chỉ mục. Pipeline **Tự động theo từng tệp** xử lý như sau: | Loại tệp | Cách xử lý | | - | - | | 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, chỉ giữ nội dung | Một mô tả kho tốt, ví dụ: > *"Quy trình kế toán nội bộ năm 2026: thanh toán, tạm ứng, hoàn ứng, chứng từ. Gọi kho này khi người dùng hỏi thủ tục, hồ sơ cần nộp hoặc thời hạn xử lý."* ### Theo dõi và tinh chỉnh kho | Tab | Dùng để | | - | - | | Tài liệu | Xem trạng thái từng tài liệu (*Đã xử lý*, *Lỗi xử lý*); **Sửa phạm vi** để đổi phần lấy từ nguồn | | Cần rà soát | Hàng chờ việc cần xử lý: tệp không nạp được, thiếu metadata bắt buộc, người dùng báo sai, xung đột với nguồn | | Cấu hình | Đổi pipeline, chọn phương pháp truy hồi, Top-K, ngưỡng điểm, bật trường metadata làm bộ lọc | | Kết nối | URL MCP / REST, tên công cụ, khoá API, ứng dụng đã cấp quyền, nhật ký gọi | Chọn phương pháp truy hồi theo kiểu câu hỏi: | Phương pháp | 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) | Câu hỏi có 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 | Ba công tắc đáng bật tuỳ loại tài liệu: **Mở rộng lên chunk cha** (tìm bằng đoạn nhỏ, trả về trọn Điều), **Chỉ trả tài liệu còn hiệu lực** và **Lọc theo metadata tự động** (suy ra phòng ban, thời gian từ câu hỏi). ## Bước 3: Thử truy hồi trước khi giao cho agent Agent trả lời sai thường không phải do mô hình, mà do nó nhận sai đoạn tài liệu. **Thử truy hồi** cho bạn thấy chính xác những gì agent sẽ nhận. ![Màn Thử truy hồi với kết quả và phần Chẩn đoán](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/thu-truy-hoi.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=79fef1778a7d30acc167d917cf9039ab) Màn Thử truy hồi với kết quả và phần Chẩn đoán **1. Chọn kho và phương pháp** Vào **Thử truy hồi**, chọn **Kho tri thức** và **Phương pháp truy vấn**. **2. Đặt bộ lọc nếu cần** Ô **Lọc metadata** nhận nhiều điều kiện cách nhau bằng dấu `;`, toán tử `=`, `!=` hoặc `~` (chứa). Ví dụ: `muc_do_mat=1;ten_tep~Luat`. **3. Hỏi bằng câu thật** Nhập câu hỏi người dùng thật sẽ hỏi, chỉnh **Top-K** và **Ngưỡng điểm tương đồng**, nhấn **Truy hồi**. **4. Đọc chẩn đoán** Xem các chunk trả về và phần **Chẩn đoán** nền tảng tự phân tích. ## Bước 4: Kết nối agent Mỗi kho có điểm kết nối riêng ở tab **Kết nối**, nên bạn cấp cho từng agent đúng kho nó cần và thu hồi độc lập. | Thông tin | Dạng | | - | - | | URL MCP | `https:///api/mcp/kb/` | | URL REST | `https:///api/v1/kb//retrieve` | | Tên công cụ MCP | Sinh từ tên kho, ví dụ `search_quy_trinh_ke_toan` | | Công cụ phơi ra | `search_…` (tìm trong kho), `get_document` (đọc toàn văn), `submit_feedback` (agent gửi đánh giá) | **OAuth (khuyến nghị)** Không cần khoá. Dán URL MCP vào client hỗ trợ MCP; lần đầu kết nối, client mở trình duyệt để bạn đăng nhập và nhấn **Cho phép**. Agent đọc kho bằng quyền của chính người đó, thu hồi được bất cứ lúc nào ở mục **Ứng dụng đã cấp quyền**. ```json theme={null} { "mcpServers": { "search_quy_trinh_ke_toan": { "type": "http", "url": "https:///api/mcp/kb/" } } } ``` **Khoá API** Nhấn **Cấp khoá mới cho kho này**, rồi gửi khoá trong header `Authorization: Bearer ` hoặc `X-API-Key: `. Bật **MCP chỉ nhận OAuth** nếu muốn buộc agent phải đăng nhập (REST vẫn dùng khoá). **REST API** ```http theme={null} POST https:///api/v1/kb//retrieve Authorization: Bearer Content-Type: application/json { "query": "hồ sơ hoàn ứng gồm những gì", "top_k": 6, "rerank": true, "include_citations": true } ``` Tab **Kết nối** có sẵn đoạn cấu hình mẫu cho Claude Code, VS Code và Cursor - Nhấn **Sao chép** là dùng được. ## Theo dõi chất lượng ![Đánh giá chất lượng – tab Chất lượng thực tế](https://mintcdn.com/fpt-15dbd015/xNO2ipDocfitQ4vu/images/edp/chat-luong-thuc-te.png?fit=max\&auto=format\&n=xNO2ipDocfitQ4vu\&q=85\&s=1c5334ed5106f158a9f25979e40cb5ee) Đánh giá chất lượng – tab Chất lượng thực tế Ở **Đánh giá chất lượng**, thêm các câu hỏi quan trọng vào **Bộ câu hỏi vàng** để kiểm tra kho định kỳ, và xem tab **Chất lượng thực tế** để biết agent đang hỏi gì mà kho chưa trả lời được. Chi tiết ở trang [Đánh giá chất lượng](https://docs-eos.fpt.ai/vi/screens/evaluation.md). ## Quản trị | Mục | Dùng để | | - | - | | Quản trị dữ liệu | Định nghĩa lược đồ metadata cho cả workspace; xuất / nhập lược đồ dạng JSON; xem lịch sử thay đổi | | Thành viên & vai trò | Mời thành viên, đổi vai trò, **Chuyển quyền quản lý** | Lược đồ metadata có hai loại trường: *Trường hệ thống* luôn có sẵn và chỉ đọc (nguồn, đường dẫn, tên tệp, định dạng, kích thước, người tải, ngày tải, số trang…), và *Trường của workspace* do bạn tạo - Ví dụ *muc\_do\_mat* (danh sách chọn), *ngay\_hieu\_luc* (ngày, bắt buộc). ## Giới hạn hiện tại | Mục | Giới hạn | | - | - | | Định dạng tệp | PDF, DOCX, XLSX, PPTX, TXT, MD, HTML | | Dung lượng | Tối đa 200 MB mỗi tệp, 2 GB mỗi lần tải | | Thùng rác | Giữ 30 ngày rồi tự xoá vĩnh viễn; không có nút dọn thủ công | | Trường metadata của workspace | Tối đa 40 trường | | Tên công cụ MCP | Bắt đầu bằng chữ thường; chỉ chữ thường, số, gạch dưới; tối đa 64 ký tự; chỉ sửa được khi kho chưa có khoá API | | Xoá nguồn | Không xoá được khi còn kho tri thức đang dùng nguồn | ## Lưu ý khi sử dụng > [!NOTE] > > **Lưu ý:** Mã trường metadata không đổi được sau khi tạo. Nhãn hiển thị đổi thoải mái, nhưng mã đi thẳng vào tham số công cụ MCP và cột CSV - Đổi mã là làm hỏng mọi tích hợp đang chạy. > [!NOTE] > > **Lưu ý:** Mô hình nhúng bị khoá sau khi tạo kho, và mọi nguồn trong cùng một kho dùng chung một mô hình. Muốn đổi mô hình thì toàn bộ chunk phải nhúng lại. > [!TIP] > > **Lưu ý:** Trước khi xoá người nghỉ việc, chuyển các nguồn và kho họ đang quản lý sang người khác. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.