概述
AI 看板是 Buddy 分析工作台中提供的核心能力之一：通过自然语言对话生成包含完整图表的 HTML 看板，支持多轮对话调整内容，发布后可配置数据刷新、分享给工作空间内成员、生成免登录公开链接，或嵌入到第三方系统。本文介绍如何生成与调整 AI 看板、发布与刷新、配置分享与嵌出，以及通过溯源模式查看每个组件的数据依据。
前提条件
在开始本操作前，请确保满足以下条件：
已开通 DataBuddy 服务并完成空间初始化。
已通过 Buddy 左下角切换到 分析工作台。
已创建分析智能体，并保证其中至少有 1 张数据表。
（推荐）空间内已纳入指标模型，以保证生成的看板组件优先复用平台口径。
如需嵌出到第三方系统，请先发布该看板，且工作空间管理员已在安全管理中开启嵌出并配置批准的域名。
如需生成免登录公开链接，需工作空间管理员允许对外公开分享。
使用限制
限制项 | 说明 |
模式 | 仅在分析工作台中可见与可生成。 |
数据来源 | 看板组件只能引用当前分析智能体内的数据表与指标模型；Buddy 不会越过其边界访问其他资产。 |
看板格式 | |
保存位置 | 保存后的 AI 看板出现在仪表盘列表页的 AI 看板 Tab 下，与传统仪表盘并列展示。 |
分享 | 公开访问默认关闭，需工作空间管理员权限开启或关闭。 |
嵌出 | 必须先发布看板，且由工作空间管理员开启嵌出并配置批准的域名。 |
公开链接访客 | 不能查看溯源与 SQL、不能编辑或导出、不能二次分享。 |
操作步骤
步骤 1：进入 Buddy 分析工作台并选择分析智能体
1. 进入业务的 Workspace。
2. 在左侧导航点击 Buddy ，并通过左下角切换到 分析工作台。
步骤 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 |
刷新策略 | 展示具体的刷新策略，如手动刷新 |
数据更新时间 | 相对时间；如果最近一次刷新失败，会额外显示黄色警告三角图标 |
操作 | Owner 显示更多菜单（刷新、分享、更多）；非 Owner 显示「刷新」链接。点击 分享 可打开分享弹窗 |
点击行可跳转到看板详情页。
看板详情页
详情页采用「顶栏、左右分栏」布局：左侧 HTML 看板预览，右侧元信息面板。
顶栏
元素 | 说明 | 可见性 |
返回 | 返回 AI 看板列表 | 所有人 |
看板图标 + 名称 | 看板名称加粗展示 | 所有人 |
数据更新时间 | 展示刷新时间，例如「数据更新: 2026/04/27 08:02:14」 | 所有人 |
编辑 | 拥有编辑以上权限支持编辑 AI 看板的样式 | 已授权角色 |
预览 | 展示该 AI 看板的预览效果 | 所有人 |
溯源模式 | 详见下方「溯源模式」章节 | 所有人 |
分享 | 打开分享弹窗：配置权限、复制链接、公开链接分享、获取嵌出代码 | 已授权角色 |
计算资源选择器 | 下拉选择交互式集群资源 | 所有人 |
刷新 | 触发手动刷新 | 所有人 |
···更多
元素 | 说明 | 可见性 |
查看原对话 | 跳转 Buddy 定位到该 AI 看板的对话中 | Owner |
删除 | 二次确认后删除 | 管理权限 |
说明：
非所有者进入详情页时，顶栏右侧仅显示预览、溯源模式开关和刷新按钮。配置公开分享、嵌出代码、删除等操作仅所有者、可管理角色可用，匿名访客只能查看看板内容与图表。
右侧元信息面板
从上到下包含 4个卡片：
1. 数据来源 ：展示看板使用的所有数据集，展示引用信息（如「引用 n 次」）。
2. 数据概览 ：组件数量、使用「N 个指标」+ 「N 个 SQL」统计，下方展示具体的指标和 SQL 情况。
3. 刷新策略 ：当前策略文字、编辑按钮，单击进入修改刷新策略 弹窗。
4. 更新历史 ：
刷新成功：相对时间。
首次保存：相对时间。
刷新策略
Buddy AI 看板支持三种刷新策略：
策略 | 说明 |
不刷新（静态快照） | 保留保存时的数据，永远不会变。详情页没有 「立即刷新」按钮。 |
手动刷新 | 用户在列表或详情页点击「立即刷新」时才更新。 |
定时刷新 | 按预设时间自动刷新。 |
修改刷新策略
1. 在详情页右侧的刷新策略 卡片中单击编辑 。
2. 在弹窗中选择策略：不刷新 / 手动刷新 / 定时刷新 。
3. 当选择定时刷新 时，从 5个预设中选择，或选择自定义 展开自定义配置：
预设 | 描述 |
每小时 | 每小时整点自动刷新 |
每天早上 | 每天 08:00 自动刷新 |
工作日 | 周一至周五 09:00 |
每周 | 每周一 09:00 自动刷新 |
每月 | 每月 1 号 08:00 |
自定义 | 设置每天的具体时间（如 08:00、20:00），不支持小时级 / 分钟级粒度 |
1. 弹窗底部会用蓝色背景给出自然语言预览，例如「将在每周一 09:00 自动刷新看板数据」。
2. 点击 确认 完成修改。
刷新执行逻辑
每次刷新时，Buddy 按组件逐一处理：
使用指标的组件：走指标引擎获取最新值。
使用 SQL 的组件：重新执行保存的 SQL 获取新数据。
全部组件刷新完成后，重新渲染 HTML 看板，并在「更新历史」中记录一条。失败时会显示红色错误原因。
溯源模式
说明：
溯源模式 让您查看每个图表、指标组件的数据来源、口径、SQL，是 AI 看板与传统仪表盘的关键差异化能力。
组件视觉变化
单击溯源 tab，点击溯源 icon 后从右侧滑出溯源信息抽屉；静态内容（标题、描述文字等），点击无响应。
溯源信息抽屉
点击组件上的溯源 icon，从右侧滑出抽屉，按以下顺序展示有内容的板块 （无内容板块不显示）：
板块 | 内容 |
指标口径 | 指标名 + 类型标签（基础 / 过滤 / 派生 / 占比 / 累积 / 转化）、英文标识、计算公式、口径说明、时间维度、筛选条件 |
使用维度 | 维度字段名 + 类型标签（时间 / 分类 / 字典）、聚合粒度（如「月」） |
语义模型 | 模型名称、源表 Catalog 路径 |
数据来源 | 表名、使用字段、关联关系（多表 JOIN 时） |
SQL 语句 | 仅使用 SQL 的组件显示，右上角可一键复制 |
执行信息 | 返回行数、执行耗时 |
说明：
切换到预览模式后，看板恢复正常展示，溯源标志消失。
分享 AI 看板
通过 分享 弹窗，您可以把 AI 看板授权给工作空间内的用户、用户组，或生成免登录公开链接供外部人员查看。两种方式在同一个弹窗内，通过 邀请企业成员加入 与 通过公开链接加入 两个页签切换。
分享方式 | 面向对象 | 是否需要账号 | 权限粒度 | 典型场景 |
授权访问 | 工作空间内用户、用户组 | 需要 | 可管理、可编辑、可查看 | 团队内部协作、跨成员共享 |
公开访问 | 任意持有链接的人 | 不需要 | 仅查看（免登录只读） | 对外汇报、发给外部客户或合作方查看 |
说明：
公开访问默认关闭，需要工作空间管理员才有权限进行开启和关闭。
打开分享弹窗
以下入口均可打开 分享 弹窗：
入口 | 操作 |
仪表盘列表页 AI 看板 Tab | 点击看板操作列的 分享 |
看板详情页顶栏 | 点击 分享 |
配置授权访问
1. 在 搜索用户/用户组 输入框中搜索当前工作空间内的用户或用户组，点击 添加 将其加入访问列表并赋予默认角色。
2. 在 以下人员可访问 列表中调整每行的角色，或勾选多行后通过 批量操作 统一调整、移除。
3. 在 访问范围 下拉中选择：
只有配置了权限的用户可访问（默认）：仅访问列表中的用户、用户组可访问。
主账号下所有用户可访问：主账号下任意子用户无需单独授权即可访问。
公开访问通过弹窗中的 通过公开链接加入 页签配置，详见下方「配置对外公开分享」。
系统默认行：创建者（所有者，不可降权或移除）、Workspace Admins（可管理）。无权限用户在列表中不可见，通过链接访问时会被拦截。
权限角色
权限 | 中文名 | 说明 |
Owner | 所有者 | 看板最高权限，可查看、编辑、管理、删除、转交（创建者默认） |
Can manage | 可管理 | 可管理配置、权限与内容，含授权、修改、回收他人权限 |
Can edit | 可编辑 | 可编辑内容、导入和更新看板（含通过 Buddy 修改） |
Can view | 可查看 | 可查看内容与数据 |
No access | 无权限 | 不可查看、不可检索 |
看板操作 × 角色能力矩阵
操作 | 所有者 | 可管理 | 可编辑 | 可查看 | 无权限 |
查看列表与详情（含溯源、SQL） | ✓ | ✓ | ✓ | ✓ | ✗ |
刷新数据 | ✓ | ✓ | ✓ | ✓ | ✗ |
编辑看板（含通过 Buddy 修改） | ✓ | ✓ | ✓ | ✗ | ✗ |
导出看板 | ✓ | ✓ | ✓ | ✗ | ✗ |
复制链接 | ✓ | ✓ | ✓ | ✓ | ✗ |
删除看板 | ✓ | ✓ | ✗ | ✗ | ✗ |
查看权限列表 | ✓ | ✓ | ✗ | ✗ | ✗ |
授权、修改、回收他人权限 | ✓ | ✓ | ✗ | ✗ | ✗ |
转让所有者 | ✓ | ✗ | ✗ | ✗ | ✗ |
配置公开分享 | ✓ | ✓ | ✗ | ✗ | ✗ |
配置对外公开分享
1. 切换到 通过公开链接加入 页签。
2. 按需开启防护措施：
配置项 | 说明 |
设置密码（默认关闭） | 开启后系统生成随机掩码密码，可查看、复制、重置；访客打开链接先进入密码校验页，通过后才能查看 |
链接有效期（默认关闭） | 默认公开链接永久有效。开启后可选 7 天、30 天或自定义到期日期；到期后链接自动失效，访客会看到「链接已过期，请联系分享者」 |
提示：设置密码与链接有效期可任意组合，也可以都不开启。
1. 点击 复制链接 获取公开链接。
注意：
为防止链接被转发滥用，建议开启设置密码或链接有效期。
匿名访客能力
操作 | 匿名访客（公开链接） |
查看看板内容与图表 | ✓ |
刷新看板数据 | ✓ |
工作空间级公开分享开关
工作空间管理员可以在 工作空间设置 > 安全管理 中控制整个空间是否允许对外公开分享。
嵌出 AI 看板
前提条件
看板必须先发布。未发布时 嵌出仪表盘 按钮置灰，悬停提示「需要发布」。
工作空间管理员已在安全管理中开启 嵌出仪表盘（Dashboard Embedding）并配置批准的域名，该开关同时作用于仪表盘与 AI 看板，详见 发布与分享。
获取嵌出代码
1. 从 AI 看板列表页或看板详情页点击 分享。
2. 根据嵌出后的访问方式，在弹窗中切换对应页签：
邀请企业成员加入：仅授权用户可访问嵌入的看板。
通过公开链接加入：免登录访问，任意持有链接的人可查看看板。
3. 点击 嵌出仪表盘，复制展示的嵌出代码。
4. 将代码粘贴到第三方应用页面。
注意：
当嵌入端域名不在批准列表中时，页面会提示不符合安全设置，无法展示。请联系工作空间管理员将域名加入允许列表。
查看原对话
看板详情页右侧**···>查看原对话** ，仅该仪表盘的 owner 支持点击 ，点击后跳回 Buddy 中原对话页面，所有历史消息完整恢复，您可以继续追问与调整看板。
验证结果
操作完成后，您可以通过以下方式确认：
1. 在 Buddy 对话流中能看到点击产物打开该看板。
2. 进入仪表盘列表页，切换到 AI 看板 Tab，能看到刚保存的看板，所有者、刷新策略、数据更新时间展示正确。
3. 进入看板详情页，HTML 看板正常渲染；右侧元信息面板的数据集、组件统计、刷新策略均符合预期。
4. 开启溯源模式后，指标组件能正确弹出指标口径与维度信息；SQL 组件能弹出完整 SQL。
5. 修改刷新策略后，到了预设时间看板会自动刷新，更新历史 中会出现新的成功记录。
6. 在分享弹窗中配置的权限角色、设置密码与链接有效期生效；匿名访客通过公开链接只能只读查看看板。
7. 已发布看板的嵌出代码粘贴到第三方页面后，看板正常呈现。
常见问题
Q：生成的看板中某个图表用错了字段，怎么纠正？
A：直接在对话框中描述要修改的内容，例如：品类销售占比应该使用 category_name 而不是 category_id 作为分组。Buddy 会识别出目标组件并仅重新生成该组件，不会推翻整个看板。
Q：保存后的 AI 看板可以再放回 Buddy 中继续聊吗？
A：可以。在 AI 看板详情页顶部右侧的**···>查看原对话** ，点击 查看原对话 即可跳回原对话，所有历史消息和上下文完整恢复，可以继续多轮对话调整。
Q：定时刷新失败了在哪里看？
A：在看板详情页右侧元信息面板的更新历史 卡片中查看。失败的记录会显示红色 ❌ 状态与错误原因；同时列表页该看板「数据更新时间」列会出现黄色警告三角图标。
Q：为什么无法使用公开链接分享？
A：工作空间管理员在安全管理中禁用了整个空间的对外公开分享。请联系管理员开启；禁用期间已有的公开链接也会失效。
Q：未发布的看板可以嵌出吗？
A：不可以。iframe 嵌出要求看板先发布，未发布时 嵌出仪表盘 按钮置灰。
Q：匿名访客能看到组件背后的 SQL 和溯源信息吗？
A：不能。公开链接对外隐藏底层 SQL 与溯源信息，访客只能查看看板内容与图表，也不能导出数据或二次授权。
