> ## Documentation Index
> Fetch the complete documentation index at: https://docs-agents.fpt.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Kho tri thức

> Tạo kho tri thức dùng chung cho cả Space rồi liên kết vào các Agent cần tra cứu

Kho tri thức là nơi bạn tải tài liệu lên một lần rồi cho nhiều Agent cùng tra cứu. Thay vì tải lại cùng một bộ tài liệu cho từng Agent, bạn tạo kho ở cấp Space và liên kết kho đó vào những Agent cần dùng.

<Info>
  Có hai loại kho tri thức. **Kho của Space** nằm ở menu trái, mục Tri thức, dùng chung cho nhiều Agent. **Kho riêng của Agent** tạo ngay trong màn hình Instructions của Agent, chỉ Agent đó dùng. Một Agent có thể vừa có kho riêng vừa liên kết thêm kho của Space.
</Info>

## Mở màn hình Kho tri thức

Trong menu trái của Console, nhóm **Xây dựng**, chọn **Tri thức**. Danh sách hiện mọi kho bạn được phép xem, chia theo bốn tab: **Tất cả**, **Của tôi**, **Được chia sẻ** và **Hệ thống**. Ô tìm kiếm bên phải lọc theo tên kho.

<img src="https://mintcdn.com/fpt-62e894b4/3GSOlOFgSDBeGN3I/images/kb_list.jpg?fit=max&auto=format&n=3GSOlOFgSDBeGN3I&q=85&s=e87ae2ac140c014974b1edf0d9bf5677" alt="Danh sách kho tri thức của Space" width="1470" height="738" data-path="images/kb_list.jpg" />

## Tạo kho tri thức

<Steps>
  <Step title="Bấm Thêm kho tri thức">
    Nút nằm ở góc phải trên. Menu có hai lựa chọn: **Tạo kho tri thức** để tải tài liệu của bạn lên, và **Kết nối kho tri thức ngoài** đang ở trạng thái Sắp có.
  </Step>

  <Step title="Điền tên và mô tả">
    Tên tối đa 50 ký tự và là trường bắt buộc. Mô tả tối đa 256 ký tự, nên viết rõ kho chứa gì để người khác biết có nên dùng lại hay không.

    <img src="https://mintcdn.com/fpt-62e894b4/3GSOlOFgSDBeGN3I/images/kb_create.jpg?fit=max&auto=format&n=3GSOlOFgSDBeGN3I&q=85&s=09dfc40ca930f74782efef049956bb14" alt="Form tạo kho tri thức" width="1470" height="738" data-path="images/kb_create.jpg" />
  </Step>

  <Step title="Chọn quyền truy cập và quyền truy xuất">
    Hai nhóm quyền này quyết định ai được gắn kho vào Agent và ai nhận được câu trả lời từ kho. Chi tiết ở trang [Phân quyền kho tri thức](/knowledge-permissions).
  </Step>

  <Step title="Bấm Tạo">
    Kho mới xuất hiện trong danh sách, ở trạng thái rỗng và sẵn sàng nhận tài liệu.
  </Step>
</Steps>

### Các trường trong form

| Trường | Bắt buộc | Ý nghĩa |
| - | - | - |
| **Tên kho tri thức** | Có | Tên hiển thị trong danh sách và trong hộp thoại liên kết vào Agent. Tối đa 50 ký tự |
| **Mô tả** | Không | Tóm tắt nội dung kho. Tối đa 256 ký tự |
| **Quyền truy cập** | Có | Ai được liên kết kho này vào Agent khi xây dựng |
| **Quyền truy xuất** | Có | Ai nhận được câu trả lời từ kho này khi trò chuyện với Agent |

## Màn hình chi tiết kho

Bấm vào thẻ kho để mở màn hình chi tiết. Đầu trang hiện tên kho, mô tả và ba nhãn tóm tắt: ai sở hữu, quyền truy cập và quyền truy xuất đang đặt ở mức nào.

