知识库提供新建、启用、禁用、删除以及文档管理等能力，是提升数字员工/团队知识准确性的重要基础模块。

知识库在平台中的作用

知识库的核心价值主要体现在两个方面：

为数字员工/团队提供稳定、可引用的业务知识来源。
通过检索和召回机制，提高模型回答的准确性和可用性。

主要功能

包括以下内容：

新建知识库
启用与禁用
文档管理
文本嵌入模型调整
查询改写
召回测试
日志查看
MCP 服务开放

1. 新建知识库

创建知识库时，需要先选择文本嵌入模型。

2. 知识库启用

维护完成的知识库默认处于启用状态。禁用后的知识库也可以再次启用；只有启用状态的知识库才能被数字员工/团队引用。

3. 知识库禁用

启用状态下的知识库可以被禁用。禁用后，引用该知识库的数字员工/团队会失效，因此建议在调整前先确认影响范围。

文本嵌入模型

知识库支持调整文本嵌入模型。调整后，系统会使用新的文本嵌入模型对当前知识库下的所有文档重新入库。

重新入库可能耗费较长时间。处理完成前，建议先等待文档状态恢复正常，再进行召回测试或正式使用。

如果知识库已经被数字员工/团队引用，调整文本嵌入模型前建议先确认使用场景，避免重新入库期间影响检索效果。

文档管理

文档管理用于集中维护知识库中的文档内容，包含文档添加、解析策略、删除等操作。

添加文档

支持的文档类型

当前支持常见文本类文档格式，例如 PDF、TXT、DOC、DOCX、MD 等。

文档设置

添加文档时，可以配置快速解析与分段策略：

快速解析适用于纯文本场景，不会提取图像、表格等元素。
分段策略支持自动分段与预处理规则。
也可以根据实际需要自定义分段规则、分段长度和预处理规则。

文档分段预览

在正式入库前，可以先预览按照当前配置规则解析后的分段效果；如果结果不符合预期，可以继续调整策略。

文档处理

当预览效果符合预期后，即可将文档入库，系统会按设定规则自动处理。

文档策略调整

对于已经入库的文档，如果最终效果不及预期，可以再次调整文档策略，无需重复上传文档。

:::note 当文档处于处理中状态时，暂不允许进行策略调整，需等待入库完成后再操作。 :::

删除文档

如果文档已不再使用，可以将其从知识库中删除。

查询改写

知识库设置支持开启查询改写。开启后，系统会结合多轮对话上下文，对用户当前查询语句进行改写，再用于知识库检索。

查询改写适合以下场景：

用户连续追问，需要结合前文理解当前问题。
用户问题中存在省略表达，例如“那它怎么处理”。
希望提升知识库检索时的查询准确率。

查询改写会影响知识库检索使用的查询语句，但不会修改用户原始输入内容。

访问设置

知识库详情页新增了“访问设置”菜单，用于控制哪些人员可以直接使用当前知识库。访问设置中的“内部访问”页签支持按以下范围授权：

全部人员
指定人员
部门
角色

配置完成后，系统会展示当前已授权的对象列表，并支持继续新增或移除授权对象。权限修改保存后即时生效。

需要注意的是，资源权限只影响知识库被直接访问、直接展示和直接使用的场景。例如在 bit-Agent 中直接选择知识库进行检索时，用户只能看到自己有权限的知识库；未授权用户不可见，也不可直接使用。

如果知识库已经在数字员工/团队中被引用，知识库的访问设置控制的是知识库本身的直接使用范围；数字员工/团队是否可访问，仍由数字员工/团队自身的访问设置控制。

召回测试

可以对知识库中的内容进行召回测试。如果测试效果不及预期，可以继续调整文档策略或召回方式。

日志

知识库支持查看调用日志，便于了解知识库被哪些入口使用，以及检索结果是否符合预期。

MCP 服务开放

知识库支持手动开放为 MCP 服务，并支持日志记录与显示。

开启与关闭

开启后会自动生成 MCP 服务地址和访问凭证。
关闭后会停止访问。
重新开启后，原有访问地址和访问凭证保持不变。

鉴权与参数

访问凭证支持重新生成。
重新生成后，需要使用最新访问凭证进行访问。
接入参数和注意事项由系统自动生成。

开放后的使用方式

开放后，外部 MCP 客户端可以直接使用当前知识库进行检索。
显示的名称和描述会带出当前知识库信息，便于识别检索来源。

日志记录

若开启日志记录，日志中会标识为 MCP 访问。

知识库