开始前
选择已启用实时看板工具的助理,并确认自己有权访问目标数据源。处理文件时,文件必须已经放入该助理或项目有权读取的工作区。HTML 页面与脚本处理需要管理员提供相应运行环境。 你不需要提供数据库密码、接口令牌或手工编写查询。使用系统中的数据源名称;同名来源较多时,先让助理列出可用来源并明确目标。描述需求
一个有效请求通常包含:来源、指标口径、时间范围、分组、筛选和页面样式。以自己的数据源替换下面的示例名称:使用销售数据源生成 2026 年第三季度经营看板。净销售额等于实付金额减退款,只统计已支付订单,按月和区域分组。顶部显示总额,左侧显示趋势,右侧显示明细,支持区域筛选和手动刷新,使用白金与金属蓝配色及 ECharts。需要文件处理时,可以这样说:
根据工作区 sales/orders.csv 和指标说明文件,用 Python 处理订单数据,生成按月、按区域的净销售额看板,保留区域筛选和刷新时读取最新文件的能力。这些是需求示例,不会自动创建同名数据源或文件。也可以先只要求标准图表,在后续修改中明确页面需求。
助理如何处理
助理会发现来源、读取字段和业务说明、预览真实数据,再生成页面。遇到含糊指标或缺少必要字段时,应先澄清,不能用其他指标代替。 页面保存前会检查数据配置和筛选;HTML 还会进行初始渲染检查。保存成功后,对话中出现看板资源卡片,并标明工作草稿。首次生成不会自动发布正式版本。 写出一个 HTML 文件,或回复“已完成”,都不等于已保存看板。以成功保存状态及工作台中可重开的草稿为准。没有卡片时,可在实时看板的搜索选择器中查找已保存作品;参见常见问题。打开并检查
- 点击资源卡片的打开,在 ChatKit 工作台查看目标看板。
- 检查标题、单位、时间范围、分组和指标定义是否符合请求。
- 选择一个实际区域,核对总额、趋势和明细是否一起变化,再切回全部。
- 点击刷新,确认筛选保留且显示新的取数状态。
- 重开已保存看板,确认页面和定义能够恢复;筛选恢复为定义默认值。