Kho tri thức & Bộ sưu tập (Collections)
Xem dạng Markdown
**Kho tri thức (Knowledge Base)** là nơi lưu trữ tập trung toàn bộ tài liệu, bài viết, tệp đính kèm và trang web để Bot AI tra cứu khi trả lời khách hàng. Dữ liệu được tổ chức theo từng **Bộ sưu tập (Collection)** độc lập để dễ phân tách theo sản phẩm, thương hiệu hoặc phòng ban.
:::note[Quyền truy cập & Gói dịch vụ]
Bạn cần có quyền **`ai:manage`** hoặc **`workspace:manage`** để truy cập trang **Kiến thức** (`/{slug}/ai-kb`) và tab **Kiến thức** trong chi tiết từng Bot (`/{slug}/ai-bots/{botId}/kb`). Khả năng AI trả lời dựa trên Kho tri thức (`aiReply`) khả dụng trên tất cả các gói dịch vụ.
:::
## Tạo bộ sưu tập (Collection)
1. Từ thanh điều hướng bên trái, mở **Xây dựng → Kiến thức** (`/{slug}/ai-kb`).
2. Nhấn **Tạo kho kiến thức** (hoặc nút thêm mới).
3. Tùy chỉnh thông tin bộ sưu tập:
- **Biểu tượng / Ảnh đại diện**: Chọn một biểu tượng emoji có sẵn hoặc tải lên ảnh tùy chỉnh (tối đa **8 MB**, tự động nén về cạnh tối đa 256px).
- **Tên kho kiến thức** *(bắt buộc)*: Nhập tên dễ phân biệt (ví dụ: *Chính sách bán hàng*, *Catalog 2026*).
- **Mô tả**: Ghi chú ngắn về phạm vi nội dung của kho.
4. Nhấn **Tạo** để hoàn tất. Mỗi bộ sưu tập mới tự động đi kèm một nguồn dữ liệu nội bộ mặc định (**Bài viết**) sẵn sàng để bạn thêm nội dung.
:::tip[Trùng tên bộ sưu tập]
Nếu bạn tạo một bộ sưu tập trùng khớp chính xác tên với bộ sưu tập đã có trong cùng Workspace, hệ thống sẽ tái sử dụng bộ sưu tập hiện có thay vì tạo bản sao trùng lặp.
:::
## Xem & Quản lý bộ sưu tập
Trên danh sách **Kiến thức**, mỗi bộ sưu tập hiển thị:
- Ảnh đại diện / biểu tượng và tên bộ sưu tập.
- Tổng số tài liệu (**bài viết / nguồn tri thức**) đang có trong kho.
- Số lượng **Bot AI** đang gắn với bộ sưu tập đó.
Nhấn vào một bộ sưu tập để mở trang chi tiết (`/{slug}/ai-kb/{collectionId}`), nơi bạn có thể xem tổng quan, chuyển nhanh sang mục [Bài viết & Tải tài liệu](/knowledge-base/articles-and-files/) hoặc [Đồng bộ Website](/knowledge-base/website-sync/).
### Chỉnh sửa & Xóa bộ sưu tập
1. Nhấn biểu tượng menu **`⋯`** ở cuối dòng bộ sưu tập.
2. Chọn **Chỉnh sửa** để đổi tên, mô tả hoặc ảnh đại diện.
3. Chọn **Xóa** nếu không còn sử dụng.
:::caution[Lưu ý khi xóa bộ sưu tập]
Xóa bộ sưu tập sẽ xóa vĩnh viễn toàn bộ nguồn tri thức và các đoạn vector (chunks) thuộc bộ sưu tập đó, đồng thời tự động gỡ liên kết khỏi tất cả Bot AI và kênh kết nối đang gắn với kho này.
:::
## Gắn bộ sưu tập cho Bot AI
Mỗi Bot AI có thể sử dụng một bộ sưu tập kiến thức làm nguồn trả lời:
1. Mở **Xây dựng → Bot của tôi**, chọn Bot cần cấu hình và chuyển sang tab **Kiến thức** (`/{slug}/ai-bots/{botId}/kb`).
2. Nếu Bot chưa có kho kiến thức, chọn **Gắn kho có sẵn** để liên kết từ thư viện Workspace hoặc **Tạo kho mới** trực tiếp tại đây.
3. Sau khi gắn, mọi bài viết, tệp tin và trang web ở trạng thái **Sẵn sàng (`READY`)** và đang bật (`isActive`) trong bộ sưu tập sẽ được Bot sử dụng khi tư vấn khách hàng.
## Kiểm tra truy xuất (Retrieval Tester)
Công cụ **Kiểm tra truy xuất tri thức** giúp bạn mô phỏng chính xác cách AI tìm tài liệu trước khi bật Bot cho khách hàng:
1. Mở hộp thoại **Kiểm tra truy xuất (Retrieval Tester)** trong khu vực Kho tri thức.
2. Chọn phạm vi kiểm tra: **Tất cả các kho** hoặc một **bộ sưu tập cụ thể**.
3. Nhập câu hỏi giả lập của khách hàng (ví dụ: *"STK chuyển khoản"*, *"Phí ship tỉnh bao nhiêu?"*) và nhấn **Thử tra cứu**.
4. Xem kết quả trả về:
- **Khớp quy tắc cố định (`EXACT_MATCH`)**: Nếu câu hỏi khớp quy tắc chính xác, hệ thống hiển thị độ tin cậy **100%** và nội dung phản hồi nguyên văn (không qua suy diễn AI).
- **Tìm kiếm lai (Hybrid Search)**: Kết hợp độ tương đồng ngữ nghĩa (**Vector BGE-M3**) và tìm kiếm từ khóa (**Trigram**), hiển thị danh sách các đoạn tài liệu khớp nhất.
Kho tri thức (Knowledge Base) là nơi lưu trữ tập trung toàn bộ tài liệu, bài viết, tệp đính kèm và trang web để Bot AI tra cứu khi trả lời khách hàng. Dữ liệu được tổ chức theo từng Bộ sưu tập (Collection) độc lập để dễ phân tách theo sản phẩm, thương hiệu hoặc phòng ban.
Tạo bộ sưu tập (Collection)
Phần tiêu đề “Tạo bộ sưu tập (Collection)”- Từ thanh điều hướng bên trái, mở Xây dựng → Kiến thức (
/{slug}/ai-kb). - Nhấn Tạo kho kiến thức (hoặc nút thêm mới).
- Tùy chỉnh thông tin bộ sưu tập:
- Biểu tượng / Ảnh đại diện: Chọn một biểu tượng emoji có sẵn hoặc tải lên ảnh tùy chỉnh (tối đa 8 MB, tự động nén về cạnh tối đa 256px).
- Tên kho kiến thức (bắt buộc): Nhập tên dễ phân biệt (ví dụ: Chính sách bán hàng, Catalog 2026).
- Mô tả: Ghi chú ngắn về phạm vi nội dung của kho.
- Nhấn Tạo để hoàn tất. Mỗi bộ sưu tập mới tự động đi kèm một nguồn dữ liệu nội bộ mặc định (Bài viết) sẵn sàng để bạn thêm nội dung.
Xem & Quản lý bộ sưu tập
Phần tiêu đề “Xem & Quản lý bộ sưu tập”Trên danh sách Kiến thức, mỗi bộ sưu tập hiển thị:
- Ảnh đại diện / biểu tượng và tên bộ sưu tập.
- Tổng số tài liệu (bài viết / nguồn tri thức) đang có trong kho.
- Số lượng Bot AI đang gắn với bộ sưu tập đó.
Nhấn vào một bộ sưu tập để mở trang chi tiết (/{slug}/ai-kb/{collectionId}), nơi bạn có thể xem tổng quan, chuyển nhanh sang mục Bài viết & Tải tài liệu hoặc Đồng bộ Website.
Chỉnh sửa & Xóa bộ sưu tập
Phần tiêu đề “Chỉnh sửa & Xóa bộ sưu tập”- Nhấn biểu tượng menu
⋯ở cuối dòng bộ sưu tập. - Chọn Chỉnh sửa để đổi tên, mô tả hoặc ảnh đại diện.
- Chọn Xóa nếu không còn sử dụng.
Gắn bộ sưu tập cho Bot AI
Phần tiêu đề “Gắn bộ sưu tập cho Bot AI”Mỗi Bot AI có thể sử dụng một bộ sưu tập kiến thức làm nguồn trả lời:
- Mở Xây dựng → Bot của tôi, chọn Bot cần cấu hình và chuyển sang tab Kiến thức (
/{slug}/ai-bots/{botId}/kb). - Nếu Bot chưa có kho kiến thức, chọn Gắn kho có sẵn để liên kết từ thư viện Workspace hoặc Tạo kho mới trực tiếp tại đây.
- Sau khi gắn, mọi bài viết, tệp tin và trang web ở trạng thái Sẵn sàng (
READY) và đang bật (isActive) trong bộ sưu tập sẽ được Bot sử dụng khi tư vấn khách hàng.
Kiểm tra truy xuất (Retrieval Tester)
Phần tiêu đề “Kiểm tra truy xuất (Retrieval Tester)”Công cụ Kiểm tra truy xuất tri thức giúp bạn mô phỏng chính xác cách AI tìm tài liệu trước khi bật Bot cho khách hàng:
- Mở hộp thoại Kiểm tra truy xuất (Retrieval Tester) trong khu vực Kho tri thức.
- Chọn phạm vi kiểm tra: Tất cả các kho hoặc một bộ sưu tập cụ thể.
- Nhập câu hỏi giả lập của khách hàng (ví dụ: “STK chuyển khoản”, “Phí ship tỉnh bao nhiêu?”) và nhấn Thử tra cứu.
- Xem kết quả trả về:
- Khớp quy tắc cố định (
EXACT_MATCH): Nếu câu hỏi khớp quy tắc chính xác, hệ thống hiển thị độ tin cậy 100% và nội dung phản hồi nguyên văn (không qua suy diễn AI). - Tìm kiếm lai (Hybrid Search): Kết hợp độ tương đồng ngữ nghĩa (Vector BGE-M3) và tìm kiếm từ khóa (Trigram), hiển thị danh sách các đoạn tài liệu khớp nhất.
- Khớp quy tắc cố định (