知识库
知识库组织授权文档，用于搜索、智能体知识增强、证据引用和 eBook 协作。知识库属于空间资源，与业务 Dataset 相互独立。
打开知识库模块
打开 控制台 → 知识库。列表会在可用时显示名称、分类、文件和容量统计、关联智能体、处理状态及更新时间。
创建知识库
1. 保存基本信息
- 选择创建知识库。
- 目标空间同时具备两种能力时，选择标准型或高级型。
- 填写名称、稳定标识符、描述和分类。
- 保存并获得知识库 ID。
只有先保存知识库，才能添加文件。
标识符创建后不可修改。目标空间具备所需权益时，标准型知识库可以升级为高级型；高级型知识库不能降级。
标准型与高级型知识库
| 能力 | 标准型 | 高级型 |
|---|---|---|
| 目录、文件、处理、搜索、智能体绑定和 eBook | 支持 | 支持 |
| 跨修订版本的稳定文档身份 | — | 支持 |
| 草稿、审核、现行、历史、废止生命周期 | — | 支持 |
| 资源访问策略和治理审计 | — | 支持 |
| 受控汇编和派生输出 | — | 支持 |
高级型可用性取决于目标空间所有者的订阅或权益，不能使用当前用户在其他空间中的权益代替。
2. 添加文件
保存后可以：
- 选择或拖放本地文件上传。
- 界面支持时拖入文件夹并保留层级。
- 从存储中选择已有文件。
- 添加文件前选择目标文件夹。
支持的格式以上传弹窗为准，通常包括文本、Markdown、PDF、Office、CSV 和 HTML。二进制 .doc 格式不能用于知识处理，请先转换为 .docx 或其他支持格式。
组织文件
编辑页包含基本信息、文件夹树和文件列表。可以创建目录、浏览层级、按文件名搜索、切换网格/列表视图，并选择多个文件执行允许的批量操作。
处理与关联状态
文件会经过不同阶段：
| 状态 | 含义 |
|---|---|
| 处理中 | 正在提取内容或建立索引 |
| 已处理 | 内容可以用于受支持检索 |
| 处理失败 | 提取或索引失败 |
| 待关联 | 等待与知识库建立关联 |
| 已关联 | 关联已经生效 |
| 关联失败 | 关联操作失败 |
只有文件完成处理并关联后，才测试智能体检索。重新上传失败文件前先查看错误详情。
内容就绪状态
对于受治理内容，内容就绪状态会把文件处理、制度纳管、发布和索引组合为一个用户可见状态。文件已经存在于知识库中，并不代表读者或智能体已经可以使用；它可能仍在等待纳管、发布或索引。重新上传前请先查看就绪原因。
高级制度治理
高级型知识库会区分稳定文档和各次修订。根据角色权限，修订可以处于以下状态：
| 状态 | 含义 |
|---|---|
| 草稿 | 正在准备，不能视为现行制度 |
| 审核中 | 等待配置的审核或批准 |
| 现行 | 默认用于阅读和检索的生效版本 |
| 历史 | 保留的早期版本 |
| 废止 | 已明确退出当前使用 |
生效日期和现行版本指针决定默认使用哪个修订。显式开启历史搜索后，结果会标识修订和生命周期状态；历史或废止版本不能当作现行制度。
高级型知识库还可以提供文档关系、审计历史、受治理派生物和汇编能力。具体可用范围取决于角色和部署配置。
搜索与证据
授权知识可以通过以下方式使用：
- 智能体知识检索
- eBook 搜索
- Knowledge Copilot
- 受支持的平台工具与 API
搜索结果可以包含指向来源文档和片段的证据引用。用户打开证据时会再次检查权限。
关联智能体
- 编辑对话型智能体。
- 打开知识库配置。
- 选择一个或多个授权知识库。
- 保存并测试有代表性的问题。
智能体检索相关片段，不会把每个文档全文都放入上下文。建议要求智能体提供证据，并在没有支持文档时明确说明。
在 eBook 中编辑知识
具有写权限的用户可以在 eBook 创建和编辑 Markdown 文档。草稿自动保存、发布、版本、对比、恢复、回收站和导出参阅 eBook 指南。
发布后的文档变更会按照知识生命周期进行检索处理。草稿发布并完成处理前，不应作为当前可检索制度使用。
权限
知识访问由空间、知识库成员/策略、文件生命周期和调用应用共同控制。将知识库绑定到智能体不会为用户授予原本没有的访问权限。
高级型知识库可以启用资源访问策略，对文档和组织范围进行更精细的授权。策略关闭时以空间 RBAC 为准；关闭策略只会暂停执行，并不表示已保存的策略定义被删除。
界面是否显示入口只用于改善体验。浏览、阅读、搜索、下载、编辑、发布、导出和打开证据时，平台都会再次校验权限。
运营建议
- 使用清晰的目录和文件名。
- 删除重复或过时制度。
- 可行时拆分主题混杂的超大文档。
- 替换文件后检查处理状态。
- 使用用户实际提问语言测试检索。
- 重要决策前核对引用证据。
故障排除
| 问题 | 处理方式 |
|---|---|
| 上传按钮不可用 | 先保存知识库 |
| 长时间等待处理 | 检查文件格式、大小、处理服务和任务状态 |
| 智能体找不到文档 | 检查处理、关联、智能体绑定、权限和问题表述 |
| eBook 无法打开证据 | 检查文件是否存在，以及用户是否仍有权限 |
| 语义检索提示 Embedding 失败 | 配置的模型网关恢复后重试；仍可直接浏览文件 |