跳到主要内容

文档管理

文档管理是知识库的核心功能，支持多种文档来源和格式。

📥 添加文档​

支持的文档来源​

来源描述
文件上传从本地上传文件
文本粘贴直接粘贴文本内容
外部表格从钉钉/飞书导入表格
网页抓取从 URL 抓取网页内容

文件上传​

  1. 点击 添加文档 → 上传文件
  2. 从电脑选择文件
  3. 配置分块设置（可选）
  4. 点击 上传

支持的格式：

  • .txt - 纯文本文件
  • .md - Markdown 文件
  • .pdf - PDF 文档
  • .doc, .docx - Word 文档

文本粘贴​

  1. 点击 添加文档 → 粘贴文本
  2. 输入文档标题
  3. 粘贴或输入内容
  4. 点击 保存

适合快速创建小型文档。

外部表格​

  1. 点击 添加文档 → 外部表格
  2. 输入表格 URL（钉钉/飞书）
  3. 配置同步设置
  4. 点击 导入

支持从在线表格服务导入数据。

网页抓取​

  1. 点击 添加文档 → 网页 URL
  2. 输入网页地址
  3. 系统抓取并处理内容
  4. 点击 导入

网页文档支持重新抓取更新。当网页内容变化时，可使用刷新功能获取最新内容。

📋 文档列表​

列表功能​

  • 搜索：按名称搜索文档
  • 排序：按名称、大小、日期排序
  • 筛选：按状态筛选文档
  • 目录过滤：开放接口可通过 folder_id 只列出指定目录的直接文档

文档状态​

状态描述
已启用文档已索引且可搜索
已禁用文档存在但不参与搜索
排队中文档等待处理
待转换文档正在等待格式转换（PDF/PPTX 等）
转换中文档正在转换为 Markdown
索引中文档正在进行 RAG 索引
错误索引失败

📁 目录管理​

知识库文档可以按目录组织。目录是知识库文档属性，不是附件属性；通用附件上传接口不会接收 folder_id。

目录 ID 语义：

  • folder_id=0 表示根目录。
  • 不传 folder_id 表示不按目录过滤。
  • 按目录列出文档时，目录过滤只返回该目录的直接文档，不递归返回子目录文档。
  • 创建、移动、删除目录和移动文档的完整开放接口见 知识库开放接口。

🔎 开放检索范围过滤​

开放检索支持按目录或文档限定范围，适合只在某个专题目录、根目录直接文档或若干指定文档内搜索。

传参规则：

  • 整库搜索：不要传 folder_ids 或 document_ids。
  • 根目录搜索：传 folder_ids: [0]。
  • 子目录搜索：传 folder_ids: [10]，并用 include_subfolders 控制是否包含子目录。
  • folder_ids 与 document_ids 同时传时，范围取并集。
  • folder_ids=[] 或 document_ids=[] 是非法参数，不能用空数组表示整库。
  • 指定范围内没有文档时返回空结果，不会退化为整库搜索。
  • 请求体示例和完整参数说明见 知识库开放接口。

✏️ 管理操作​

基本操作​

操作描述
查看详情查看文档内容和元数据
编辑修改文档名称和设置
启用/禁用切换文档是否参与搜索
重新索引使用新设置重新处理文档
删除永久移除文档
查看分块检查文档如何被分割

批量操作​

支持多选文档进行批量操作：

  1. 使用复选框选择多个文档
  2. 点击 全选 选择所有文档
  3. 点击 批量删除 删除选中的文档

📌 笔记本模式的文档选择​

在笔记本模式下，文档列表支持选择功能：

选择功能​

  • 选择特定文档：勾选文档将其加入上下文
  • 全选/取消全选：快速选择或取消所有文档
  • 自动选择：新上传的文档自动被选中

上下文注入​

选择的文档会在对话中作为上下文提供给 AI，帮助 AI 更好地理解和回答问题。

🔍 文档编辑​

可编辑内容​

  • 文档名称：修改文档的显示名称
  • 分块设置：调整文档的分块策略
  • 启用状态：控制文档是否参与检索

编辑限制​

  • 来源类型：不能更改文档的来源类型
  • 文件内容：文件类文档的内容不能直接编辑
  • 表格 URL：外部表格的 URL 不能直接修改

🔄 网页文档刷新​

网页文档支持重新抓取：

  1. 在文档列表中找到网页文档
  2. 点击 刷新 按钮
  3. 系统将重新抓取网页内容
  4. 更新后的内容将自动重新索引

适合跟踪经常更新的网页内容。

💡 最佳实践​

文档组织​

实践描述
有意义的名称使用描述性的文档名称
一致的格式标准化文档格式
定期更新文档变更时重新索引
清洁内容移除无关的页眉/页脚

文档大小​

  • 单个文件建议不超过 50MB
  • 超大文档可以拆分成多个小文档
  • 文本类文档比扫描版 PDF 更易处理

🔗 相关文档​