KB là module P1 hiện đang trong giai đoạn thiết kế. Trang này mô tả chức năng đã được lên kế hoạch từ góc nhìn người dùng. Tham khảo lộ trình nền tảng để biết chi tiết về thời điểm GA.
Mô hình tài liệu
Mỗi tài liệu KB là một tạo phẩm có cấu trúc, không phải một trang wiki tự do.Slug
Một định danh URL duy nhất và ổn định trong mỗi tenant (ví dụ
how-to-file-leave). Slug là bất biến khi đã được thiết lập — đổi tên bằng cách tạo một tài liệu mới và chuyển hướng từ slug cũ.Nội dung markdown
Tài liệu được viết bằng markdown CommonMark + GFM. Máy chủ render HTML đã được vệ sinh mỗi lần đọc — không có mã chạy phía client, không có bề mặt XSS.
YAML frontmatter
Mỗi tài liệu mang frontmatter với
title, category, language (vi hoặc en), permission, và tùy chọn translation_of (liên kết tới tài liệu tương ứng ở ngôn ngữ kia).Category
Một trong sáu danh mục đóng:
how-to, reference, decision-log, policy, runbook, hoặc trust-center. Danh mục quyết định quy tắc lưu giữ và quyền mặc định.Đánh phiên bản
Mỗi lần lưu tạo ra một phiên bản bất biến mới. Con trỏ phiên bản hiện tại của tài liệu tiến đến phiên bản mới; các phiên bản trước không bao giờ bị sửa đổi. Các phiên bản được giữ lại trong lịch sử audit — bạn luôn có thể tái tạo chính xác nội dung tài liệu tại bất kỳ thời điểm nào.Không có “chỉnh sửa tại chỗ” trong KB. Mỗi thao tác gõ dẫn đến lưu đều tạo ra một phiên bản mới. Điều này có chủ ý: tài liệu KB được trích dẫn bởi câu trả lời AI và tham chiếu bởi PROJ Issues. Nếu nội dung có thể thay đổi âm thầm, những trích dẫn đó sẽ trở nên không đáng tin.
Tạo và chỉnh sửa tài liệu
1
Tạo tài liệu mới
Mở KB → New Document. Đặt slug, tiêu đề, category, ngôn ngữ (
vi hoặc en) và tầng quyền. Tài liệu được tạo ở trạng thái nháp — chưa thể tìm kiếm hay truy cập được bởi các thành viên khác.2
Viết bằng markdown
Sử dụng trình soạn thảo tích hợp (hoặc bất kỳ công cụ markdown nào qua REST API). Bao gồm YAML frontmatter ở đầu tệp. Tệp đính kèm (hình ảnh, PDF) được tải lên trực tiếp trong trình soạn thảo và lưu trữ an toàn.
3
Đặt quyền
Chọn một trong các tầng quyền (xem bên dưới) trước khi công bố. Bạn có thể siết chặt quyền sau này, nhưng nới lỏng chúng yêu cầu một thay đổi quyền rõ ràng được ghi lại trong lịch sử audit.
4
Lưu và công bố
Nhấp Save. CyberOS render markdown thành HTML đã vệ sinh, tạo một phiên bản bất biến, và xếp hàng công việc re-indexing. Tài liệu hoạt động và có thể tìm kiếm trong vài giây.
Các tầng quyền
Để tạo share link cho truy cập bên ngoài, mở tài liệu và nhấp Share → Create time-bound link. Đặt ngày hết hạn và tùy chọn giới hạn số lượt xem. Link tự động hết hạn và có thể thu hồi bất kỳ lúc nào từ bảng Share links của tài liệu.
Hỗ trợ song ngữ
Tài liệu trong KB mang trườnglanguage (vi hoặc en). Liên kết một tài liệu tiếng Việt với bản đối tác tiếng Anh (hoặc ngược lại) bằng cách đặt translation_of trong frontmatter hoặc dùng Document → Link translation trong trình soạn thảo. Khi một thành viên đọc tài liệu, KB phục vụ phiên bản khớp với tùy chọn locale của họ. Engine Q&A AI grounding câu trả lời trên cả hai phiên bản ngôn ngữ khi cả hai đều có sẵn.
Tìm kiếm ba lớp
Tìm kiếm KB là một pipeline tuần tự được thiết kế cho độ chính xác của tiếng Việt và chất lượng truy xuất AI.1
Bước 1 — Lexical (FTS5 / PGroonga)
Tìm kiếm toàn văn dùng FTS5 cho nội dung chữ Latin và PGroonga với tokenization bigram tiếng Việt cho tiếng Việt. Bước này trả về tối đa 100 phiên bản tài liệu ứng viên dựa trên trùng lặp từ khóa. Các truy vấn tiếng Việt như “hóa đơn cấp khi nào” được tokenize chính xác mà không cần người dùng phân tách từ thủ công.
2
Bước 2 — Semantic (embeddings BGE-M3)
Truy vấn được embed dùng BGE-M3, một mô hình embedding đa ngôn ngữ. Độ tương đồng cosine trên tập ứng viên thu hẹp kết quả xuống top 30 chunk có liên quan ngữ nghĩa nhất.
3
Bước 3 — Reranker (BGE-rerank-v2-m3)
Cross-encoder BGE-rerank-v2-m3 chấm điểm 30 chunk hàng đầu đối chiếu với truy vấn trong một lần chạy và trả về top 10 kết quả cuối. Reranker tính đến độ liên quan giữa truy vấn và tài liệu ở mức câu, không chỉ trùng lặp token.
Việc lọc quyền diễn ra trước reranker — các tài liệu bạn không được phép đọc không bao giờ đến được reranker, bộ soạn Q&A, hay kết quả tìm kiếm. Rò rỉ quyền qua tìm kiếm là bug mức nghiêm trọng 0.
Q&A AI “Ask this page”
Mỗi tài liệu có một nút Ask this page cho phép bạn đặt câu hỏi ngôn ngữ tự nhiên và nhận câu trả lời được grounding hoàn toàn trong tài liệu đó và bất kỳ tài liệu nào nó liên kết rõ ràng.1
Đặt câu hỏi
Mở một tài liệu và nhấp Ask this page, hoặc gõ câu hỏi vào bảng Q&A của tài liệu. Ví dụ: “Khi nào chúng ta phải xuất hóa đơn?”
2
KB truy xuất các span liên quan
KB embed câu hỏi của bạn bằng BGE-M3, tìm 8 span văn bản liên quan nhất trên tài liệu hiện tại và các tài liệu được liên kết, rồi chuyển chúng đến bộ soạn Q&A.
3
AI soạn câu trả lời có trích dẫn
Bộ soạn Q&A gọi AI Gateway với chỉ dẫn hệ thống yêu cầu mọi luận điểm phải trích dẫn một span ID. AI trả về câu trả lời có cấu trúc với trích dẫn nội tuyến.
4
Xác thực trích dẫn
KB xác thực rằng mọi span ID được trích dẫn đều thực sự tồn tại trong tài liệu nguồn tại vị trí được nêu. Nếu một trích dẫn không khớp — một ảo giác — KB từ chối câu trả lời và trả về “Tôi không biết” thay vì phản hồi bịa đặt.
Nạp bộ nhớ
Mỗi lần bạn lưu tài liệu, KB tự động re-index trong vòng 5 giây p95. Pipeline nạp:- Tách cú pháp markdown thành plaintext sạch
- Chunk văn bản tại các ranh giới ngữ nghĩa (mức đoạn và tiêu đề)
- Embed mỗi chunk bằng BGE-M3
- Cập nhật chỉ mục tìm kiếm với chunk và embedding mới
- Xác nhận việc nạp đã hoàn tất
Tích hợp OBS
KB lưu trữ các runbook mà router auto-runbook của OBS tham chiếu trong quá trình phân loại cảnh báo. Khi OBS nhận cảnh báo, engine phân loại của nó gọi KB để tìm runbook có tagapplicability (provider, region, severity) khớp với chữ ký của cảnh báo.
Viết runbook dưới dạng tài liệu category: runbook với khối frontmatter applicability. Sau mỗi post-mortem sự cố, công bố một runbook mới hoặc đã cập nhật — vòng lặp tăng trưởng được tích hợp sẵn: các sự cố mới trở thành runbook mới, và các runbook cũ tăng độ tin cậy khi OBS tương quan việc sử dụng chúng với kết quả phân loại thành công.
Nâng lên canonical
Promote to canonical nâng một tài liệu từ trang cơ sở tri thức thông thường thành nguồn có thẩm quyền cao được sử dụng bởi tổng hợp AI xuyên tenant của Lumi (nơisync_class cho phép).
1
Yêu cầu nâng cấp
Mở tài liệu và nhấp Promote to canonical. Nhập đường dẫn bộ nhớ canonical (ví dụ
memories/policy/leave.md). Điều này kích hoạt thông báo CHAT tới ghế CDO để phê duyệt.2
CDO phê duyệt
CDO xem xét tài liệu để xác nhận nó đại diện cho tri thức có thẩm quyền, ổn định, phù hợp cho tổng hợp xuyên tenant. Phê duyệt được ghi lại trong lịch sử audit.
3
Tạo entry canonical
KB đăng ký một entry canonical có thẩm quyền cao phản chiếu tài liệu. Các câu trả lời AI trích dẫn nó mang trọng số tin cậy cao hơn các câu trả lời trích dẫn chunk chỉ mục tìm kiếm thông thường.