概述
AI 看板是 Buddy 在数据分析模式下提供的核心能力之一：通过自然语言对话生成包含完整图表的 HTML 看板，支持多轮对话调整内容，满意后保存到「发布到 AI 看板」支持数据刷新。本文介绍如何通过 Buddy 生成 AI 看板、调整组件、保存与查看，以及通过溯源模式查看每个组件的数据依据。
前提条件
在开始本操作前，请确保满足以下条件：
已开通 DataBuddy 服务并完成空间初始化。
已切换到 Buddy 的 数据分析 模式。
已创建并选定一个分析空间，且空间内至少有 1 张数据表。详见 创建与管理分析空间。
（推荐）空间内已纳入指标模型，以保证生成的看板组件优先复用平台口径。
使用限制
限制项 | 说明 |
模式 | 仅在「数据分析」模式下可见与可生成。 |
数据来源 | 看板组件只能引用当前分析空间内的数据表与指标模型；Buddy 不会越过空间边界访问其他资产。 |
看板格式 | |
保存位置 | 保存后的 AI 看板出现在仪表盘列表页的AI 看板 Tab 下，与传统仪表盘并列展示。 |
操作步骤
步骤 1：进入 Buddy 并选择分析空间
1. 进入业务的 workspace。
2. 在左侧导航点击 Buddy ，并切换到 数据分析 模式。
3. 在左侧空间列表中选择一个分析空间。
步骤 2：发起看板生成请求
新建一个任务（或在当前会话中），在输入框中描述您要生成的看板，例如：
「根据空间中的零售订单数据集，帮我做一个零售销售分析看板。」
「根据前文的数据分析生成一个总结看板。」
「指定
hooke_table.z2_demo_ods.retail 数据集，生成销售看板。」说明：
您也可以在底部数据集选择器中点击 + 指定上下文>指定表 主动指定看板使用的数据集；如果不主动指定，Buddy 会根据您的描述自动判断使用空间内哪些数据。
步骤 3：观察生成进度
发送请求后，Buddy 会在对话流中展示一张可折叠的 任务执行中 进度卡片，逐步完成以下步骤：
步骤 | 典型内容 |
读取并分析数据集 | 解析字段结构，结合您的主题确定看板方向 |
构建看板标题与核心指标 | 生成页面标题与若干指标卡 |
构建可视化图表 | 逐个生成折线图、饼图、柱状图等 |
构建数据明细 | 生成明细表格 |
检查并优化所有组件 | 校验字段映射、调整布局、格式化数据展示 |
说明：
具体步骤由 Buddy 根据数据特征与您的需求动态判断，并非每次都完全相同。
进度卡片每一步显示三种状态：✓ 已完成（绿色对勾）、🔄 进行中（青色旋转动画）、⃝ 待执行（灰色数字）。点击任一步骤的展开箭头可以查看该步骤的详细执行说明。
步骤 4：在右侧面板查看生成结果
看板生成过程中，右侧预览区会实时 渲染当前已完成的部分。所有步骤完成后，右侧面板呈现完整看板，并在对话流中输出：
1. 完成摘要文字：例如「零售销售分析看板 已生成完毕，共包含 8 个组件，使用了 1 个数据源：」
2. 数据源清单：列出本次看板使用的所有数据集。
3. 组件清单：每行展示组件名、组件类型、数据来源标识。
步骤 5：通过多轮对话调整看板
如果您对结果不满意，直接在输入框继续输入修改请求即可。Buddy 仅更新目标组件，不会重新生成整个看板。
支持的修改类型包括：
修改类型 | 输入示例 |
修改图表类型 | 「把品类销售占比改成柱状图」 |
新增 / 删除组件 | 「新增一个本月环比柱状图」「删掉地区分布」 |
调整维度 / 指标 / 筛选条件 | 「销售趋势加上同比」 |
调整排序 / TOP N | 「商品排行只看 TOP 5」 |
Buddy 会按组件名或图表类型关键词匹配修改目标，并展示一张 2 步任务进度卡片：「识别修改目标 → 重新生成组件」。完成后右侧看板即时更新。
说明：
如果您输入的内容无法识别为针对当前看板的修改请求，Buddy 会把它视为一次全新的看板生成请求，重新走完整生成流程。
步骤 6：发布至 AI 看板
可以通过自然语言「保存这个看板」「把前面的整理成看板」「收藏下来」。也可在打开看板之后，在标题右侧选择「发布至 AI 看板」
保存时 Buddy 会：
1. 自动根据对话上下文为看板命名。
2. 固化看板内容：
HTML 看板渲染内容。
使用指标的组件 → 记录指标引用信息。
使用 SQL 的组件 → 记录 SQL 快照。
当前使用的数据集信息。
来源会话引用（后续可一键跳回）。
保存后看板出现在仪表盘页面的 AI 看板 Tab 下。
指标优先规则
说明：
核心原则 ：每个看板组件优先使用平台已注册的指标，仅当匹配不到时才降级使用 SQL 查询。
Buddy 在生成每个组件时按以下顺序决策：
1. 匹配指标 ：根据组件需要的度量（如「总销售额」），到指标平台查找是否已有注册指标。
2. 命中 → 使用指标 ：走指标引擎获取计算结果；看板中会展示指标名称和口径。
3. 未命中 → 降级 SQL ：Buddy 自动生成 SQL 查询数据；看板中标记为 SQL 数据源。
指标优先带来的好处：
看板数据与平台口径一致，避免同一指标在不同地方算出不同结果。
刷新时直接走指标引擎，数据更及时、更可靠。
用户在溯源模式下可以看到组件用了哪个指标、什么口径。
举例：
组件 | 指标平台是否有对应指标 | 结果 |
总销售额（指标卡） | 有 | 使用指标 |
总毛利润（指标卡） | 有 | 使用指标 |
逐月销售趋势（折线图） | 无 | 使用 SQL |
地区销售分布（柱状图） | 无 | 使用 SQL |
组件清单中数据来源标识：
使用指标的组件 ：显示分支图标、指标公式（如
SUM(pay_amount)）；鼠标悬浮显示指标名称、计算公式、口径说明、数据源。使用 SQL 的组件 ：显示
SQL 文字按钮；点击展开完整 SQL 代码块（深色背景），右上角支持复制。仪表盘列表页（AI 看板 Tab）
进入空间内二级导航 仪表盘 ，顶部提供两个一级 Tab：
Tab | 说明 |
仪表盘 | 传统 BI 仪表盘列表（手动创建 / 导入） |
AI 看板 | Buddy 对话生成并保存的 AI 看板列表 |
AI 看板 Tab 列表
筛选器：
搜索框 ：搜索 AI 看板。
来源筛选 ：全部、我创建的
通过 Buddy 创建 ：点击后跳转到 Buddy 新建任务。
表格列：
列名 | 说明 |
名称 | 看板名称 |
所有者 | Owner 显示「{用户名}（我）」，其他人显示用户 ID |
刷新策略 | 点击可以刷新当前 AI 看板数据 |
数据更新时间 | 相对时间；如果最近一次刷新失败，会额外显示黄色警告三角图标 |
操作 | Owner 显示更多菜单（刷新 / 分享 / 更多）；非 Owner 显示「刷新」链接 |
点击行可跳转到看板详情页。
看板详情页
详情页采用「顶栏、左右分栏」布局：左侧 HTML 看板预览，右侧元信息面板。
顶栏
元素 | 说明 | 可见性 |
返回 | 返回 AI 看板列表 | 所有人 |
看板图标 + 名称 | 看板名称加粗展示 | 所有人 |
数据更新时间 | 灰色小字，例如「数据更新: 2026/04/27 08:02:14」 | 所有人 |
溯源模式 | Toggle 按钮，详见下方「溯源模式」章节 | 所有人 |
分享 | 复制链接 | 管理权限 |
计算资源选择器 | 下拉选择交互式集群资源 | 所有人 |
刷新 | 触发手动刷新 | 所有人 |
查看原对话 | 跳转 Buddy 定位到该 AI 看板的对话中 | Owner |
删除 | 二次确认后删除 | 管理权限 |
说明：
非 Owner 进入详情页时，顶栏右侧仅显示预览、溯源模式开关和刷新按钮。其他操作（分享、删除）仅 Owner 可见。
右侧元信息面板
从上到下包含 5 个卡片：
1. 数据来源 ：展示看板使用的所有数据集，展示引用信息（如「引用 n 次」）。
2. 数据概览 ：组件数量、使用「N 个指标」+ 「N 个 SQL」统计，下方展示具体的指标和 SQL 情况。
3. 刷新策略 ：当前策略文字、编辑按钮，单击进入修改刷新策略弹窗。
4. 更新历史 ：
刷新成功：相对时间。
首次保存：相对时间。
刷新策略
Buddy AI 看板支持三种刷新策略：
策略 | 说明 |
不刷新（静态快照） | 保留保存时的数据，永远不会变。详情页没有 「立即刷新」按钮。 |
手动刷新 | 用户在列表或详情页点击「立即刷新」时才更新。 |
定时刷新 | 按预设时间自动刷新。 |
修改刷新策略
1. 在详情页右侧的刷新策略卡片中单击编辑。
2. 在弹窗中选择策略：不刷新 / 手动刷新 / 定时刷新 。
3. 当选择定时刷新时，从 6 个预设中选择，或选择自定义展开自定义配置：
预设 | 描述 |
每小时 | 每小时整点自动刷新 |
每天早上 | 每天 08:00 自动刷新 |
工作日 | 周一至周五 09:00 |
每周 | 每周一 09:00 自动刷新 |
每月 | 每月 1 号 08:00 |
自定义 | 设置每天的具体时间（如 08:00、20:00），不支持小时级 / 分钟级粒度 |
1. 弹窗底部会用蓝色背景给出自然语言预览，例如「将在每周一 09:00 自动刷新看板数据」。
2. 点击 确认 完成修改。
刷新执行逻辑
每次刷新时，Buddy 按组件逐一处理：
使用指标的组件：走指标引擎获取最新值。
使用 SQL 的组件：重新执行保存的 SQL 获取新数据。
全部组件刷新完成后，重新渲染 HTML 看板，并在「更新历史」中记录一条。失败时会显示红色错误原因。
溯源模式
说明：
溯源模式 让您查看每个图表、指标组件的数据来源、口径、SQL，是 AI 看板与传统仪表盘的关键差异化能力。
组件视觉变化
单击溯源 tab，有数据计算的组件鼠标变为手型，点击后从右侧滑出溯源信息抽屉；静态内容（标题、描述文字等）鼠标无变化，点击无响应。
溯源信息抽屉
点击组件后，从右侧滑出抽屉，按以下顺序展示有内容的板块 （无内容板块不显示）：
板块 | 内容 |
指标口径 | 指标名 + 类型标签（基础 / 过滤 / 派生 / 占比 / 累积 / 转化）、英文标识、计算公式、口径说明、时间维度、筛选条件 |
使用维度 | 维度字段名 + 类型标签（时间 / 分类 / 字典）、聚合粒度（如「月」） |
语义模型 | 模型名称、源表 Catalog 路径 |
数据来源 | 表名、使用字段、关联关系（多表 JOIN 时） |
SQL 语句 | 仅使用 SQL 的组件显示，右上角可一键复制 |
执行信息 | 返回行数、执行耗时 |
说明：
切换到预览模式后，看板恢复正常展示，提示条消失。
查看原对话
看板详情页右侧···>查看原对话，仅该仪表盘的 owner 支持点击，点击后跳回 Buddy 中原对话页面，所有历史消息完整恢复，您可以继续追问与调整看板。
空间隔离
每个分析空间的 AI 看板列表相互独立：不同空间看不到对方的看板。这与分析空间「精准上下文」的设计一致：每个业务团队基于自己的空间维护自己的看板集合。
验证结果
操作完成后，您可以通过以下方式确认：
1. 在 Buddy 对话流中能看到点击产物打开该看板。
2. 进入仪表盘列表页，切换到 AI 看板 Tab，能看到刚保存的看板，所有者、刷新策略、数据更新时间展示正确。
3. 进入看板详情页，HTML 看板正常渲染；右侧元信息面板的数据集、组件统计、刷新策略均符合预期。
4. 开启溯源模式后，指标组件能正确弹出指标口径与维度信息；SQL 组件能弹出完整 SQL。
5. 修改刷新策略后，到了预设时间看板会自动刷新，更新历史中会出现新的成功记录。
常见问题
Q：生成的看板中某个图表用错了字段，怎么纠正？
A：直接在对话框中描述要修改的内容，例如：品类销售占比应该使用 category_name 而不是 category_id 作为分组。Buddy 会识别出目标组件并仅重新生成该组件，不会推翻整个看板。
Q：保存后的 AI 看板可以再放回 Buddy 中继续聊吗？
A：可以。在 AI 看板详情页顶部右侧的···>查看原对话，点击 查看原对话 即可跳回原对话，所有历史消息和上下文完整恢复，可以继续多轮对话调整。
Q：定时刷新失败了在哪里看？
A：在看板详情页右侧元信息面板的更新历史卡片中查看。失败的记录会显示红色 ❌ 状态与错误原因；同时列表页该看板「数据更新时间」列会出现黄色警告三角图标。
Q：分享给同事的看板，对方进来后看不到部分组件的数据，是为什么？
相关文档
创建仪表盘与布局
发布与分享
