From 055b40f2ca6ec5b2abc3b9e72f1eaae522017d6f Mon Sep 17 00:00:00 2001
From: "Jing Y." <106428961+saltism@users.noreply.github.com>
Date: Mon, 17 Mar 2025 17:11:26 +0800
Subject: [PATCH 1/4] Update metadata.mdx
---
zh-cn/user-guide/knowledge-base/metadata.mdx | 312 +++++++++++--------
1 file changed, 176 insertions(+), 136 deletions(-)
diff --git a/zh-cn/user-guide/knowledge-base/metadata.mdx b/zh-cn/user-guide/knowledge-base/metadata.mdx
index df2066ec..e9fdf7b2 100644
--- a/zh-cn/user-guide/knowledge-base/metadata.mdx
+++ b/zh-cn/user-guide/knowledge-base/metadata.mdx
@@ -6,43 +6,34 @@ title: 元数据
### 定义
-元数据是用于描述其他数据的信息。简单来说,它是"关于数据的数据"。它就像一本书的目录或标签,可以为你介绍数据的内容、来源和用途。
+元数据是用于描述其他数据的信息。简单来说,它是“关于数据的数据”。它就像一本书的目录或标签,可以为你介绍数据的内容、来源和用途。
通过提供数据的上下文,元数据能帮助你在知识库内快速查找和管理数据。
### 知识库元数据定义
-- **字段(Field)**:元数据字段是用于描述文档特定属性的标识项,每个字段代表文档的某个特征或信息。例如"author""language"等。
+- **字段(Field)**:元数据字段是用于描述文档特定属性的标识项,每个字段代表文档的某个特征或信息。例如“author”“language”等。
-- **字段值(Value)**:字段值是该字段的具体信息或属性,例如"Jack""English"。
+- **字段值(Value)**:字段值是该字段的具体信息或属性,例如“Jack”“English”。
-
+
+
+
+
+
+
+
+
| + | 内置元数据(Built-in) | +自定义元数据 | +
|---|---|---|
| 显示位置 | +知识库界面 元数据 栏的下半部分。 | +知识库界面 元数据 栏的上半部分。 | +
| 启用方式 | +默认禁用,需要手动开启才能生效。 | +由用户根据需求自由添加。 | +
| 生成方式 | +启用后,由系统自动提取相关信息并生成字段值。 | +用户手动添加,完全由用户自定义。 | +
| 修改权限 | +一旦生成,无法修改字段与字段值。 | +可以删除或编辑字段名称,也可以修改字段值。 | +
| 应用范围 | +启用后,适用于已上传和新上传的所有文档。 | +添加元数据字段后,字段会储存在知识库的元数据列表中/需要手动设置,才能将该字段应用于具体文档。 | +
| 字段 | +
+ 由系统预定义,包括: + • document_name (string):文件名 + • uploader (string):上传者 + • upload_date (time):上传日期 + • last_update_date (time):最后更新时间 + • source (string):文件来源 + |
+ 在初始状态下,知识库无自定义元数据字段,需要用户手动添加。 | +
| 字段值类型 | +
+ • 字符串 (string):文本值 + • 数字 (number):数值 + • 时间 (time):日期和时间 + |
+
+ • 字符串 (string):文本值 + • 数字 (number):数值 + • 时间 (time):日期和时间 + |
+
+
+
+
+
+
+
+
+ - 可以从下拉列表中选择已有的字段,添加到字段列表中。
+
+ - 可以在 **搜索元数据** 搜索框中搜索你需要的字段,添加到该文档的字段列表中。
+
+ 
-
+ 
+ 
+
+
+ 
+ 
+ 
+
| / | +定义 | +性质 | +举例 | +
|---|---|---|---|
| 元数据管理列表中的元数据字段 | +预定义的字段,用于描述文档的某些属性。 | +全局性字段。所有文档都可以使用这些字段。 | +作者、文档类型、上传日期。 | +
| 某篇文档中的元数据值 | +每个文档按需标记的针对特定文档的信息。 | +文档特定的值。每个文档根据其内容会标记不同的元数据值。 | +文档 A 的“作者”字段值为“张三”,文档 B 的“作者”字段值为“李四”。 | +
| 操作方式 | +操作方法 | +影响范围 | +结果 | +
|---|---|---|---|
| 在知识库管理界面删除某条元数据字段 | +在知识库管理界面,点击某条元数据字段右侧的删除图标,删除该字段。 | +从知识库管理列表中完全删除该元数据字段及其所有字段值。 | +该字段从知识库中移除,所有文档中的该字段及包含的所有字段值也会消失。 | +
| 在编辑元数据弹窗中删除已选文档的某条元数据字段 | +在编辑元数据弹窗中,点击某条元数据字段右侧的删除图标,删除该字段。 | +仅删除已选文档的该字段与字段值,字段本身依然保留在知识库管理列表中。 | +选中文档中的字段与字段值被移除,但字段仍保留在知识库内,字段值计数会发生数值上的变化。 | +
| 在文档详情界面删除某条元数据字段 | +在文档详情界面中的元数据编辑模式里,点击某条元数据字段右侧的删除图标,删除该字段。 | +仅删除该文档的该字段与字段值,字段本身依然保留在知识库管理列表中。 | +该文档中的字段与字段值被移除,但字段仍保留在知识库内,字段值计数会发生数值上的变化。 | +
+
+
+
+
+
+
+
+
| Feature | +Built-in Metadata | +Custom Metadata | +
|---|---|---|
| Location | +Lower section of the Metadata panel | +Upper section of the Metadata panel | +
| Activation | +Disabled by default; requires manual activation | +Add as needed | +
| Generation | +System automatically extracts and generates field values | +User-defined and manually added | +
| Editing | +Fields and values cannot be modified once generated | +Fields and values can be edited or deleted | +
| Scope | +Applies to all existing and new documents when enabled | +Stored in metadata list; requires manual assignment to documents | +
| Fields | +
+ System-defined fields include: + • document_name (string) + • uploader (string) + • upload_date (time) + • last_update_date (time) + • source (string) + |
+ No default fields; all fields must be manually created | +
| Value Types | +
+ • String: For text values + • Number: For numerical values + • Time: For dates and timestamps + |
+
+ • String: For text values + • Number: For numerical values + • Time: For dates and timestamps + |
+
+
+
+
+
+
+
+
+ 
+ 
+ 