<img src="https://mintcdn.com/fpt-62e894b4/3GSOlOFgSDBeGN3I/images/kb_detail.jpg?fit=max&auto=format&n=3GSOlOFgSDBeGN3I&q=85&s=c2971f33388ac21fbd34fd29eb0100a8" alt="Màn hình chi tiết kho tri thức" width="1470" height="738" data-path="images/kb_detail.jpg" />

Kho có bốn tab nguồn dữ liệu. Hiện chỉ **Tài liệu** hoạt động; **Website**, **Câu hỏi thường gặp** và **SharePoint** đang ở trạng thái Sắp có.

Bảng tài liệu gồm các cột:

| Cột | Ý nghĩa |
| - | - |
| **Tên** | Tên tệp hoặc tên thư mục |
| **Trạng thái** | Tiến trình xử lý của tệp |
| **Kích thước** | Dung lượng tệp |
| **Phiên bản** | Số phiên bản của tệp, bắt đầu từ 1.0.0 |
| **Cập nhật lần cuối** | Thời điểm thay đổi gần nhất |
| **Cập nhật bởi** | Người thực hiện thay đổi |

Phía trên bảng có ô **Tìm tài liệu** và bộ lọc **Trạng thái** để lọc nhanh những tệp đang chờ hoặc bị lỗi.

## Tải tài liệu lên

<Steps>
  <Step title="Bấm Tạo rồi chọn Tải tài liệu lên">
    Nút **Tạo** ở góc phải trên có hai lựa chọn: **Tải tài liệu lên** và **Tạo thư mục**.
  </Step>

  <Step title="Kéo thả hoặc bấm để chọn tệp">
    Hộp thoại nhận các định dạng TXT, MD, PDF, DOC, DOCX, PPT, PPTX, XLS và XLSX.

    <img src="https://mintcdn.com/fpt-62e894b4/3GSOlOFgSDBeGN3I/images/kb_upload.jpg?fit=max&auto=format&n=3GSOlOFgSDBeGN3I&q=85&s=58ea3296e0963483c839af9101348a8d" alt="Hộp thoại tải tài liệu lên" width="1470" height="738" data-path="images/kb_upload.jpg" />
  </Step>

  <Step title="Chọn thư mục đích">
    Mặc định là **Danh sách tài liệu chung**. Nếu kho đã có thư mục, bạn chọn thư mục muốn đưa tệp vào ngay từ bước này.
  </Step>

  <Step title="Bấm Lưu & Xử lý">
    Console nhận tệp rồi bắt đầu xử lý nền. Bạn không cần chờ ở lại màn hình.
  </Step>
</Steps>

<Note>
  Giới hạn mỗi lần tải: tối đa 10 tệp, mỗi tệp tối đa 30MB.
</Note>

## Trạng thái xử lý của tệp

Mỗi tệp đi qua chuỗi trạng thái sau, hiển thị ở cột **Trạng thái**:

| Trạng thái | Nghĩa là gì |
| - | - |
| **Đang chờ xử lý** | Tệp đã lên hệ thống, đang xếp hàng chờ tới lượt |
| **Đang xử lý** | Hệ thống đang bóc tách nội dung và lập chỉ mục |
| **Hoàn thành** | Agent đã tra cứu được nội dung tệp này |
| **Thất bại** | Không bóc tách được nội dung, ví dụ PDF chỉ có ảnh quét hoặc tệp hỏng |

<Tip>
  Agent chỉ trả lời được từ những tệp ở trạng thái **Hoàn thành**. Nếu Agent nói không tìm thấy thông tin, hãy mở kho và lọc theo trạng thái để xem còn tệp nào đang xử lý hoặc thất bại không.
</Tip>

## Sắp xếp bằng thư mục

Bấm **Tạo** rồi chọn **Tạo thư mục**, đặt tên và bấm **Tạo mới**. Thư mục mới luôn nằm ở cấp ngoài cùng của kho.

Thư mục giúp chia tài liệu theo chủ đề hoặc theo kỳ, ví dụ Bảng giá, Hợp đồng mẫu, Báo cáo 2026. Cột Trạng thái, Kích thước và Phiên bản của dòng thư mục để trống vì thư mục không phải tệp.

## Sửa, di chuyển và xóa

