Files
dify-docs/zh/use-dify/knowledge/manage-knowledge/maintain-knowledge-documents.mdx
github-actions[bot] 688fd5756f 🌐 Sync PR #636 translations: Optimize the knowledge retrieval page (#638)
* 🌐 Initial translations for PR #636

Auto-generated translations for documentation changes in PR #636.

Last-Processed-Commit: 3f204fbd9d
Original-PR: #636
Languages: Chinese (zh), Japanese (ja)

🤖 Generated with GitHub Actions

* 🔄 Update translations for commit 623b346a

Auto-generated translations for changes in commit 623b346a77.

Last-Processed-Commit: 623b346a77
Original-PR: #636
Languages: Chinese (zh), Japanese (ja)

🤖 Generated with GitHub Actions

* Fix pricing link for batch upload information

Updated the link for the paid plan pricing page.

* Update maintain-knowledge-documents.mdx

* Update link text for knowledge base creation

* Update pricing link in readme for batch upload

* Update setting-indexing-methods.mdx

* Update knowledge-retrieval.mdx

---------

Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: Riskey <36894937+RiskeyL@users.noreply.github.com>
2025-12-24 21:56:01 +08:00

75 lines
4.8 KiB
Plaintext
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
---
title: 维护知识库内容
sidebarTitle: 维护内容
---
<Note> ⚠️ 本文档由 AI 自动翻译。如有任何不准确之处,请参考[英文原版](/en/use-dify/knowledge/manage-knowledge/maintain-knowledge-documents)。</Note>
## 管理文档
在知识库中每个导入的项——无论是本地文件、Notion 页面还是网页——都会成为一个文档。
你可以在文档列表中查看和管理所有文档,确保知识库的内容始终准确、相关且最新。
<Tip>
点击顶部的知识库名称,可快速切换不同知识库。
</Tip>
![管理文档](/images/manage_knowledge_documents.png)
| 操作 | 说明 |
|:------------------- |:---------------------|
| 添加 | 导入新文档。|
| 修改分段设置 | 修改文档的分段设置(不包括分段结构)。<Info>每个文档可拥有独立的分段设置,但分段结构在整个知识库中共享,且一旦设置无法更改。</Info>|
| 删除 | 永久删除文档。**删除不可撤销**。|
| 启用 / 禁用 | 临时将文档纳入或排除检索。<Note>在 Dify Cloud 上,长时间未更新或未被检索的文档会自动禁用以优化性能。<br/><br/>不同订阅计划的未活跃时长如下:<ul><li>Sandbox7 天</li><li>Professional & Team30 天</li></ul>Professional 和 Team 用户可**一键**重新启用这些文档。</Note>|
| 归档 / 取消归档 | 将不再需要检索但仍需保留的文档归档。归档文档为只读,可随时取消归档。|
| 编辑 | 通过编辑分段内容修改文档。详见 [管理分段](#管理分段)。|
| 重命名 | 修改文档名称。|
## 管理分段
根据其分段设置,每个文档被拆分为一个或多个分段,而分段是检索的基本单元。
你可以在文档的分段列表中查看和管理所有分段,以提升检索效率与准确性。
<Tip>
点击左上角的文档名称,可快速切换不同文档。
</Tip>
![管理分段](/images/manage_document_chunks.png)
| 操作 | 说明 |
|:-------- |:---------------------|
| 添加 | 新增或批量新增分段。<br/><br/>对于采用父子分段模式的文档,可同时新增父分段和子分段。<Info>「添加分段」在 Dify Cloud 上为付费功能,[升级至 Professional 或 Team 版](https://dify.ai/pricing) 即可解锁使用。</Info>|
| 删除 | 永久删除分段。**删除不可撤销**。|
| 启用 / 禁用 | 临时将分段纳入或排除检索。已禁用的分段不可编辑。|
| 编辑 | 修改分段内容。已编辑的分段将标记为 **已编辑**。<br/><br/>对于采用父子分段模式的文档:<ul><li>编辑父分段时,可选择重新生成其子分段或保持原有的子分段不变。</li><li>编辑子分段不会改变其父分段。</li></ul><Tip>当文档中的图片被提取为分段附件时,其 URL 会保留在分段文本中。删除 URL 不会影响已提取的图片附件。</Tip>|
| 添加 / 编辑 / 删除关键词 | 在使用经济索引方式的知识库中,可为分段添加或修改关键词,以提升其可检索性。<br/><br/>一个分段最多可添加 10 个关键词。|
| 添加 / 删除图片附件 | 在对应分段中,删除从文档中提取的图片或上传新图片。<br/><br/>图片附件和分段内容可独立编辑,互不影响。<Note> 每个分段最多支持 10 张图片附件,在检索中将被一同返回;超过数量的图片不会被提取。<br/><br/>对于自托管部署,可通过修改环境变量 `SINGLE_CHUNK_ATTACHMENT_LIMIT` 调整此数量限制。</Note><Tip>若要启用跨模态检索——即基于语义相关性同时检索文本和图片,需为知识库选择多模态嵌入模型(带有 **Vision** 图标)。<br/><br/>被提取的图片附件将被向量化并参与检索。</Tip>|
## 最佳实践
### 检查分段质量
文档完成分段后,仔细检查每个分段,确保其语义完整、长度适中,以保证检索准确性和回复相关性。
常见问题包括:
- 分段 **过短**:上下文不完整,易造成语义丢失和答案不准确。
- 分段 **过长**:包含无关信息,易引入语义噪音、降低检索精度。
- 分段 **语义不完整**:句子或段落被分段设置强制切断,易导致检索结果存在内容缺失或误导。
### 将子分段用作父分段的检索钩子
对于采用父子分段模式的文档,系统会在子分段中进行搜索,但返回的是父分段。由于编辑子分段不会改变其父分段,可将子分段作为父分段的语义标签或检索提示。
具体做法是将子分段改写为 **关键词**、**摘要** 或 **常见用户问题**。例如,若父分段的内容为*退货政策*,可将子分段改写为:
- *如何退货?*
- *退款周期是多少?*
- *退货需要支付运费吗?*