# Bài viết & Tải tài liệu

Trong mỗi [Bộ sưu tập](/vi/knowledge-base/collections/), bạn có thể bổ sung tri thức theo hai cách trực tiếp: **soạn bài viết thủ công** bằng trình soạn thảo tích hợp hoặc **tải lên tệp tài liệu** để hệ thống tự động trích xuất và lập chỉ mục vector.

:::note[Quyền truy cập]
Cần quyền **`ai:manage`** hoặc **`workspace:manage`** để thêm, chỉnh sửa hoặc xóa nguồn tri thức.
:::

## Các loại nguồn tri thức (Source Kinds)

Khi tạo hoặc quản lý bài viết trong mục **Bài viết** (`/{slug}/ai-kb/{collectionId}/articles`), mỗi nguồn mang một phân loại rõ ràng:

| Phân loại (`kind`) | Mục đích sử dụng | Chỉnh sửa trực tiếp |
|---|---|---|
| **Bài viết (`ARTICLE`)** | Hướng dẫn, quy trình, mô tả chi tiết giúp AI hiểu ngữ cảnh | Có |
| **Khớp chính xác (`EXACT_MATCH`)** | Quy tắc cố định: trả lời nguyên văn theo mẫu chuẩn, không qua suy diễn AI | Có |
| **Hỏi - Đáp nhanh (`FAQ`)** | Các cặp câu hỏi & câu trả lời ngắn gọn thường gặp | Có |
| **Chính sách (`POLICY`)** | Điều khoản đổi trả, bảo hành, vận chuyển, thanh toán | Có |
| **Sản phẩm & Dịch vụ (`PRODUCT`)** | Thông tin sản phẩm/dịch vụ (có thể tạo qua trợ lý Mina hoặc API) | Có |
| **Tài liệu tệp (`FILE_DOC`)** | Nội dung trích xuất từ tệp tải lên | Có (sau khi xử lý xong) |
| **Trang Website (`WEB_PAGE`)** | Nội dung đồng bộ từ website | Chỉ đọc (đồng bộ lại từ URL gốc) |
| **Học từ chat cũ (`EXAMPLE`)** | Mẫu câu trả lời học từ hội thoại lịch sử của shop | Chỉ đọc |

## Soạn bài viết & Quy tắc Khớp chính xác

1. Trong bộ sưu tập, nhấn nút thêm kiến thức và chọn **Viết bài viết**.
2. Chọn loại nội dung (**Bài viết**, **Khớp chính xác**, **Hỏi - Đáp nhanh** hoặc **Chính sách & Quy định**).
3. Nhập **Tiêu đề** và nội dung trong trình soạn thảo (hỗ trợ định dạng văn bản phong phú và tải ảnh minh họa trực tiếp).
4. Riêng với loại **Khớp chính xác (`EXACT_MATCH`)**, bổ sung các biến thể câu hỏi (`questionVariants`) để hệ thống nhận diện chính xác khi khách hỏi theo nhiều cách diễn đạt khác nhau.
5. Nhấn **Lưu** (hoặc phím tắt **`Ctrl+S`** / **`Cmd+S`** trên trang chi tiết bài viết). Bạn cũng có thể bật/tắt trạng thái hoạt động (`isActive`) hoặc chuyển bài viết sang bộ sưu tập khác bất kỳ lúc nào.

## Tải lên tệp tài liệu (Document Upload)

OmnyBot hỗ trợ tải lên và tự động chia đoạn (chunking) + nhúng vector (embedding) bất đồng bộ qua hàng đợi xử lý nền (`ai-document-ingest`).

### Định dạng & Giới hạn hỗ trợ

- **Định dạng tệp**: `.pdf`, `.docx`, `.txt`, `.md`, `.markdown`, `.csv`, `.json`
- **Dung lượng tối đa**: **100 MB** mỗi tệp
- **Số lượng mỗi đợt tải lên**: tối đa **10 tệp / lần**

### Quy trình tải lên

1. Trong bộ sưu tập, nhấn thêm kiến thức và chọn **Tải lên tài liệu**.
2. Kéo-thả hoặc chọn tệp từ máy tính (hệ thống tự bỏ qua các tệp sai định dạng, vượt quá 100 MB hoặc trùng lặp trong cùng đợt).
3. Nhấn tải lên để hệ thống gửi tệp lên bộ nhớ lưu trữ và đưa vào hàng đợi xử lý nền.
4. Theo dõi trạng thái đồng bộ của tài liệu:
   - **`PENDING`** → **`INDEXING`**: Đang trích xuất văn bản và tạo vector.
   - **`READY`**: Đã sẵn sàng cho Bot AI tra cứu.
   - **`FAILED`** / **`ERROR`**: Xử lý thất bại (xem chi tiết lỗi trên tài liệu).

:::tip[Tự động tách chương cho tài liệu lớn]
Với tài liệu dài trên **25.000 từ**, hệ thống tự động tách thành nhiều chương con (khoảng 15.000 từ mỗi chương) kèm mục lục ở tài liệu gốc để tăng độ chính xác khi truy xuất. Với tệp **`.csv`**, mỗi dòng được chuẩn hóa thành cặp `Tên cột: Giá trị` trước khi lập chỉ mục.
:::

:::caution[Lưu ý với tệp PDF dạng ảnh (Scan)]
Hệ thống trích xuất văn bản trực tiếp từ cấu trúc tệp PDF. Nếu tệp PDF là ảnh chụp/scan không có lớp văn bản (hoặc dưới 10 ký tự trích xuất được), quá trình lập chỉ mục sẽ báo lỗi.
:::