Menu ⋯ ở cuối mỗi dòng tệp có các thao tác:

| Thao tác | Dùng khi nào |
| - | - |
| **Mở** | Xem lại nội dung tệp đã tải lên |
| **Đổi tên** | Đặt lại tên hiển thị, không ảnh hưởng nội dung đã lập chỉ mục |
| **Di chuyển** | Chuyển tệp sang thư mục khác trong cùng kho |
| **Xóa** | Gỡ tệp khỏi kho, Agent không tra cứu được nữa |

Để xử lý nhiều tệp cùng lúc, tích ô chọn ở đầu mỗi dòng. Thanh thao tác hiện lên với bộ đếm **Đã chọn N** và nút **Xóa**. Bấm **Bỏ chọn** để thoát.

<Warning>
  Xóa tệp là xóa hẳn khỏi kho. Mọi Agent đang liên kết kho này đều mất nội dung đó ngay, không cần publish lại.
</Warning>

## Gắn kho tri thức vào Agent

Kho chỉ phát huy tác dụng khi được gắn vào Agent. Thao tác này nằm trong màn hình **Instructions** của Agent, cột **Cấu hình** bên phải, nhóm **Tri thức**.

<img src="https://mintcdn.com/fpt-62e894b4/3GSOlOFgSDBeGN3I/images/kb_agent_panel.jpg?fit=max&auto=format&n=3GSOlOFgSDBeGN3I&q=85&s=872c1922af853f5b00845016231c3614" alt="Nhóm Tri thức trong cột Cấu hình của Agent" width="760" height="550" data-path="images/kb_agent_panel.jpg" />

Bấm dấu **+** ở nhóm Tri thức, menu hiện hai lựa chọn:

* **Liên kết kho tri thức có sẵn**: Dùng chung một kho đã có với Agent khác.
* **Tạo mới**: Tạo kho riêng cho Agent này.

### Liên kết kho của Space

<Steps>
  <Step title="Chọn Liên kết kho tri thức có sẵn">
    Hộp thoại liệt kê những kho trong Space mà bạn có quyền truy cập, kèm tên chủ kho và số lượng tài liệu.
  </Step>

  <Step title="Tích chọn các kho cần dùng">
    Bộ đếm **Đã chọn N kho** cập nhật theo. Ô tìm kiếm phía trên giúp lọc khi Space có nhiều kho.
  </Step>

  <Step title="Bấm Liên kết">
    Kho xuất hiện trong nhóm Tri thức của Agent, kèm nhãn cho biết kho là của bạn hay được chia sẻ.
  </Step>
</Steps>

### Tạo kho riêng cho Agent

Chọn **Tạo mới** nếu tài liệu chỉ phục vụ đúng Agent đang dựng. Form giống hệt form tạo kho ở cấp Space, và kho tạo theo cách này vẫn xuất hiện trong danh sách Tri thức của Space nếu bạn đặt quyền truy cập ở mức Cả Space.

### Quản lý kho đã liên kết

Menu ⋯ cạnh mỗi kho trong nhóm Tri thức của Agent có ba thao tác:

| Thao tác | Kết quả |
| - | - |
| **Xem chi tiết** | Mở màn hình chi tiết kho để xem và sửa tài liệu |
| **Đổi tên** | Đổi tên kho |
| **Gỡ liên kết** | Agent này thôi dùng kho. Kho vẫn còn trong Space và các Agent khác không bị ảnh hưởng |

<Note>
  Gỡ liên kết khác với xóa kho. Gỡ liên kết chỉ cắt quan hệ giữa một Agent và kho; xóa kho ở màn hình Tri thức mới là bỏ hẳn kho khỏi Space.
</Note>

<Note>
  Kho tri thức là tài nguyên của Space, không nằm trong phiên bản của Agent. Thêm hay xóa tài liệu trong kho có hiệu lực ngay với cả Agent đã publish. Riêng việc gắn hoặc gỡ kho khỏi Agent là một thay đổi cấu hình của Agent, nên vẫn cần [publish](/publishing) để áp dụng ra ngoài kênh triển khai.
</Note>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.