导入文档
从「我的知识库」点击标题或文档操作进入知识库详情页（文档列表），工具条提供两种新增方式：
- 新增（按表单）：直接录入标题、摘要与正文，适合单篇短内容；
- 新增（按文件）：批量上传文件，适合正式导入。
按文件上传
- 点击新增（按文件），打开上传弹窗（卡片标题「上传文档以生成文档」）。
- 选择分段模式。下拉框下方的灰色说明随模式切换，原文如下：
| 模式 | 界面说明原文 |
|---|---|
| 通用分段 | 通用分段：适用于连续成篇的内容（文章、说明、手册），按切分参数切块，每块直接向量化召回 |
| 问答 | 问答：适用于 FAQ 类内容，以问答对组织；问题被向量化召回，答案原样返回 |
| 父子分段 | 父子分段：适用于长文档，子块精准匹配，命中后返回所属父段作为完整上下文 |
- 问答模式仅支持 XLSX / XLS / CSV（可点击下载模板），每个文件生成一个独立的问答文档、文件名作为文档标题；文件格式细则见Q&A 导入与生成；
- 父子模式显示子块最大Token数（父子模式），说明原文：「父段按此大小切分为子块,子块用于精准匹配,命中后返回所属父段作为完整上下文;取值 50-4000,默认 200,修改后重新向量化生效」；
- 通用分段沿用知识库的切段设置，无附加参数。
- 拖拽文件到上传区（或点击选择）。
| 限制 | 值 |
|---|---|
| 格式 | TXT、PDF、DOC、DOCX、XLS、XLSX、PPT、PPTX |
| 单文件大小 | ≤ 10MB |
| 单次数量 | 最多 20 个 |
- 点击上传并生成文档。上传完成后文档出现在列表中，初始向量化状态为待处理。
TIP
扫描版 PDF（图片型）无法提取文本，导入后字符数为 0 或检索不到，请先用 OCR 工具转为文本版再上传。
按表单新增
点击**新增（按表单）**进入文档编辑页，填写标题、摘要、正文并选择分段模式，详见编辑文档。问答模式下还可上传 QA 文件或勾选 AI 自动生成，见Q&A 导入与生成。
建立索引
上传只是生成了文档与片段，建立索引后才能被检索到：
- 在文档列表勾选一个或多个文档；
- 点击索引选中内容（N 篇）；
- 选择索引类型：向量化 / 图谱化（可同时勾选）。弹窗内提示原文：
NOTE
「对文档进行图谱化时会使用到大语言模型，需要消耗一定量的Token」——建议先向量化验证检索效果，再按需图谱化。
- 点击确定，提示「索引任务后台执行中」，列表每 3 秒自动轮询刷新状态。
未图谱化的文档可随时补建：从分段管理页的文档卡片触发图谱抽取。
文档列表说明
| 列 | 说明 |
|---|---|
| 分段模式 | 通用分段 / 问答 / 父子分段 标签 |
| 向量化状态 | 待处理 / 处理中 / 已向量化 / 失败（附时间） |
| 图谱状态 | 是否已抽取图谱 |
| 附件 | 原始上传文件，点击预览 |
| 字符数 | 正文字符量（判断解析是否正常的第一指标） |
| 向量命中 / 图谱命中 | 该文档片段在检索中被命中的次数——长期为 0 说明内容与提问不匹配 |
| 已启用 | 开关。停用后该文档不参与检索（后果见分段管理） |
| 创建 / 更新时间 | 最近变更 |
操作列：片段（进入分段管理）、图谱（查看图谱，未图谱化时禁用并提示「暂未图谱化」）、编辑、删除。
编辑文档
列表操作列点击编辑（或按表单新增时）可设置：
| 字段 | 说明 |
|---|---|
| 标题 / 摘要 / 正文 | 正文是分段与索引的内容来源 |
| 分段模式 | 切换时警告：「切换分段模式将作废该文档现有片段与向量索引，并按新模式自动重建；图谱不自动重建，需手动重新抽取」 |
| 子块最大 Token 数 | 仅父子模式显示 |
- 问答模式的附加项（AI 自动生成、导入 QA 对）见Q&A 导入与生成；
- 编辑正文保存后，受影响的片段会自动重新向量化。
WARNING
问答模式下直接编辑正文不影响已生成的问答对。要让改动生效，需在问答对列表中手动更新，或用 AI 重新生成（会清空现有问答对）。