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