Bắt đầu nhanh

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

Đă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.

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.

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

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.

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.

Đặ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.

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.

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.

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.

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.

Đặ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.

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

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.

Đặ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.

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.

Đọ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://<domain>/api/mcp/kb/<kb-id>`
URL REST	`https://<domain>/api/v1/kb/<kb-id>/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ị)
Khoá API
REST API

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.

{
  "mcpServers": {
    "search_quy_trinh_ke_toan": {
      "type": "http",
      "url": "https://<domain>/api/mcp/kb/<kb-id>"
    }
  }
}

Nhấn Cấp khoá mới cho kho này, rồi gửi khoá trong header Authorization: Bearer <khoá> hoặc X-API-Key: <khoá>. 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á).

POST https://<domain>/api/v1/kb/<kb-id>/retrieve
Authorization: Bearer <khoá>
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ế

Ở Đá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.

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

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.

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.

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.

Giới thiệu

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

Đăng nhập và làm quen giao diện

Bước 1: Tạo nguồn dữ liệu

Quản lý tệp trong nguồn

Bước 2: Tạo kho tri thức

Theo dõi và tinh chỉnh kho

Bước 3: Thử truy hồi trước khi giao cho agent

Bước 4: Kết nối agent

Theo dõi chất lượng

Quản trị

Giới hạn hiện tại

Lưu ý khi sử dụng

​Đăng nhập và làm quen giao diện

​Bước 1: Tạo nguồn dữ liệu

​Quản lý tệp trong nguồn

​Bước 2: Tạo kho tri thức

​Theo dõi và tinh chỉnh kho

​Bước 3: Thử truy hồi trước khi giao cho agent

​Bước 4: Kết nối agent

​Theo dõi chất lượng

​Quản trị

​Giới hạn hiện tại

​Lưu ý khi sử dụng

Đăng nhập và làm quen giao diện

Bước 1: Tạo nguồn dữ liệu

Quản lý tệp trong nguồn

Bước 2: Tạo kho tri thức

Theo dõi và tinh chỉnh kho

Bước 3: Thử truy hồi trước khi giao cho agent

Bước 4: Kết nối agent

Theo dõi chất lượng

Quản trị

Giới hạn hiện tại

Lưu ý khi sử dụng