> For the complete documentation index, see [llms.txt](https://docs.clickai.vn/clickai-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clickai.vn/clickai-docs/co-so-du-lieu/quan-ly-document-metadata.md). # Quản lý Document Metadata ## 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)* --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.clickai.vn/clickai-docs/co-so-du-lieu/quan-ly-document-metadata.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.