知识库是管理端的平台功能开关和内置知识库管理入口。你可以创建面向所有用户的内置知识库、添加共享资料，并控制其可用状态。

使用入口#

打开 管理端 → 知识库。页面分为两部分：

• 顶部的启用知识库开关，控制整个功能。
• 内置知识库表格，以及本地资料和新建按钮。

知识库有两种范围。内置知识库在这里创建，所有用户都可用。个人知识库由用户自行创建，不在本页管理。

开启或关闭功能#

使用启用知识库开关。

• 开启：对话中可以使用知识库，提示已开启知识库功能。
• 关闭：隐藏用户侧的知识库入口并拒绝相关请求，已有配置与数据保持不变，提示已关闭知识库功能，用户侧入口将隐藏。

开关写入平台设置 knowledgebase.enabled，不会删除任何知识库或资料。

新建或编辑内置知识库#

1. 点击新建。
2. 填写名称，必填，最多 80 个字符。
3. 填写说明，最多 255 个字符。
4. 点击保存。

新建的内置知识库默认启用。编辑时打开对应行，选择编辑知识库，或使用该行的更多操作菜单。修改名称或说明会同步影响所有用户的展示。

添加与管理资料#

1. 点击某个知识库行，打开详情。
2. 点击添加，打开添加资料。
3. 选择已有平台资料，或点击上传添加新文件。
4. 点击添加。

详情页会列出知识库中的资料及其大小和处理状态。在这里可以：

• 移出知识库：解除资料与知识库的关联，不删除文件。
• 勾选待向量化的文件，点击向量化。
• 对单个文件点击索引操作，执行向量化或更新过期索引。
• 使用标题栏的可用状态开关，启用或停用整个知识库。

内置知识库的添加资料弹窗列出的是平台资料，不是个人文件，说明为选择平台资料，或上传新文件至「{name}」。 单次最多选择 100 个文件。没有可复用的平台资料时，直接上传新文件即可继续。

管理本地资料#

本地资料是供内置知识库复用的平台文件，上传一次即可在多个知识库间共享。

1. 点击本地资料。
2. 使用搜索框查找资料。
3. 点击上传添加文件，单次最多 100 个。
4. 勾选后可批量删除，或用垃圾桶图标删除单个资料。

弹窗顶部显示资料总数，列表中展示每个文件的大小和处理状态。仍被知识库引用的平台资料无法删除，需要先从相关知识库中移出。列表可通过加载更多分页。

可用状态与状态含义#

内置知识库表格包含：

在知识库详情中使用可用状态开关可启用或停用。停用后资料和索引都保留，但不会提供给用户使用。

每个文件旁会显示处理状态，常见状态包括等待处理、排队中、提取中、正在 OCR、向量化中、已就绪、索引失败、索引待更新、无文本、处理失败。资料达到已就绪才可检索。更换 Embedding 模型或向量维度后，请在“文件与检索”页执行重建索引。

向量化资料#

向量化依赖“文件与检索”页中已开启并配置好的 Embedding 服务。

1. 打开某个知识库。
2. 勾选显示向量化或索引更新操作的文件，单次最多 100 个。
3. 点击向量化，或使用单文件的索引操作。

平台会提示已提交的文件数量。无需处理或当前不支持的文件会被跳过。全部无法提交时提示所选文件无需向量化或当前暂不支持；部分失败时会提示部分提交结果。

删除知识库#

• 删除单个：打开该行的更多操作菜单，选择删除知识库。如果知识库包含文件，可勾选同时删除文件。仍被其他资源引用的文件会保留。
• 删除多个：用复选框选中后点击删除所选知识库。

删除知识库无法撤销。批量删除时，部分失败会在提示中说明成功与失败数量。

参考#

知识库列表排序选项：默认顺序、最近更新、创建时间、名称、文件数量。

常见问题#

• 用户看不到知识库。 检查启用知识库开关，关闭后用户侧入口会被隐藏。
• 某个知识库没有提供给用户。 它的可用状态开关处于关闭。在详情中重新启用。
• 资料无法检索。 状态不是已就绪。执行向量化；若显示索引待更新，则重建索引。
• 平台资料删不掉。 它仍被知识库引用。先从相关知识库中移出。
• 上传或添加失败。 单次操作最多 100 个文件，减少选择数量，并检查“文件与检索”页的上传限制。
• 添加弹窗里没有文件。 暂无可复用的平台资料。在同一弹窗中直接上传新文件。

相关页面#

• 文件与检索
• 文件
• 会话配置