# 数据看板

通过对话创建数据看板，或组合已有结果，持续查看业务指标。

数据看板用于持续查看业务指标。看板由多个组件组成，每个组件关联一份可刷新的数据表，并以表格或图表展示。

两种搭法：

| 搭法   | 适合               | 入口                            |
| ---- | ---------------- | ----------------------------- |
| 对话搭建 | 从零开始，说清想看什么就让它排好 | 对话输入框左侧「+」菜单 → 「搭建 Dashboard」 |
| 手动搭建 | 已有保存好的结果，自己拼版    | 左侧主导航 → 数据看板 → 「创建仪表盘」        |

## 用对话搭建

**进入搭建模式**

打开一个对话，点输入框左侧的「+」，在菜单里勾选**搭建 Dashboard**。

进入后输入框的提示语变成「描述你想要的 Dashboard…」，输入框左侧出现一个「搭建 Dashboard」胶囊表示模式已开启。点胶囊上的 × 退出该模式，回到普通对话。

**说清你想看什么**

在输入框里描述看板要包含什么，例如关注的指标、时间范围、对比维度、排序方式。

看板还没有任何组件时，界面只显示对话；**当看板有了第一个组件**，界面切成两栏：左边是「看板预览」，右边是对话。左边空的时候会提示「还没有元素。在右侧对话里让 AI 帮你创建第一个图表或表格。」

**等它探索数据并试跑**

这一步不用你操作。它先在你的数据语义里检索相关表和字段，读表结构和业务文档；写出 SQL 后**先试跑验证**，确认列名和数据符合预期，再落成看板上的组件。所以它不会把没验证过的查询直接放上板。

**用对话继续微调**

直接说人话改，例如「把左上角换成近 30 天的趋势」「删掉客单价」「柱状图改成折线图」「再加一个门店排行」。

改动是**就地生效**的：改标题、改 SQL、换展示方式、调宽高，原有位置保留。它只追加新组件、改现有组件、删组件，**不会重排你已经摆好的版式**。

**到看板详情页收尾**

点预览右上角「打开详情页」进入完整的看板页面，在那里配定时刷新、分享链接和更细的版式调整。

### 指标卡（BigNumber）

看板上有两种「一格大数字」的指标卡，都用表格方式展示，高度固定为 2 格：

| 类型           | 用途               | SQL 必须返回                                    |
| ------------ | ---------------- | ------------------------------------------- |
| BigNumber 单值 | 一个核心 KPI，例如今日订单量 | **一行一列**，展示层把这个数放大居中                        |
| BigNumber 趋势 | 本期与上期的周期对比       | **一行两列**：`current_value` 与 `previous_value` |

趋势卡的列名 `current_value` 和 `previous_value` 是展示层识别它的固定约定，必须保持英文原名，不要改成中文或加前后缀。展示层会显示 `current_value`，并用两列算出涨跌幅百分比。

### 对话搭建的关键约束

| 项目        | 值或行为                         |
| --------- | ---------------------------- |
| 组件本质      | 每个组件底层是一份可刷新的数据表，保存了数据源和 SQL |
| SQL 写法    | 必须可重复执行，用时间函数取相对时间，不硬编码具体日期  |
| 网格        | 12 列。你只给宽高，落点由系统从左到右排，放不下换行  |
| 手动优先      | 你拖拽和缩放过的位置会被保留，AI 不重排已有组件    |
| 已有组件会被改动吗 | 只在你说要改的时候改；改 SQL 会立即重新刷新一次   |
| 组件类型      | 图表或表格；需要明细清单时用表格             |

## 手动搭建与调整

已有的保存结果也可以自己拼成看板。

**进入数据看板**

左侧主导航点「数据看板」。页面标题是「数据看板」，右上角可按名称搜索仪表盘。

页面里创建的对象叫**仪表盘**：按钮是「创建仪表盘」，没有内容时页面为空，用上方按钮创建。

**新建仪表盘**

