添加与整理资料
知识库支持文件、黑洞智能体 笔记、本地目录和单个网页地址。导入后还要检查处理状态、正文和 Chunks，并在资料更新时重新索引。
选择正确入口
知识页面的【添加数据源】：按资料类型新建或导入文档、笔记、目录与链接。
| 入口 | 适合什么资料 | 导入后的关系 | 主要注意事项 |
|---|---|---|---|
| 文件 | PDF、Office、Markdown、文本等 | 保存托管副本 | 单次最多选择 20 项 |
| 笔记 | 黑洞智能体 中已经整理的内容 | 导入当时的内容快照 | 原笔记后续修改不会自动同步 |
| 目录 | 同一主题下的一批本地文件 | 按目录内容建立资料条目 | 不要把无关目录整体导入 |
| 链接 | 单个可以公开访问的网页 | 保存抓取时的网页快照 | 登录页、脚本渲染或受限网页可能不完整 |
添加并验收资料
1. 选择资料来源
打开知识库，点击添加资料按钮，选择【文件】、【笔记】、【目录】或【链接】。
2. 确认选中的内容
文件和笔记可以批量选择；单次交互式添加最多 20 项。资料更多时分批添加，或使用目录入口。
3. 处理同名冲突
新资料与现有条目同名时，选择【全部保留】或【替换】。更新制度、手册和笔记快照时通常选择【替换】。
4. 等待处理完成
资料会经过复制、读取、切分和索引等阶段。没有配置嵌入模型时不会建立向量，但仍会建立关键词索引。
检查资料的处理状态；显示完成后，再抽查内容并测试召回。
5. 抽查正文和 Chunks
打开资料查看正文，或从资料行菜单查看 Chunks。重点检查标题顺序、表格、OCR 文字和关键句是否被错误拆开。
6. 完成召回测试
用一个答案明确的问题检查正确来源和片段。资料更新后，也要使用同一组问题重新测试。
召回测试：输入真实问题，检查命中片段、来源和相关度。
资料状态与处理方法
| 现象 | 可能原因 | 处理方法 |
|---|---|---|
| 长时间处理中 | 文件较大、解析器或模型不可用 | 检查原文件、文档处理和嵌入模型 |
| 显示错误 | 复制、读取、切分或索引失败 | 打开错误信息，按失败阶段处理 |
| 正文缺失或乱码 | 文件处理器不适配、扫描内容未 OCR | 更换文档处理方式或配置 OCR |
| Chunk 缺少关键句 | 分块边界不合适 | 调整分块后执行【重新索引】 |
| 新旧版本同时命中 | 同名资料选择了【全部保留】 | 删除旧条目，或重新导入并选择【替换】 |
重新索引与删除
切分、解析器或嵌入设置改变后，旧条目不会自动套用新设置。对单条资料使用【重新索引】，或批量选择资料后重新索引。
配置说明
| 配置项 | 产品默认值 | 建议起点 | 作用 | 适用场景 | 注意事项 |
|---|---|---|---|---|---|
| 单次添加数量 | 最多 20 项 | 先添加少量代表性资料 | 控制一次导入规模 | 第一次建库或排错 | 大批量导入前先验证解析和召回 |
| 同名处理 | 发生冲突时选择 | 更新资料优先【替换】 | 决定新旧条目是否并存 | 制度、手册、笔记更新 | 【全部保留】可能让旧内容参与召回 |
| 重新索引 | 手动执行 | 设置变化后执行 | 让旧资料使用新解析、分块或模型 | 调优或修复资料 | 完成后必须重新做召回测试 |
用户案例
小林每月更新差旅制度。他把新文件以相同名称导入，并选择【替换】，等资料处理完成后抽查正文和 Chunks，再用固定问题测试住宿、交通和审批规则。
完成标准是：旧规则不再出现在召回结果中，新规则的条件和金额能够稳定命中。
常见问题
修改原笔记后，知识库会自动更新吗？
不会。笔记导入的是当时内容的快照。修改后需要重新添加并选择【替换】，或对对应资料执行【重新索引】。
网页为什么只抓到部分内容？
需要登录、依赖脚本渲染或存在访问限制的网页可能无法完整抓取。可以改用文件或笔记保存正文后再导入。
删除知识库条目会删除原文件吗？
不会删除原始文件或原笔记，但会移除知识库中的托管副本和索引。