一、概述
知识库分为两类：
| 类别 | 来源 | 维护方 |
| 内置知识库 | 表元数据、字段元数据（含枚举值）、指标元数据、血缘关系 | 平台自动维护，无需用户操作 |
| 外部知识库 | 业务术语、业务规则、口径文档、规范文档、报告模板等 | 由你手动创建并上传文档 |
这篇聚焦外部知识库的创建、维护与使用。
二、使用限制
| 限制项 | 说明 |
| 文件类型 | 上传支持任意格式；可被学习为知识的格式：PDF、Markdown、TXT、Word/DOCX、Excel/CSV、JSON、HTML、SQL、图片 |
| 单文件大小 | 不超过 5 GB |
| 单次上传文件数 | 不超过 100 个 |
| 知识库名称 | 最长 50 字符 |
| 知识库描述 | 最长 1024 字符 |
| 业务文本（数据分析） | 最长 3000 字符 |
| 手动录入文档名称 | 最长 50 字符 |
| 手动录入文档长度 | 最多 10,000 字 |
三、模式与可见性
知识库的可见范围与列表内容随当前模式而变化：
| 当前模式 | 列表展示内容 | 入口 |
| 数据工程 / 数据治理模式 | 仅展示 数据工程 / 数据治理 类型的知识库 | 左侧导航的「知识库」 |
| 数据分析模式 | 仅展示当前分析空间内的知识库及其知识详情页 | 左侧导航的「知识库」（进入空间后） |
数据分析模式下的知识库仅服务于当前分析空间，不能跨分析空间引用。
五、步骤 1：创建知识库
1. 在 Buddy 左侧导航栏选择 知识库。
2. 在右上角点击 + 创建知识库。
3. 在弹窗中填写以下信息：
·知识库名称（必填）：建议使用具有业务含义的名称，例如「GMV 指标异常检测规则」。
·描述（选填）：简要说明用途。
4. 点击 创建。新建的知识库会出现在列表中，初始无文档、无描述。
六、步骤 2：添加知识文档
打开知识库右侧详情侧边栏，点击底部 + 添加知识 按钮，弹窗顶部支持四种来源切换：
| 来源 | 适用场景 | 行为 |
| 手动录入 | 没有现成文件，直接输入或粘贴知识内容 | 输入文档名称与 Markdown 内容，自动进入学习流程 |
| 从本地上传 | 直接上传本地文件 | 文件以卷的方式存储到 Catalog 知识目录中，自动进入学习流程 |
| 从 Catalog 选择 | 复用已存放在 Catalog 卷目录的文件 | 仅可选择文件卷下的文件，按文件勾选 |
| 从 Studio 选择 | 复用 Studio 中的开发产物文件 | 仅可选 SQL、Markdown、HTML、JSON 文件 |
七、手动录入
当没有现成文件时，可直接输入或粘贴知识内容：
1. 切换到 手动录入 Tab。
2. 填写 文档名称（必填，最长 50 字符）。
3. 在 内容 输入框中输入或粘贴知识内容，支持 Markdown 格式，最多 10,000 字。
4. 点击 确认，系统自动进入学习与描述生成流程，与其他文档类型一致。
手动录入的知识文档在列表中类型显示为 md、来源显示为 手动录入，支持查看、重新学习、删除等操作。
八、从本地上传
1. 切换到 从本地上传 Tab。
2. 点击 选择文件 或将文件拖入虚线框区域。
3. 在弹窗下方设置：
·同名处理：选择 自动重命名 或 替换现有文件。
·目标路径：选择保存到 Catalog 哪个卷目录。
4. 点击 上传。文件出现在知识文档列表中，状态进入 学习中。
九、从 Catalog 选择
1. 切换到 从 Catalog 选择 Tab。
2. 在三级树形结构（Catalog → Schema → File）中通过复选框勾选目标文件，支持目录级全选、半选。
3. 右侧「已选择(N)」列表中可逐项移除。
4. 点击 确认 完成接入。
十、从 Studio 选择
1. 切换到 从 Studio 选择 Tab。
2. 浏览 Studio 文件目录，勾选需要的文件。
3. 点击 确认，文件自动触发学习流程。
注意：从 Studio 接入的知识文件与 Studio 源文件保持双向同步：源文件被修改时知识库会提示需要重新学习；源文件被删除时知识文件也会被删除并提示用户。
十一、步骤 3：从产物快速沉淀
Buddy 在对话中生成的产物（SQL、Markdown、HTML、JSON）可一键沉淀为知识：
1. 在对话产物详情页右上角点击 更多 > 作为知识学习。
2. 根据当前模式确认：
·数据分析模式：直接学习到当前分析空间的默认知识库，提示「已成功录入知识库」。
·数据工程、数据治理模式：弹窗中选择目标知识库（支持多选），点击 确定 后提示「已成功录入知识库」。
十二、对话后主动沉淀知识
除手动点击「作为知识学习」外，Buddy 还会在对话中主动识别值得沉淀的内容并反问你是否入库：
| 触发强度 | 触发条件 |
| 强触发（主动反问） | 产出了结构化结论，如口径确认、归因完成、报错修复、SOP 成型 |
| 中触发（弱提示） | 你明确认可 AI 结论，或同一主题深入交流 ≥5 轮 |
触发后，Buddy 按内容类型分别沉淀：
| 内容类型 | 沉淀方式 |
| 规则 | 写入「业务逻辑」全局提示词，每次提问自动注入 |
| 结论 / 洞察 | 独立知识文档（Markdown），语义检索召回 |
| 方法 / SOP | 方法类知识文档，语义检索召回 |
AI 将对话内容整理为知识文档（自动命名并撰写内容），生成后提示你检查；确认无误后回复「学习」或点击产物中的学习按钮，即可沉淀到知识库。
十三、步骤 4：通过自然语言批量导入
你可以直接在对话框中用自然语言批量创建知识：
帮我把 demo_volume.knowledge.file 中的文件都上传到「业务术语库」
Buddy 解析指令时若信息不全（如目标知识库未指定），会通过 Ask User 卡片反问。校验通过后批量执行：
| 模式 | 校验项 |
| 数据工程 / 数据治理 | 是否有知识库创建/编辑权限；是否有目标 Catalog / Studio 访问权限 |
| 数据分析 | 是否有当前分析空间的知识库创建/编辑权限；是否有目标 Catalog / Studio 访问权限；不允许跨分析空间创建 |
执行结束后，Buddy 在对话中返回一个学习结果卡片，列出每个文件的目标知识库、类型与学习状态。
十四、步骤 5：维护文档与摘要
知识库右侧详情侧边栏的 知识文档列表 区域支持以下操作：
| 操作 | 说明 |
| 查看 | 打开文档预览/编辑界面，按来源跳转或在线预览，详见下方「查看文档」。 |
| 重新读取 | 单文档或勾选后批量。学习中状态下按钮置灰。 |
| 删除 | 单文档或勾选后批量。批量删除二次确认。 |
| AI 重新生成摘要 | 对单文档触发 AI 摘要重新生成。 |
| 编辑摘要 | 切换为编辑框，最长 300 字。 |
十五、查看文档
点击文档的 查看 操作后，行为随文档来源不同：
| 来源 | 查看行为 |
| 手动录入 | 支持预览和编辑 |
| 本地上传 | 进入预览界面，Studio 支持的格式可在线编辑，其余格式仅预览 |
| 从 Catalog 选择 | 跳转到对应的数据目录，能否下载需校验数据目录权限 |
| 从 Studio 选择 | 跳转到对应的任务开发目录，能否下载、编辑需校验任务开发权限 |
本地上传文件在线查看支持的格式：
| 格式 | 查看支持 |
| Markdown、TXT、SQL、HTML、JSON | 支持预览和编辑 |
| PDF、图片 | 支持下载查看 |
| Excel/CSV、Word/DOCX | 支持下载查看 |
查看界面支持快速切换文档与返回，以及保存、刷新、编辑操作（与 Studio 一致）。
学习状态包含三种：
| 状态 | 标识 | 行为 |
| 学习完成 | 绿色对勾 | 可被检索；摘要可用 |
| 学习中 | 蓝色「学习中」+ 旋转动画 | 重新读取与编辑摘要按钮置灰 |
| 学习失败 | 红色「学习失败」 | 鼠标悬停展示失败原因；可点击 重新读取 重试 |
十六、步骤 6：维护知识库描述
在详情侧边栏顶部的「描述」区域：
·点击 AI 生成 按钮：基于知识文档内容自动生成一段描述（约 2 秒完成）。
·点击 编辑 按钮：手动编辑，最长 1024 字，必须保存后才能继续其他操作。
十七、步骤 7：维护业务文本（仅数据分析模式）
在分析空间的知识库详情页，业务文本 区块用于补充简短的业务规则与隐含约定，系统会以 system prompt 方式注入给模型，每次对话自动生效，例如：
– 如果问题中未标明时间范围，默认取当年数据。- 涉及金额的指标默认单位为「元」，除非标注「万元」或「美元」。- 当查询未指定地域时，默认统计全部地域（含海外）。
业务文本支持 Markdown 格式，最长 3000 字符。点击 编辑 > 修改 > 保存 即可更新。
十八、在对话中使用知识库
Buddy 在以下两种方式下使用知识库：
| 方式 | 说明 |
| 自动检索 | Buddy 在处理业务任务时，会自动判断是否需要检索知识库（命中相关 Skill，或任务隐含对业务规则、口径、SOP 的依赖），从可见知识库召回相关内容，并与通用知识融合后回答 |
| 显式引用 | 通过 Agent 基础能力 在对话中精确指定某个知识文件，仅基于该文件回答 |
Buddy 在思考过程中会展示「检索知识库」的工具调用状态，并在最终回答中标识所使用的知识来源。
十九、权限说明
| 模式 | 权限继承 | 管理员/编辑者 | 查看者 | 无权限 |
| 数据工程 / 数据治理 | Workspace 权限 | 增删改查 | 仅查看 | 隐藏入口 |
| 数据分析 | 分析空间权限 | 增删改查 | 仅查看 | 隐藏入口 |
20、验证结果
完成上述操作后，你可以通过以下方式确认：
1. 知识库列表卡片显示更新后的文件数量、浏览量、使用次数。
2. 在对话中提问与知识文档相关的问题，Buddy 在思考过程展示「检索知识库」工具调用，回答中体现来源文档。
3. 在 Agent 基础能力 浮窗中，知识文件 类型下可看到刚上传的文件。
22、Q：上传后文档一直处于「学习中」状态怎么办？
学习耗时与文档大小、类型相关。如果长时间未完成或转为「学习失败」，将鼠标悬停在状态标签查看失败原因，并尝试 重新读取。
23、Q：删除知识库会同步删除 Catalog 中的源文件吗？
不会删除 Catalog 中的源文件。删除知识文档仅解除知识库与文件的绑定。
24、Q：从 Studio 接入的文件被修改了，需要做什么？
Studio 文件被修改时，知识库会提示该知识需要重新学习；点击 重新读取 即可。
25、Q：业务文本和知识文档有什么区别？
业务文本是数据分析模式独有的轻量级补充，适合写隐含约定与默认值；知识文档适合较长、结构化的业务规则与文档。两者会同时被检索。
26、相关文档
·Agent 基础能力概述
·Agent 基础能力
·成员与权限管理