知识库

知识库是为智能体提供**「专属知识」**的模块。通过上传企业自有文档或对接外部知识 API，让智能体在对话时能基于企业知识进行精准回答，而非仅依赖大模型的通用知识。

入口路径：左侧导航栏 → 资源管理 → 知识库

核心价值：

• 让智能体回答企业特有的产品信息、角色设定、FAQ 等内容；
• 基于知识检索（RAG）回答，减少大模型「幻觉」；
• 支持文件上传和外部 API 两种知识接入方式。

使用链路：

创建知识库（上传文件/配置 API） → 在技能中关联知识库 → 对话时自动检索知识 → 基于知识生成回答

1 知识库类型

类型	说明	适用场景
文件上传	上传文档文件，系统自动解析、切片、建索引	产品手册、FAQ 文档、角色设定、故事内容等静态知识
外部链接调用	配置外部 API 地址，对话时实时调用获取知识	知识频繁更新、已有知识服务、需要实时数据的场景

文档解析

• 上传 Word 文档先解析为 Markdown 格式，再进行后续处理。

切片规则

• 按标题切片，支持六级标题（H1~H6）；
• 切片最大长度：300 字符；
• overlap（重叠）：10 字符；
• 切片间保持树形结构，依标题层级建立父子关系。

索引与检索

• 当前仅支持文本内容的索引和检索；
• 索引对象为切片内容。

2 知识库列表页

列表页以表格形式展示当前企业下所有知识库。

表格列：

列名	说明
标题	知识库名称
类型	文件上传 / 外部链接调用
创建人	创建该知识库的用户
创建时间	创建时间
更新人	最近修改的用户
更新时间	最近修改时间
操作	管理 / 删除

支持的操作：

• 类型筛选：左上角下拉框可按「全部类型 / 文件上传 / 外部链接调用」筛选；
• 搜索：输入知识库名称模糊搜索；
• 新建：点击右上角「+ 新建知识库」；
• 管理：进入知识库详情页，编辑内容；
• 删除：删除该知识库。

3 新建知识库

3.1 文件上传类型

配置字段：

字段	是否必填	说明
知识库名称	必填	自定义名称，用于在技能关联时识别
知识库描述	选填	描述该知识库的内容范围
上传文件	必填	支持拖拽或点击选择文件上传

文件格式要求：

• 支持格式：Word 文档（.docx）、Markdown 文件（.md）；
• 建议使用 Markdown 格式（结构清晰，切片效果更好）。

操作流程：

1. 进入知识库管理 → 点击「+ 新建知识库」；
2. 填写知识库名称和描述；
3. 选择「文件上传」Tab；
4. 拖拽文件到上传区域，或点击「选择文件」上传；
5. 点击「创建知识库」完成。

3.2 外部链接调用类型

配置字段：

字段	是否必填	说明
知识库名称	必填	自定义名称
知识库描述	选填	描述该知识库的内容范围
API 地址	必填	外部知识服务的接口 URL
API Header	选填	请求头参数（如鉴权 Token 等）
知识召回阈值	必填	范围 0-1，值越大表示召回的相关度要求越高（默认 0.7）

操作流程：

1. 进入知识库管理 → 点击「+ 新建知识库」；
2. 填写知识库名称和描述；
3. 选择「外部链接调用」Tab；
4. 填写 API 地址和 Header（如有鉴权需求）；
5. 设置知识召回阈值（建议保持默认 0.7，按需调整）；
6. 点击「创建知识库」完成。

4 管理知识库

在列表页点击「管理」进入知识库详情页。

4.1 文件上传类型的管理

详情页包含：

• 知识库名称：可修改；
• 知识库类型：显示「文件上传」（不可修改）；
• 知识库描述：可修改；
• 源文件管理：展示已上传文件列表。

已上传文件列表列：

列名	说明
文件名	上传的文件名称
大小	文件大小
创建人	上传者
创建时间	上传时间
操作	下载 / 重新导入 / 删除

文件操作说明：

• 上传新文件：点击「上传新文件」添加更多知识文件；
• 下载：下载已上传的源文件；
• 重新导入：用新版本文件覆盖该文件的知识内容（文件名不变）；
• 删除：移除该文件及其对应的知识内容。

修改后点击「保存修改」生效。

4.2 外部链接调用类型的管理

可修改 API 地址、Header 和召回阈值，保存后下次对话调用时生效。

5 在技能中关联知识库

知识库创建完成后，需要在技能中关联才能在对话中生效。

支持关联知识库的技能：闲聊、知识问答。技能说明见 技能配置。

关联配置项：

配置项	说明
选择知识库	从已创建的知识库列表中选择要关联的知识库
返回结果数量	检索命中后返回给 LLM 参考的知识条数
匹配阈值	知识检索的相似度阈值，低于该值的结果不返回

配置路径： 产品管理 → 智能体配置详情 → 技能列表 → 编辑目标技能（如闲聊） → 关联知识库区域。

6 Q&A

Q：知识库支持上传哪些格式的文件？ A：目前支持 Word 文档（.docx）和 Markdown 文件（.md）。建议使用 Markdown 格式，结构化程度高，切片检索效果更好。

Q：上传的文件大小有限制吗？ A：有平台限制，具体上限以上传时的提示为准。建议单个文件不要过大，可按主题拆分为多个文件。

Q：文件上传和外部链接调用的区别是什么？ A：文件上传适合静态知识（产品手册、FAQ 等），上传后系统自动建索引；外部链接调用适合动态知识（实时数据、频繁更新的内容），每次对话时实时调用 API 获取。

Q：知识召回阈值设多少合适？ A：默认 0.7 适合大多数场景。如果发现知识命中率太低（该回答的没回答），可适当降低到 0.5-0.6；如果发现召回了不相关内容，可提高到 0.8-0.9。

Q：一个技能可以关联多个知识库吗？ A：请参考技能编辑界面的实际配置选项。

Q：修改知识库内容后多久生效？ A：文件上传类型修改后需要重新建索引，通常几分钟内生效；外部链接调用类型保存后下次对话即时生效。

Q：删除知识库会影响已关联的技能吗？ A：会。删除后已关联该知识库的技能将无法再检索到对应知识，建议先在技能中取消关联再删除。

下一步

• 知识库需在技能中关联才生效，技能配置详见 技能配置
• 其他资源（型号库、指令库等）详见「资源管理」下各章