点「创建仪表盘」，填入仪表盘名称。列表按名称、组件数和修改时间三列展示，修改时间显示为相对时间。可用「排序」按最近修改、名称或创建时间排列。

**添加组件**

点「添加组件」，从数据制品里挑一个。列表里每一项显示行数，已经加过的会被标记出来；没有可选内容时说明该项目还没有保存过的结果——先去[对话](https://docs.asktable.com/conversation)把结果「保存到 Tables」。

还没有组件时，画布为空，用「添加组件」开始构建。

**调整布局和展示方式**

组件可拖拽调整位置和大小。每个组件的展示方式可在表格和图表之间切换。

窗口太窄时无法拖拽，界面会提示窗口太小、需要拉宽。

## 定时刷新与分享

**设置定时刷新**

打开「定时刷新」，勾选启用定时刷新，再选运行频率（「每 10 分钟」「每小时」「每天」「每周」「每月」）。

面板会显示刷新计划和下次运行时间，也可点「立即刷新」手动触发。刷新记录会标出上次刷新时间，失败时标出失败状态。

**Warning：刷新时机**

到达计划时间后，是**下次查看看板时**才刷新其中所有数据表，不是到点后台立刻刷新。想要此刻就是最新数据，点「立即刷新」。

**分享出去**

点「分享仪表盘」，打开启用公开链接开关。拿到链接的人都能查看这个仪表盘，数据实时加载。

## 关键约束

| 项目       | 值                                      | 在哪里改              |
| -------- | -------------------------------------- | ----------------- |
| 刷新频率下限   | 最快「每 10 分钟」                            | 看板「定时刷新」          |
| 刷新时机     | 到点后下次查看看板时才刷新，不是准点后台刷新                 | —                 |
| 组件来源（手动） | 只能选已保存的数据制品                            | 先在对话里「保存到 Tables」 |
| 分享权限     | 公开链接为只读，数据实时加载                         | 看板「分享仪表盘」         |
| 组件数量     | 每行显示组件个数，无硬性上限                         | —                 |
| 趋势指标卡列名  | 必须为 `current_value` 和 `previous_value` | 由对话生成的 SQL 决定     |

## 出问题怎么判断

| 现象          | 判定条件                | 处理                                                  |
| ----------- | ------------------- | --------------------------------------------------- |
| 组件刷新失败      | 卡片上标出「刷新失败」，或显示没有数据 | 打开底层数据表手动刷新后重试；数据源侧改过表结构时先在数据源页「重新同步」               |
| 添加组件时没有可选内容 | 可选列表为空              | 说明该项目还没有保存过的结果，先去对话里「保存到 Tables」                    |
| 组件显示不出数据    | 卡片状态为暂无可用数据         | 点「点击查看详情」看底层数据表状态                                   |
| 拖不动组件       | 拖拽没有反应，界面提示窗口太小     | 拉宽浏览器窗口                                             |
| 分享链接打不开     | 页面提示仪表盘不存在或分享已关闭    | 回到「分享仪表盘」确认公开链接仍处于打开状态                              |
| 数字是旧的       | 卡片上的刷新时间明显早于当前时间    | 点「立即刷新」，或确认「定时刷新」已启用                                |
| 指标卡没显示成趋势   | 卡片只显示一个数，没有涨跌幅      | 让 SQL 只返回一行两列，且列名为 `current_value`、`previous_value` |
| 对话里说了半天没上板  | 看板预览始终为空            | 确认已经进入「搭建 Dashboard」模式（输入框左侧有对应胶囊）                  |

## 下一步

- 组件数据要更新：回到[对话](https://docs.asktable.com/conversation)重跑并重新保存
- 看板上的数字要能解释：补[表与字段备注](https://docs.asktable.com/data/semantics)让口径固定下来
- 让同事在飞书里也能看到：见[定时分析报告](https://docs.asktable.com/integrations/scheduled-reports)
- 想让它自动按套路分析：给智能体挂上[分析技能](https://docs.asktable.com/agent/skill)