Bỏ qua, đến phần nội dung

Knowledge base ​

Knowledge base (KB) là kho tài liệu dự án trên Tara. Cả bạn lẫn agent đều tìm được trong đó, và mỗi kết quả đều kèm trích dẫn nguồn. Trang này chỉ cách tạo space, đẩy tài liệu, tìm bằng ph kb và để Claude Code tìm qua MCP. Bạn cần đăng nhập Tara.

KB gồm những gì? ​

Một space là một kho tri thức thuộc một tổ chức và, nếu muốn, một dự án. Mỗi space có mã duy nhất, ví dụ acme-shop. Tài liệu trong space là file Markdown hoặc văn bản (.md, .markdown, .mdx, .txt), tối đa 2 MiB mỗi file, và Tara cắt theo heading thành các đoạn để tìm.

Khi tìm, KB kết hợp tìm toàn văn với so khớp chính xác các mã nghiệp vụ như AC-1.2. Nếu tổ chức có cấu hình embedding thì KB còn tìm theo ngữ nghĩa. Mỗi kết quả trả về nguồn dạng repo@commit:đường-dẫn#heading.

KB không tự kéo tài liệu từ máy bạn. Phillip đọc file trên máy rồi đẩy lên, nên bạn kiểm soát chính xác tài liệu nào được chia sẻ.

Trang Knowledge trên Portal liệt kê space của tổ chức bạn và các tài liệu đã nạp, kèm ô tìm thử.

Ai đọc, ai ghi được? ​

Quyền tính theo tổ chức. Mọi Owner, Admin và Member của tổ chức sở hữu space đều đọc và tìm được. Tạo space, đẩy và xóa tài liệu cũng cần các vai trò này. Viewer chỉ dùng trình duyệt nên không dùng các lệnh này.

Tara lọc quyền trước khi xếp hạng kết quả, nên với space bạn không đọc được thì Tara trả lời như thể nó không tồn tại. Hiện chưa có quyền riêng cho từng dự án, dự án chỉ là nhãn. Vì vậy đừng đẩy tài liệu mà thành viên khác của tổ chức không được đọc.

Dùng ph kb ​

  1. Xem các space bạn đọc được. Dấu * đánh dấu space bạn ghi được:

    bash
    ph kb spaces
  2. Tạo space, việc này cần vai trò Owner, Admin hoặc Member trong tổ chức hiện tại:

    bash
    ph kb create acme-shop --name "Cửa hàng ACME" --project acme-shop
  3. Đẩy tài liệu từ thư mục trong repo. Tài liệu được khóa theo đường dẫn từ gốc repo git, nên đẩy lại thì thay version, còn nội dung giống nhau thì bỏ qua:

    bash
    ph kb push acme-shop docs/
  4. Tìm tài liệu:

    bash
    ph kb search "quy tắc khóa tài khoản sau khi nhập sai" --space acme-shop
    ph kb search "AC-1.2" --top-k 5
  5. Xóa tài liệu theo đường dẫn nguồn:

    bash
    ph kb rm acme-shop docs/cu/ke-hoach.md

Hai cờ --repo và --commit của ph kb push mặc định lấy từ git (origin, HEAD) để trích dẫn đúng. Khi cần dùng trong script, bạn thêm --json vào các lệnh spaces, create, push, search, rm. Muốn KB luôn mới, hãy chạy ph kb push trong pipeline sau mỗi lần merge.

Cho agent tìm qua MCP ​

Kit kit-knowledge trên Tara cấu hình sẵn một MCP server cho Claude Code, với ba công cụ chỉ đọc là search, get_document và list_spaces. Bạn cài vào dự án bằng:

bash
ph tara add kit-knowledge

Sau đó agent hỏi KB ngay trong phiên làm việc, dùng đúng token và quyền của bạn. Danh sách công cụ nằm ở MCP tools.

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

KB mới nhận văn bản, chưa nhận PDF. Tìm toàn văn chưa phải BM25 và chưa có bước xếp hạng lại. Tìm theo ngữ nghĩa chỉ chạy khi quản trị viên đã cấu hình embedding, còn không thì KB vẫn tìm bằng toàn văn. Chất lượng tìm tiếng Việt cũng chưa được đánh giá ở quy mô lớn, nên bạn hãy kiểm tra kết quả trước khi tin.

Đọc thêm ​