Quản lý Document Metadata

Thêm metadata vào documents để cho phép tìm kiếm dựa trên bộ lọc, cải thiện độ chính xác retrieval.

Mục lục

· [Metadata là gì?](#metadata-là-gì)

· [Quản lý Metadata Fields](#quản-lý-metadata-fields)

· [Chỉnh sửa Metadata](#chỉnh-sửa-metadata)

· [Lọc Documents với Metadata](#lọc-documents-với-metadata)

· [FAQ](#faq)

Metadata là gì?

Tổng quan

Metadata là thông tin mô tả bổ sung được gắn vào documents trong Knowledge Base. Metadata cho phép bạn phân loại, tổ chức và lọc tài liệu, giúp cải thiện đáng kể độ chính xác của retrieval.

Core Concepts

Khái niệm	Mô tả	Ví dụ
Field	Nhãn (label) của trường metadata	"author", "language", "category"
Value	Thông tin lưu trong trường metadata	"Nguyễn Văn A", "Vietnamese", "policy"
Value Count	Số giá trị chứa trong trường metadata (bao gồm trùng lặp)	"3"
Value Type	Kiểu dữ liệu của giá trị	String, Number, Time

ClickAI hỗ trợ 3 kiểu giá trị:

Kiểu	Mô tả	Ví dụ
String	Thông tin dạng văn bản	"Product Manual", "Vietnam"
Number	Dữ liệu số	42, 3.14
Time	Ngày/thời gian	"2024-01-15", "2024-03-20T10:30:00"

Quản lý Metadata Fields

Bắt đầu với Metadata Panel

Mỗi Knowledge Base có sẵn một số metadata fields mặc định:

Field mặc định	Kiểu	Mô tả
document_name	String	Tên tài liệu
uploader	String	Người upload
upload_date	Time	Ngày upload
last_update_date	Time	Ngày cập nhật cuối
source	String	Nguồn dữ liệu

Tạo Metadata Fields mới

1. Nhấn +Add Metadata để mở dialog New Metadata

2. Chọn Value Type (String, Number, hoặc Time)

3. Đặt tên cho field

4. Nhấn Save để áp dụng

Chỉnh sửa tên Metadata Fields

5. Nhấn biểu tượng edit bên cạnh field

6. Nhập tên mới trong trường Name

7. Nhấn Save để áp dụng

Xóa Metadata Fields

Nhấn biểu tượng delete bên cạnh field cần xóa.

🚨 WARNING: Xóa metadata field sẽ xóa field và tất cả giá trị liên quan khỏi TẤT CẢ documents trong Knowledge Base. Thao tác này không thể hoàn tác.

Chỉnh sửa Metadata

Chỉnh sửa hàng loạt trong Metadata Editor

8. Trong Knowledge Base, chọn documents bằng checkbox bên trái

9. Nhấn Metadata trong thanh action phía dưới

10. Trong Metadata Editor:

· Nhấn +Add Metadata để thêm fields có sẵn hoặc tạo mới via +New Metadata

· Fields mới tự động được thêm vào Knowledge Base

· Nhấn Manage để truy cập Metadata Panel

11. (Tùy chọn) Nhập giá trị cho fields mới

12. Nhấn Save để áp dụng

Các thao tác trong editor:

Thao tác	Cách thực hiện
Add Values	Nhập trực tiếp vào ô field
Reset Values	Nhấn blue dot xuất hiện khi hover
Delete Values	Xóa nội dung field hoặc delete Multiple Value card
Delete Fields	Nhấn biểu tượng delete (field hiển thị gạch ngang và mờ đi)

📝 NOTE: Xóa field từ editor chỉ xóa field khỏi document đó, KHÔNG xóa khỏi Knowledge Base.

Tùy chọn Apply to All:

· Unchecked (Mặc định): Chỉ cập nhật documents đã có field

· Checked: Thêm hoặc cập nhật fields cho TẤT CẢ documents đã chọn

Chỉnh sửa Metadata trên Document Details Page

13. Mở trang chi tiết document

14. Nhấn Edit ở góc trên phải

15. Nhấn +Add Metadata để thêm fields hoặc tạo mới

16. Chỉnh sửa:

· Update Values: Nhập trực tiếp vào ô giá trị

· Delete Fields: Nhấn biểu tượng delete

17. Nhấn Save để áp dụng

📝 NOTE: Trên trang chi tiết, bạn chỉ có thể sửa giá trị (value), không thể sửa tên field. Xóa field từ đây chỉ xóa khỏi document đó.

Lọc Documents với Metadata

Metadata cho phép bạn lọc documents khi retrieval, giúp thu hẹp phạm vi tìm kiếm và cải thiện độ chính xác.

Xem chi tiết về cách sử dụng metadata filtering trong ứng dụng tại: [Tích hợp Knowledge vào ứng dụng](./11-integrate-in-apps.md)

FAQ

Metadata có thể làm gì?

· Tìm thông tin nhanh hơn với smart filtering

· Kiểm soát truy cập nội dung nhạy cảm

· Tổ chức dữ liệu hiệu quả hơn

· Tự động hóa workflows dựa trên metadata rules

Fields vs Values: Khác biệt gì?

· Field là nhãn (ví dụ: "category") — định nghĩa loại thông tin

· Value là giá trị cụ thể (ví dụ: "policy") — nội dung thực tế

Các tùy chọn xóa khác nhau hoạt động như thế nào?

Hành động	Phạm vi
Xóa field từ Metadata Editor	Chỉ xóa khỏi document đang chỉnh sửa
Xóa field từ Metadata Panel	Xóa khỏi TẤT CẢ documents trong Knowledge Base
Xóa value	Chỉ xóa giá trị, field vẫn tồn tại

📖 Trước: [Documents & Chunks](./08-manage-documents-chunks.md) · Tiếp: [Knowledge Settings](./10-settings.md)