+ 
+ 
+ 
+
| Concept | +Definition | +Characteristics | +Examples | +
|---|---|---|---|
| Metadata Fields in the Metadata Panel | +System-defined attributes that describe document properties | +Global fields accessible across all documents in the knowledge base | +Author, Type, Date, etc. | +
| Metadata Value on a document’s detail page | +Custom metadata tagged according to individual document requirements | +Unique metadata values assigned based on document content and context | +The “Author” field in Document A is set to “Mary” value, while in Document B it is set to “John” value. | +
| Action | +Steps | +Impact | +Outcome | +
|---|---|---|---|
| Delete field in the Metadata Panel | +In the Metadata Panel, click delete icon next to field | +Global - affects all documents | +Field and all values permanently deleted from the knowledge base | +
| Delete field in the Metadata Editor | +In the Metadata Editor, click delete icon next to field | +Selected documents only | +Field deleted from selected documents; remains in the knowledge base | +
| Delete field on the document detail page | +In the Edit Mode, click delete icon next to field | +Current document only | +Field deleted from current document; remains in the knowledge base | +
Configuring the Knowledge Base Retrieval Node involves four main steps:
@@ -19,7 +22,7 @@ In knowledge base retrieval scenarios, the query variable typically represents t
**Choosing the Knowledge Base for Query**
-Within the knowledge base retrieval node, you can add an existing knowledge base from Dify. For instructions on creating a knowledge base within Dify, please refer to the knowledge base [documentation](/en-us/user-guide/knowledge-base/knowledge-base-creation/introduction).
+Within the knowledge base retrieval node, you can add an existing knowledge base from Dify. For instructions on creating a knowledge base within Dify, please refer to the knowledge base [help documentation](https://docs.dify.ai/guides/knowledge-base/create-knowledge-and-upload-documents).
**Applying Metadata Filtering**
@@ -27,10 +30,16 @@ Use **Metadata Filtering** to refine document search in your knowledge base. For
**Configuring the Retrieval Strategy**
-It's possible to modify the indexing strategy and retrieval mode for an individual knowledge base within the node. For a detailed explanation of these settings, refer to the knowledge base [documentation](/en-us/user-guide/knowledge-base/knowledge-base-creation/introduction).
+It's possible to modify the indexing strategy and retrieval mode for an individual knowledge base within the node. For a detailed explanation of these settings, refer to the knowledge base [help documentation](https://docs.dify.ai/guides/knowledge-base/retrieval-test-and-citation).
-
+
Dify offers two recall strategies for different knowledge base retrieval scenarios: "N-to-1 Recall" and "Multi-way Recall". In the N-to-1 mode, knowledge base queries are executed through function calling, requiring the selection of a system reasoning model. In the multi-way recall mode, a Rerank model needs to be configured for result re-ranking. For a detailed explanation of these two recall strategies, refer to the retrieval mode explanation in the [help documentation](https://docs.dify.ai/guides/knowledge-base/create-knowledge-and-upload-documents#id-5-indexing-methods).
-
+
diff --git a/en-us/user-guide/knowledge-base/integrate-knowledge-within-application.mdx b/en-us/user-guide/knowledge-base/integrate-knowledge-within-application.mdx
index 868ea76d..e5f3eb5d 100644
--- a/en-us/user-guide/knowledge-base/integrate-knowledge-within-application.mdx
+++ b/en-us/user-guide/knowledge-base/integrate-knowledge-within-application.mdx
@@ -79,36 +79,36 @@ The **Knowledge Retrieval** node allows you to filter documents using metadata f
#### Steps
1. Select Filter Mode:
- - **Disabled (Default):** No metadata filtering.
+ - **Disabled (Default):** No metadata filtering.
- - **Automatic:** Filters auto-configure from query variables in the **Knowledge Retrieval** node.
+ - **Automatic:** Filters auto-configure from query variables in the **Knowledge Retrieval** node.
- > Note: Automatic Mode requires model selection for document retrieval.
+ > Note: Automatic Mode requires model selection for document retrieval.
- 
+ 
- - **Manual:** Configure filters manually.
+ - **Manual:** Configure filters manually.

2. For Manual Mode, follow these steps:
- 1. Click **Conditions** to open the configuration panel.
+ 1. Click **Conditions** to open the configuration panel.
- 
+ 
- 2. Click **+Add Condition**:
- - Select metadata fields within your chosen knowledge base from the dropdown list.
- > Note: When multiple knowledge bases are selected, only common metadata fields are shown in the list.
- - Use the search box to find specific fields.
+ 2. Click **+Add Condition**:
+ - Select metadata fields within your chosen knowledge base from the dropdown list.
+ > Note: When multiple knowledge bases are selected, only common metadata fields are shown in the list.
+ - Use the search box to find specific fields.
- 
+ 
- 3. Click **+Add Condition** to add more fields.
+ 3. Click **+Add Condition** to add more fields.
- 
+ 
- 4. Configure filter conditions:
+ 4. Configure filter conditions:
| Field Type | Operator | Description and Examples |
| --- | --- | --- |
@@ -136,23 +136,23 @@ The **Knowledge Retrieval** node allows you to filter documents using metadata f
5. Add filter values:
- - **Variable:** Select from existing **Chatflow/Workflow** variables.
+ - **Variable:** Select from existing **Chatflow/Workflow** variables.
- 
+ 
- - **Constant:** Enter specific values.
+ - **Constant:** Enter specific values.
- > Time-type fields can only be filtered by constants The date picker is for time-type fields.
+ > Time-type fields can only be filtered by constants The date picker is for time-type fields.
- 
+ 
-
### Frequently Asked Questions
-1. **How should I choose Rerank settings in multi-recall mode?**
+11. **How should I choose Rerank settings in multi-recall mode?**
-If users know the exact information or terminology, you can use keyword search for precise matching. In that case, set **“Keywords” to 1** under Weight Settings.
+If users know the exact information or terminology, you can use keyword search for precise matching. In that case, set **"Keywords" to 1** under Weight Settings.
-If the knowledge base doesn’t contain the exact terms or if a cross-lingual query is involved, we recommend setting **“Semantic” to 1** under Weight Settings.
+If the knowledge base doesn't contain the exact terms or if a cross-lingual query is involved, we recommend setting **"Semantic" to 1** under Weight Settings.
If you are familiar with real user queries and want to adjust the ratio of semantics to keywords, they can manually tweak the ratio under **Weight Settings**.
If the knowledge base is complex, making simple semantic or keyword matches insufficient—and you need highly accurate answers and are willing to pay more—consider using a **Rerank Model** for content retrieval.
-2. **What should I do if I encounter issues finding the “Weight Score” or the requirement to configure a Rerank model?**
+2. **What should I do if I encounter issues finding the "Weight Score" or the requirement to configure a Rerank model?**
Here's how the knowledge base retrieval method affects Multi-path Retrieval:

-3. **What should I do if I cannot adjust the “Weight Score” when referencing multiple knowledge bases and an error message appears?**
+3. **What should I do if I cannot adjust the "Weight Score" when referencing multiple knowledge bases and an error message appears?**
This issue occurs because the embedding models used in the multiple referenced knowledge bases are inconsistent, prompting this notification to avoid conflicts in retrieval content. It is advisable to set and enable the Rerank model in the "Model Provider" or unify the retrieval settings of the knowledge bases.
-4. **Why can't I find the “Weight Score” option in multi-recall mode, and only see the Rerank model?**
+4. **Why can't I find the "Weight Score" option in multi-recall mode, and only see the Rerank model?**
-Please check whether your knowledge base is using the “Economical” index mode. If so, switch it to the “High Quality” index mode.
+Please check whether your knowledge base is using the "Economical" index mode. If so, switch it to the "High Quality" index mode.
\ No newline at end of file
diff --git a/en-us/user-guide/knowledge-base/metadata.mdx b/en-us/user-guide/knowledge-base/metadata.mdx
index 4d2424bf..519e41a0 100644
--- a/en-us/user-guide/knowledge-base/metadata.mdx
+++ b/en-us/user-guide/knowledge-base/metadata.mdx
@@ -6,35 +6,42 @@ title: Metadata
### Overview
-Metadata is information that describes your data - essentially “data about data”. Just as a book has a table of contents to help you understand its structure, metadata provides context about your data’s content, origin, purpose, etc., making it easier for you to find and manage information in your knowledge base.
+Metadata is information that describes your data - essentially "data about data". Just as a book has a table of contents to help you understand its structure, metadata provides context about your data's content, origin, purpose, etc., making it easier for you to find and manage information in your knowledge base.
This guide aims to help you understand metadata and effectively manage your knowledge base.
### Core Concepts
-- **Field:** The label of a metadata field (e.g., “author”, “language”).
+- **Field:** The label of a metadata field (e.g., "author", "language").
-- **Value:** The information stored in a metadata field (e.g., “Jack”, “English”).
+- **Value:** The information stored in a metadata field (e.g., "Jack", "English").
-
-
-
-- **Value Count:** The number of values contained in a metadata field,including duplicates. (e.g., “3”).
+- **Value Count:** The number of values contained in a metadata field,including duplicates. (e.g., "3").
-
-
-
-
-
## How to Manage My Metadata?
@@ -46,7 +53,7 @@ You can create, modify, and delete metadata fields in the knowledge base.
#### Get Started with the Metadata Panel
-##### Access the Metadata Panel
+**Access the Metadata Panel**
To access the Metadata Panel, go to **Knowledge Base** page and click **Metadata**.
@@ -54,64 +61,74 @@ To access the Metadata Panel, go to **Knowledge Base** page and click **Metadata

-##### Built-in vs Custom Metadata
+**Built-in vs Custom Metadata**
-| Feature | -Built-in Metadata | -Custom Metadata | +Feature | +Built-in Metadata | +Custom Metadata | +
|---|---|---|---|---|---|
| Location | +Lower section of the Metadata panel | +Upper section of the Metadata panel | |||
| Location | -Lower section of the Metadata panel | -Upper section of the Metadata panel | +Activation | +Disabled by default; requires manual activation | +Add as needed |
| Activation | -Disabled by default; requires manual activation | -Add as needed | +Generation | +System automatically extracts and generates field values | +User-defined and manually added |
| Generation | -System automatically extracts and generates field values | -User-defined and manually added | +Editing | +Fields and values cannot be modified once generated | +Fields and values can be edited or deleted |
| Editing | -Fields and values cannot be modified once generated | -Fields and values can be edited or deleted | +Scope | +Applies to all existing and new documents when enabled | +Stored in metadata list; requires manual assignment to documents |
| Scope | -Applies to all existing and new documents when enabled | -Stored in metadata list; requires manual assignment to documents | +Fields | +
+ System-defined fields include:
+
|
+ No default fields; all fields must be manually created |
| Fields | -
- System-defined fields include: - • document_name (string) - • uploader (string) - • upload_date (time) - • last_update_date (time) - • source (string) - |
- No default fields; all fields must be manually created | -|||
| Value Types | -
- • String: For text values - • Number: For numerical values - • Time: For dates and timestamps - |
-
- • String: For text values - • Number: For numerical values - • Time: For dates and timestamps - |
+ Value Types | +
+
|
+
+
|
-
-
4. Click **Save** to apply changes.
@@ -148,9 +167,11 @@ To edit a metadata field:
> Note: You can only modify the field name, not the value type.
-
-
-
3. Click **Save** to apply changes.
@@ -172,7 +193,7 @@ To delete a metadata field, click the delete icon next to a field to delete it.
You can edit metadata in bulk in the knowledge base.
-##### Access the Metadata Editor
+**Access the Metadata Editor**
To access the Metadata Editor:
@@ -184,39 +205,63 @@ To access the Metadata Editor:

-##### Bulk Add Metadata
+**Bulk Add Metadata**
To add metadata in bulk:
1. Click **+Add Metadata** in the editor to:
-
- Add existing fields from the dropdown or from the search box.
- 
- Create new fields via **+New Metadata**.
-
- > New fields are automatically added to the knowledge base.
+
+ > New fields are automatically added to the knowledge base.
- 
- Access the Metadata Panel to manage metadata fields via **Manage**.
- 
2. *(Optional)* Enter values for new fields.
-
> The date picker is for time-type fields.
-
3. Click **Save** to apply changes.
-##### Bulk Update Metadata
+**Bulk Update Metadata**
To update metadata in bulk:
@@ -226,37 +271,53 @@ To update metadata in bulk:
- **Reset Values:** Click the blue dot that appears on hover.
- 
- **Delete Values:** Clear the field or delete the **Multiple Value** card.
- 
- **Delete fields:** Click the delete icon (fields appear struck through and grayed out).
- > Note: This only deletes the field from this document, not from your knowledge base.
+ > Note: This only deletes the field from this document, not from your knowledge base.
- 
2. Click **Save** to apply changes.
-##### Set Update Scope
+**Set Update Scope**
Use **Apply to All Documents** to control changes:
- - **Unchecked (Default)**: Updates only documents that already have the field.
+- **Unchecked (Default)**: Updates only documents that already have the field.
- - **Checked**: Adds or updates fields across all selected documents.
+- **Checked**: Adds or updates fields across all selected documents.
-
#### Edit Metadata on the Document Details Page
-You can edit a single document’s metadata on its details page.
+You can edit a single document's metadata on its details page.
-##### Access Metadata Edit Mode
+**Access Metadata Edit Mode**
-To edit a single document’s metadata:
+To edit a single document's metadata:
On the document details page, click **Start labeling** to begin editing.
@@ -264,26 +325,26 @@ On the document details page, click **Start labeling** to begin editing.

-##### Add Metadata
+**Add Metadata**
-To add a single document’s metadata fields and values:
+To add a single document's metadata fields and values:
1. Click **+Add Metadata** to:

- - Create new fields via **+New Metadata**.
+ - Create new fields via **+New Metadata**.
- > New fields are automatically added to the knowledge base.
-
- 
-
- - Add existing fields from the dropdown or from the search box.
+ > New fields are automatically added to the knowledge base.
+
+ 
+
+ - Add existing fields from the dropdown or from the search box.
- 
+ 
- - Access the Metadata Panel via **Manage**.
+ - Access the Metadata Panel via **Manage**.
- 
+ 
2. *(Optional)* Enter values for new fields.
@@ -291,22 +352,22 @@ To add a single document’s metadata fields and values:
3. Click **Save** to apply changes.
-##### Edit Metadata
+**Edit Metadata**
-To update a single document’s metadata fields and values:
+To update a single document's metadata fields and values:
1. Click **Edit** in the top right to begin editing.

2. Edit metadata:
- - **Update Values:** Type directly in value fields or delete it.
+ - **Update Values:** Type directly in value fields or delete it.
- > Note: You can only modify the value, not the value name.
-
- - **Delete Fields:** Click the delete icon.
+ > Note: You can only modify the value, not the value name.
+
+ - **Delete Fields:** Click the delete icon.
- > Note: This only deletes the field from this document, not from your knowledge base.
+ > Note: This only deletes the field from this document, not from your knowledge base.

@@ -324,70 +385,25 @@ See *[Maintaining Dataset via API](https://docs.dify.ai/guides/knowledge-base/kn
- **What can I do with metadata?**
- - Find information faster with smart filtering.
+ - Find information faster with smart filtering.
- - Control access to sensitive content.
+ - Control access to sensitive content.
- - Organize data more effectively.
+ - Organize data more effectively.
- - Automate workflows based on metadata rules.
+ - Automate workflows based on metadata rules.
- **Fields vs Values: What is the difference?**
-| Concept | -Definition | -Characteristics | -Examples | -
|---|---|---|---|
| Metadata Fields in the Metadata Panel | -System-defined attributes that describe document properties | -Global fields accessible across all documents in the knowledge base | -Author, Type, Date, etc. | -
| Metadata Value on a document’s detail page | -Custom metadata tagged according to individual document requirements | -Unique metadata values assigned based on document content and context | -The “Author” field in Document A is set to “Mary” value, while in Document B it is set to “John” value. | -
| Action | -Steps | -Impact | -Outcome | -
|---|---|---|---|
| Delete field in the Metadata Panel | -In the Metadata Panel, click delete icon next to field | -Global - affects all documents | -Field and all values permanently deleted from the knowledge base | -
| Delete field in the Metadata Editor | -In the Metadata Editor, click delete icon next to field | -Selected documents only | -Field deleted from selected documents; remains in the knowledge base | -
| Delete field on the document detail page | -In the Edit Mode, click delete icon next to field | -Current document only | -Field deleted from current document; remains in the knowledge base | -
-
-
-- **字段值计数(Value Count)**:字段值计数是指在某条元数据字段中标记的字段值数量,包括重复项。例如,此处的“3”是字段值计数,指该字段中有 3 个独特的字段值。
+- **字段值计数(Value Count)**:字段值计数是指在某条元数据字段中标记的字段值数量,包括重复项。例如,此处的"3"是字段值计数,指该字段中有 3 个独特的字段值。
-
-
-
-
-
## 如何管理知识库元数据?
@@ -45,7 +52,7 @@ title: 元数据
#### 元数据管理界面简介
-##### 进入元数据管理界面
+**进入元数据管理界面**
在知识库管理界面,点击右上方的 **元数据** 按钮,进入元数据管理界面。
@@ -53,66 +60,76 @@ title: 元数据

-##### 知识库元数据字段的类型
+**知识库元数据字段的类型**
在知识库中,元数据字段分为两类:**内置元数据(Built-in)** 和 **自定义元数据**。
-| - | 内置元数据(Built-in) | -自定义元数据 | +Feature | +内置元数据(Built-in) | +自定义元数据 | +
|---|---|---|---|---|---|
| 显示位置 | +知识库界面 元数据 栏的下半部分。 | +知识库界面 元数据 栏的上半部分。 | |||
| 显示位置 | -知识库界面 元数据 栏的下半部分。 | -知识库界面 元数据 栏的上半部分。 | +启用方式 | +默认禁用,需要手动开启才能生效。 | +由用户根据需求自由添加。 |
| 启用方式 | -默认禁用,需要手动开启才能生效。 | -由用户根据需求自由添加。 | +生成方式 | +启用后,由系统自动提取相关信息并生成字段值。 | +用户手动添加,完全由用户自定义。 |
| 生成方式 | -启用后,由系统自动提取相关信息并生成字段值。 | -用户手动添加,完全由用户自定义。 | +修改权限 | +一旦生成,无法修改字段与字段值。 | +可以删除或编辑字段名称,也可以修改字段值。 |
| 修改权限 | -一旦生成,无法修改字段与字段值。 | -可以删除或编辑字段名称,也可以修改字段值。 | +应用范围 | +启用后,适用于已上传和新上传的所有文档。 | +添加元数据字段后,字段会储存在知识库的元数据列表中/需要手动设置,才能将该字段应用于具体文档。 |
| 应用范围 | -启用后,适用于已上传和新上传的所有文档。 | -添加元数据字段后,字段会储存在知识库的元数据列表中/需要手动设置,才能将该字段应用于具体文档。 | +字段 | +
+ 由系统预定义,包括:
+
|
+ 在初始状态下,知识库无自定义元数据字段,需要用户手动添加。 |
| 字段 | -
- 由系统预定义,包括: - • document_name (string):文件名 - • uploader (string):上传者 - • upload_date (time):上传日期 - • last_update_date (time):最后更新时间 - • source (string):文件来源 - |
- 在初始状态下,知识库无自定义元数据字段,需要用户手动添加。 | -|||
| 字段值类型 | -
- • 字符串 (string):文本值 - • 数字 (number):数值 - • 时间 (time):日期和时间 - |
-
- • 字符串 (string):文本值 - • 数字 (number):数值 - • 时间 (time):日期和时间 - |
+ 字段值类型 | +
+
|
+
+
|
-
-
4. 点击 **保存** 按钮,保存字段。
@@ -145,9 +164,11 @@ title: 元数据
> 此弹窗仅支持修改字段名称,不支持修改字段值类型。
-
-
-
3. 点击 **保存** 按钮,保存修改后的字段。
@@ -169,7 +190,7 @@ title: 元数据
你可以在知识库管理界面批量编辑文档的元数据信息。
-##### 打开编辑元数据弹窗
+**打开编辑元数据弹窗**
1. 打开知识库管理界面,在文档列表左侧的白色方框中勾选你希望批量操作的文档。勾选后,页面下方会弹出操作选项。
@@ -179,41 +200,65 @@ title: 元数据

-##### 批量新增元数据信息
+**批量新增元数据信息**
1. 在 **编辑元数据** 弹窗中点击底部的 **+添加元数据** 按钮,弹出操作弹窗。
-
- 如需为选中文档添加已创建的字段:
- - 可以从下拉列表中选择已有的字段,添加到字段列表中。
-
- - 可以在 **搜索元数据** 搜索框中搜索你需要的字段,添加到该文档的字段列表中。
-
- 
- 如需为选中文档新建字段,可以点击弹窗左下角的 **+新建元数据** 按钮,并参考前文的 **新建元数据字段** 章节新建字段。
-
- > 在 **+新建元数据** 弹窗中新建的元数据字段,将自动同步至知识库字段列表中。
+
+ > 在 **+新建元数据** 弹窗中新建的元数据字段,将自动同步至知识库字段列表中。
- 
+
- 如需管理已创建的字段,可以点击该弹窗右下角的 **管理** 按钮,跳转到知识库的管理界面。
- 
2. *(可选)* 新增字段后,在字段值框内填写该字段相应的字段值。
-
- 如果值类型为 **时间**,在填写字段值时会弹出时间选择器,供你选择具体时间。
-
3. 点击 **保存** 按钮,保存操作。
-##### 批量删改元数据信息
+**批量删改元数据信息**
1. 在 **编辑元数据** 弹窗中删改元数据信息:
@@ -221,39 +266,55 @@ title: 元数据
- **重置字段值**: 将光标悬停在字段名左侧的蓝色圆点上,蓝点将变为 **重置** 按钮。点击蓝点,将字段框内修改后的内容重置为原始元数据值。
- 
- **删除字段值**:
- - 删除一个字段值:在需要删除字段值的字段框内直接删除该字段值。
+ - 删除一个字段值:在需要删除字段值的字段框内直接删除该字段值。
- - 删除多个字段值:点击 **多个值** 卡片的删除图标,清空所有选中文档的该元数据字段的值。
+ - 删除多个字段值:点击 **多个值** 卡片的删除图标,清空所有选中文档的该元数据字段的值。
- 
- **删除单条元数据字段**: 点击字段最右侧的删除符号,删除该字段。删除后,该字段会被横线划掉且置灰。
-
- > 此操作仅会删除已选文档的该字段与字段值,字段本身依然保留在知识库中。
+
+ > 此操作仅会删除已选文档的该字段与字段值,字段本身依然保留在知识库中。
- 
2. 点击 **保存** 按钮,保存操作。
-##### 调整批量操作的应用范围
+**调整批量操作的应用范围**
- **调整批量操作的应用范围**: 你可以使用 **编辑元数据** 弹窗左下角的 **应用于所有文档** 选框来调整编辑模式中改动的应用范围。
- - **否(默认)**: 如果不选中该选项,编辑模式中的改动仅对原本已有该元数据字段的文档生效,其他文档不会受到影响。
+ - **否(默认)**: 如果不选中该选项,编辑模式中的改动仅对原本已有该元数据字段的文档生效,其他文档不会受到影响。
- - **是**: 如果选中该选项,编辑模式中的改动会对所有选中的文档生效。原本没有该字段的文档,会自动添加该字段。
+ - **是**: 如果选中该选项,编辑模式中的改动会对所有选中的文档生效。原本没有该字段的文档,会自动添加该字段。
-
#### 编辑单篇文档元数据信息
你可以在文档详情界面中编辑单篇文档的元数据信息。
-##### 进入文档元数据编辑模式
+**进入文档元数据编辑模式**
1. 在文档详情界面,点击信息栏上方的 **开始标记** 按钮。
@@ -263,28 +324,28 @@ title: 元数据

-##### 新增文档元数据信息
+**新增文档元数据信息**
1. 在文档的元数据编辑模式中,点击 **+添加元数据** 按钮,弹出操作弹窗。

- 如需使用新建字段为该文档标记字段值,可以点击弹窗左下角的 **+ 新建元数据** 按钮,并参考前文的 **新建元数据字段** 章节新建字段。
- > 在文档页面新建的元数据字段,将自动同步至知识库字段列表中。
-
- 
+ > 在文档页面新建的元数据字段,将自动同步至知识库字段列表中。
+
+ 
- 如需使用知识库已有的字段为该文档标记字段值,可以选择下列任意一种方式使用已有的字段:
- - 从下拉列表中选择知识库已有的字段,添加到该文档的字段列表中。
+ - 从下拉列表中选择知识库已有的字段,添加到该文档的字段列表中。
- - 在 **搜索元数据** 搜索框中搜索你需要的字段,添加到该文档的字段列表中。
-
- 
+ - 在 **搜索元数据** 搜索框中搜索你需要的字段,添加到该文档的字段列表中。
+
+ 
- 如需管理知识库已有的字段,可以点击弹窗右下角的 **管理** 按钮,跳转到知识库的管理界面。
- 
+ 
2. *(可选)* 添加字段后,在字段名右侧的元数据栏中填写字段值。
@@ -292,20 +353,20 @@ title: 元数据
3. 点击右上角的 **保存** 按钮,保存字段值。
-##### 删改文档元数据信息
+**删改文档元数据信息**
1. 在文档的元数据编辑模式中,点击右上角的 **编辑** 按钮,进入编辑模式。

2. 删改文档元数据信息:
- - **删改字段值**: 在字段名右侧的字段值框内,删除或修改字段值。
+ - **删改字段值**: 在字段名右侧的字段值框内,删除或修改字段值。
- > 此模式仅支持修改字段值,不支持修改字段名。
+ > 此模式仅支持修改字段值,不支持修改字段名。
- - **删除字段**: 点击字段值框右侧的删除按钮,删除字段。
+ - **删除字段**: 点击字段值框右侧的删除按钮,删除字段。
- > 此操作仅会删除该文档的该字段与字段值,字段本身依然保留在知识库中。
+ > 此操作仅会删除该文档的该字段与字段值,字段本身依然保留在知识库中。

@@ -323,70 +384,25 @@ title: 元数据
- **元数据有什么作用?**
- - 提升搜索效率:用户可以根据元数据标签快速筛选和查找相关信息,节省时间并提高工作效率。
+ - 提升搜索效率:用户可以根据元数据标签快速筛选和查找相关信息,节省时间并提高工作效率。
- - 增强数据安全性:通过元数据设置访问权限,确保只有授权用户能访问敏感信息,保障数据的安全性。
+ - 增强数据安全性:通过元数据设置访问权限,确保只有授权用户能访问敏感信息,保障数据的安全性。
- - 优化数据管理能力:元数据帮助企业或组织有效分类和存储数据,提高数据的管理和检索能力,增强数据的可用性和一致性。
+ - 优化数据管理能力:元数据帮助企业或组织有效分类和存储数据,提高数据的管理和检索能力,增强数据的可用性和一致性。
- - 支持自动化流程:元数据在文档管理、数据分析等场景中可以自动触发任务或操作,简化流程并提高整体效率。
+ - 支持自动化流程:元数据在文档管理、数据分析等场景中可以自动触发任务或操作,简化流程并提高整体效率。
- **知识库元数据管理列表中的元数据字段和某篇文档中的元数据值有什么区别?**
-| / | -定义 | -性质 | -举例 | -
|---|---|---|---|
| 元数据管理列表中的元数据字段 | -预定义的字段,用于描述文档的某些属性。 | -全局性字段。所有文档都可以使用这些字段。 | -作者、文档类型、上传日期。 | -
| 某篇文档中的元数据值 | -每个文档按需标记的针对特定文档的信息。 | -文档特定的值。每个文档根据其内容会标记不同的元数据值。 | -文档 A 的“作者”字段值为“张三”,文档 B 的“作者”字段值为“李四”。 | -
| 操作方式 | -操作方法 | -影响范围 | -结果 | -
|---|---|---|---|
| 在知识库管理界面删除某条元数据字段 | -在知识库管理界面,点击某条元数据字段右侧的删除图标,删除该字段。 | -从知识库管理列表中完全删除该元数据字段及其所有字段值。 | -该字段从知识库中移除,所有文档中的该字段及包含的所有字段值也会消失。 | -
| 在编辑元数据弹窗中删除已选文档的某条元数据字段 | -在编辑元数据弹窗中,点击某条元数据字段右侧的删除图标,删除该字段。 | -仅删除已选文档的该字段与字段值,字段本身依然保留在知识库管理列表中。 | -选中文档中的字段与字段值被移除,但字段仍保留在知识库内,字段值计数会发生数值上的变化。 | -
| 在文档详情界面删除某条元数据字段 | -在文档详情界面中的元数据编辑模式里,点击某条元数据字段右侧的删除图标,删除该字段。 | -仅删除该文档的该字段与字段值,字段本身依然保留在知识库管理列表中。 | -该文档中的字段与字段值被移除,但字段仍保留在知识库内,字段值计数会发生数值上的变化。 | -
| Feature | +Built-in Metadata | Custom Metadata |
|---|
| Feature | +内置元数据(Built-in) | 自定义元数据 |
|---|