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