> ## Documentation Index
> Fetch the complete documentation index at: https://docs.xpertai.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# 用一句话创建看板

> 说明业务口径、选择展示方式，并在工作台检查已保存的看板。

## 开始前

选择已启用实时看板工具的助理，并确认自己有权访问目标数据源。处理文件时，文件必须已经放入该助理或项目有权读取的工作区。HTML 页面与脚本处理需要管理员提供相应运行环境。

你不需要提供数据库密码、接口令牌或手工编写查询。使用系统中的数据源名称；同名来源较多时，先让助理列出可用来源并明确目标。

## 描述需求

一个有效请求通常包含：**来源、指标口径、时间范围、分组、筛选和页面样式**。以自己的数据源替换下面的示例名称：

> 使用销售数据源生成 2026 年第三季度经营看板。净销售额等于实付金额减退款，只统计已支付订单，按月和区域分组。顶部显示总额，左侧显示趋势，右侧显示明细，支持区域筛选和手动刷新，使用白金与金属蓝配色及 ECharts。

需要文件处理时，可以这样说：

> 根据工作区 sales/orders.csv 和指标说明文件，用 Python 处理订单数据，生成按月、按区域的净销售额看板，保留区域筛选和刷新时读取最新文件的能力。

这些是需求示例，不会自动创建同名数据源或文件。也可以先只要求标准图表，在后续修改中明确页面需求。

## 助理如何处理

助理会发现来源、读取字段和业务说明、预览真实数据，再生成页面。遇到含糊指标或缺少必要字段时，应先澄清，不能用其他指标代替。

页面保存前会检查数据配置和筛选；HTML 还会进行初始渲染检查。保存成功后，对话中出现看板资源卡片，并标明工作草稿。首次生成不会自动发布正式版本。

写出一个 HTML 文件，或回复“已完成”，都不等于已保存看板。以成功保存状态及工作台中可重开的草稿为准。没有卡片时，可在实时看板的搜索选择器中查找已保存作品；参见[常见问题](./troubleshooting)。

## 打开并检查

1. 点击资源卡片的**打开**，在 ChatKit 工作台查看目标看板。
2. 检查标题、单位、时间范围、分组和指标定义是否符合请求。
3. 选择一个实际区域，核对总额、趋势和明细是否一起变化，再切回全部。
4. 点击刷新，确认筛选保留且显示新的取数状态。
5. 重开已保存看板，确认页面和定义能够恢复；筛选恢复为定义默认值。

如果显示空结果或部分数据，先确认来源和查询范围，不要把它当作全量业务总额。页面能运行也不代表业务口径已经正确。

需要调整时直接[继续修改当前看板](./edit)，不必重新创建。


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.