知识库
知识库把分散的业务资料整理为可持续维护、可在 Agent 对话中使用的知识资产。
适用对象：数据分析师、运营人员、数据中台人员、知识内容维护者和技术支持人员。入口位于「能力中心 → 知识库」。
1. 知识库能解决什么问题
知识库用于统一管理企业内部知识与业务资料，并将原始文件或在线文档整理为便于检索和阅读的知识目录与 Wiki 页面。它适合沉淀产品规则、业务方法、项目资料、操作规范和支持文档。
使用知识库可以获得三方面价值：
- 统一沉淀：把文件、飞书文档和网页资料集中到同一知识空间。
- 结构化使用：将来源资料编译为知识目录和 Wiki 页面，降低查找成本。
- 支持业务对话：系统可在 Agent 对话中自动发现并使用合适的知识库，让回答结合已有业务资料。
1.1 什么时候使用知识库
需要让 Agent 查询产品规则、业务口径、项目背景或支持资料时，使用知识库。需要维护某个工作空间的长期约定和背景时，使用空间记忆；需要把稳定的操作方法整理成可复用流程时，使用Skill。三者可以配合使用。
知识库不是临时附件。基本流程是：创建知识库 → 添加来源资料 → 准备编译准则 → 编译发布 → 在对话中使用并持续维护。来源变化后，需要重新编译，更新内容才会进入新的已发布知识。
1.2 选择知识库类型
| 类型 | 适用场景 | 操作与权限 |
|---|---|---|
| 系统知识库 | 使用平台预置的知识内容 | 不能自行修改来源或编译；部分内容仅允许在 Agent 对话中使用，不能打开详情 |
| 公司知识库 | 团队共同使用和维护业务知识 | 由公司资源管理员创建，按成员角色控制访问与维护；不是全公司默认可见 |
| 个人知识库 | 沉淀个人常用资料，先验证再按需发布到公司 | 由个人管理，可关联业务范围并用于对话 |
普通知识库与只读快照：普通个人、公司知识库可按权限维护来源和编译；导入的已编译快照用于直接阅读和对话，不支持编辑知识正文、维护源文件或准则，也不能再次编译。两种方式不要混淆。
2. 创建知识库并添加资料
2.1 创建知识库
- 进入「能力中心 → 知识库」，选择「个人知识库」或「公司知识库」。创建公司知识库需要公司资源管理权限。
- 填写知识库名称，并按需补充关联范围、标签和描述。
- 保存后进入详情页，在「源文件」中添加资料。
填写规则：名称必填，不超过 30 个字符；最多添加 2 个标签，每个标签不超过 15 个字符；描述不超过 200 个字符。项目、社区空间、数开空间等关联范围为可选项，用于帮助识别业务场景和推荐资料，不会授予访问权限。
2.2 添加原始资料
在「源文件」中，根据资料形式选择上传文件或添加 URL：
- 上传文件：支持 Markdown、TXT、CSV、PDF、Word、Excel、PPT 和常见图片格式，单个文件不超过 50MB，可以一次选择多个文件。
- 上传 ZIP 目录：可将多份资料按目录打包为 ZIP 上传，作为目录来源管理；单个 ZIP 不超过 50MB。这仍是原始资料，需要编译后才能成为可用知识。
- 添加 URL：支持飞书或 Lark 云文档、知识库链接，以及其他可访问网页。可填写显示名；其他网页还可以补充解析说明。
添加 URL 前可执行「连通测试」。飞书来源需要环境已完成 Lark-CLI 集成，并具备相应文档访问授权；安装工具不等于获得访问权限。飞书知识库链接会按来源能力解析其子文档或子页面，仍须具备对应访问权限。
上传完成后先核对来源列表和状态。同名上传不能直接覆盖已有来源，即使原来源尚未编译，也应在具体来源行使用替换操作，查看影响后再确认。
2.3 导入已编译快照
已有编译好的知识包时，可以在知识库列表选择「导入快照」；有公司资源管理权限的用户也可选择「导入公司快照」。填写名称等信息，上传不超过 50MB 的 ZIP，提交后等待导入完成。
快照包应包含知识目录文件 index.md 和 wiki/ 下至少一个 Markdown 页面；不要将普通原始资料压缩包作为已编译快照导入。导入成功后得到只读知识库，可以直接阅读和在对话中使用，无需再次编译。导入尚未完成或结果不明确时，先查看任务状态，不要重复提交。
3. 生成或导入准则并编译
编译准则规定系统如何组织当前知识库的资料。普通知识库需要先准备有效准则，再将来源编译为知识目录和 Wiki 页面；只读快照不适用以下操作。
3.1 准备编译准则
由系统生成：在「源文件」中点击自动编译；还没有准则时，先选择模型并开始生成。任务可以转到后台，完成后进入「编译准则」查看内容，确认组织方式是否符合业务需要。
导入已有准则：在「编译准则」中选择「导入准则」，上传不超过 256KB 的 Markdown（.md）文件。上传只保存待处理稿并执行程序校验，不会调用 AI，也不会立即替换正式准则。
- 查看校验结果，按需编辑正文；也可以选择「AI 检验」或「AI 修复」，这两项会调用模型并消耗 Token。
- 程序校验通过且没有进行中的任务后，进入「预览并应用」，检查全文、与正式准则的差异以及建议项。AI 检验不是应用的强制前提。
- 确认后选择「确认替换正式准则」。关闭窗口会保留已保存稿件和后台任务，但应用准则不会自动编译，现有 Wiki 需要重新编译后才采用新准则。
3.2 选择编译方式
| 方式 | 适用情况 | 处理方式 |
|---|---|---|
| 增量编译 | 新增、替换或删除少量来源 | 处理待编译、失败或已变化的内容，在现有知识结果基础上新增、更新或清理相关页面 |
| 全量编译 | 资料结构变化较大，或希望重新整理整个知识库 | 重新处理全部可用来源，发布新的 Wiki 结果 |
启动后可以查看状态和执行进度，也可以让任务转到后台。不要重复发起编译；编译、准则生成或发布核对期间，部分资料修改操作会暂时不可用。
3.3 查看结果与用量
编译后，在「知识目录」查看整体结构，在「Wiki 页面」浏览和搜索具体内容；有相应权限时，可在「源文件」检查来源状态、在「编译准则」查看组织规则、在「编译用量」查看准则生成与编译的 Token 消耗。
任务结束不一定代表全部资料完成：若显示部分发布或部分来源未完成，查看错误详情、已发布页面、复用旧版页面和本次未完成内容，再处理对应来源。更新失败时，上次成功发布的内容仍可继续使用，待更新内容会保留；取消编译不会将未完成结果发布为新知识。
4. 在 Agent、空间和会话中使用
在 Agent 中配置：希望某个 Agent 优先使用固定业务资料时，可在其能力配置中选择有权使用的知识库。具体配置入口见Agent。
在工作空间中配置：希望空间会话使用共同的资料入口时，可由有权限的成员在空间能力设置中配置知识库。共享空间的公共知识库限系统和公司类型；配置不会代替知识库授权，成员使用时仍需通过各自的权限校验。空间能力设置见新建空间。
在会话中提问：直接描述问题，并尽量写明业务主题、知识库名称或资料范围。系统可按问题自动发现有权使用的相关知识库，无需每次预先勾选；也可在会话中手动选择知识库，当前单个会话最多手动选择 10 个。选择与提问操作见会话。
手动选择表示优先检索，不是排他边界：选中的资料与问题相关时会被优先使用，但不会排除其他已授权、与当前问题相关的信息。如果希望回答仅依据指定资料，应在问题中明确要求，并要求说明缺失信息。
可信使用原则：当回答使用知识库内容时，关键结论应由实际读取的页面正文直接支持。目录、标题、标签和未展开页面的摘要只用于导航；资料没有说明的部分，应明确指出信息缺口。部分受保护知识仅允许按规定在对话中使用，不代表可以查看或导出全文。
5. 协作权限与发布到公司
5.1 按职责分配权限
公司知识库通过「分享」添加成员并分配角色。普通可编译知识库的主要权限如下：
| 角色 | 主要权限 |
|---|---|
| 所有者（Owner） | 管理设置、知识内容、来源、准则、编译和成员，也可删除知识库或移交所有权 |
| 管理员（Admin） | 管理设置、知识内容、来源、准则、编译和成员；仅凭该角色不能删除知识库或移交所有权 |
| 协作者 | 查看并维护知识内容与来源；不能管理成员、准则或发起编译 |
| 查看者 | 浏览知识目录和 Wiki 页面并在对话中使用；不能查看源文件、准则或修改内容 |
| Agent Only | 仅在 Agent 对话中使用知识库，不能打开详情或管理内容 |
公司资源管理员是另一层权限：具有公司资源管理权限的管理员可以管理本公司的公司知识库，包括删除和移交，不受上表库内 Admin 的限制。空间的 Owner 或管理员身份不等于公司资源管理权限，也不会自动获得知识库管理权限。
只读快照的内容、来源、准则和编译操作仍不可编辑；有相应权限时可以维护名称等设置，公司快照也可管理成员和移交所有权。个人知识库当前不提供公司知识库式的「分享」和所有权移交入口。
需要交接公司知识库时，由有权移交的人员选择新的所有者并确认。平时按最小权限原则分配角色，及时移除不再需要访问的成员；看不到某个页签或按钮时，先核对角色、知识库类型和任务状态。
5.2 将个人知识库发布到公司
普通个人知识库完成编译后，可以提交到公司，供团队按权限使用。导入的只读快照不支持这条发布流程。
- 在个人知识库卡片中选择提交到公司。
- 填写公司知识库名称和申请理由。名称不超过 30 个字符，理由不超过 80 个字符。
- 提交后等待审批；审批通过后还需要完成公司副本发布。关注「发布中」「已发布」或「发布失败」等状态，不能把审批通过直接视为发布完成。
- 发布成功后，打开公司知识库核对内容与访问权限，再用于团队协作。
发布以审批通过时复制的最新内容为准，产生独立的公司知识库，不会把个人知识库直接改为公司知识库；此后修改个人库不会自动同步到公司副本。原个人库的所有者也不一定自动成为公司副本的所有者，公司副本仍按公司资源管理和成员权限规则治理。
6. 更新资料、版本恢复与常见问题
6.1 更新来源并确认影响
- 在「源文件」找到要更新的具体来源行，选择「替换文件」或「替换 ZIP」。普通文件的替换格式须与原来源一致，不能改用 ZIP 替换普通文件。
- 选择新文件，点击「查看影响预览」，核对新增、修改、删除、不变的文件和未发布差异。
- 确认无误后写入当前草稿，再执行增量或全量编译，检查发布结果。
替换 ZIP 会完整替换当前文件树：新包没有包含的文件会删除，包括尚未发布的手工新增文件。修改或恢复来源只影响当前草稿，不会立即改变已发布知识。来源删除也需要编译发布，才能体现在新的知识结果中。
URL 来源在显示编辑入口时，可修改链接、显示名及适用的解析说明；已编译或正在编译的来源不显示此入口。定期核对在线资料和访问授权，资料变化后重新编译；不要把“原网页已经更新”当作“知识库已经发布新内容”。操作提示预览过期时，应刷新来源后重新预览；提交结果不明确时先核对状态，不要盲目重试。
6.2 查看版本并选择恢复方式
普通个人、公司知识库可在「版本历史」查看成功发布的版本，并比较来源变化。首次成功编译后产生首个版本；系统知识库和只读快照不提供这套版本操作。历史来源的查看和恢复仍受角色权限控制，未发布的中间草稿不是完整历史备份。
只恢复某个来源：可使用「恢复最新已发布版本」，或从成功版本中选择可恢复的文件、目录来源。先核对影响，再确认恢复为当前草稿；恢复后不会自动编译。当前来源必须仍存在且类型兼容，URL 来源不支持这种来源级恢复。
回滚整个知识库：有来源维护和编译权限时，在版本历史选择「回滚到此版本」，核对影响并确认。回滚使用目标版本的完整 Wiki、编译准则和来源，发布为一个新版本，而不是删除后续历史。
整库回滚会覆盖目标版本内来源的当前内容及未发布修改；目标版本之外、曾成功编译的来源将被标记删除；从未成功编译的新增来源会保留。执行前确认这些影响，等待任务完成；提示需要管理员核对时，不要重复回滚。
6.3 常见问题
为什么找不到或无法使用某个知识库？先确认账号是否有权访问、知识库是否已有可用的已发布内容，再检查 Agent 或空间配置。业务范围关联、加入工作空间和收到知识库链接都不等于获得授权。
为什么已上传或修改资料，回答还是旧内容？检查是否仅更新了来源草稿或正式准则，以及编译是否成功发布。更新失败、部分发布或复用旧版页面时，应查看来源原因和发布结果，不能只看任务是否结束。
为什么没有源文件、准则或编译按钮？核对成员角色以及是否为系统知识库或只读快照；有权限但操作暂不可用时，再检查编译、准则生成、审批发布或待核对状态。
编译失败后怎么办？查看错误详情，先排查来源能否读取、授权是否有效、准则是否通过校验，再处理失败来源并重新编译。结合「编译用量」确认模型消耗；若结果待核对，联系管理员确认后再操作。