扣子工作流可将原始数据自动转化为可交互、可刷新的大屏图表,通过配置dashboard_data输入参数、数据库/api接入、python清洗、图表大师或画板生成图表、输出html实现交互,并通过api定时调用与错误降级保障稳定展示。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

用扣子工作流把原始数据自动变成可交互、可刷新的大屏图表,不再手动导出截图再粘贴到PPT或网页里。
准备数据源与接入方式
大屏可视化必须有稳定、结构化的数据输入,不能依赖用户临时上传或口头描述。优先选择数据库直连或API定时拉取,避免Excel文件上传这种易中断的链路。
在开始节点中,配置一个类型为 【Object】 的输入参数,命名为 dashboard_data,并勾选“必填”。这个参数将接收外部系统推送的标准化JSON数据,例如:{"sales": 128000, "users": 4721, "region": [{"name":"华东","value":32100}, {"name":"华南","value":28900}]}
如果数据来自Coze内置数据库,直接添加「数据库查询」节点,写SQL语句 SELECT * FROM dashboard_metrics WHERE updated_at > NOW() - INTERVAL '1 HOUR';不要用SELECT *全量查,会拖慢大屏加载速度。
清洗与结构化处理
真实业务数据常含空值、单位混杂、字段名不一致等问题,必须在渲染前清洗。
添加「代码节点」,语言选Python,粘贴以下逻辑:
import json
data = input.get("dashboard_data", {})
cleaned = {
"total_sales": int(data.get("sales", 0)),
"active_users": int(data.get("users", 0)),
"regional_breakdown": [
{"label": item["name"], "value": int(item["value"])}
for item in data.get("region", [])
]
}
output = cleaned
这一步不做清洗就进图表插件,会导致饼图某块显示 NaN 或柱状图崩掉——插件对输入格式极其敏感,容错率几乎为零。
生成多类型图表并拼合成大屏
方法一:单图表分步生成+前端聚合
为每个图表类型单独调用一次「图表大师」插件:先配 pie_charts 节点输出区域占比图,再配 bar_charts 节点输出销量趋势,最后配 line_charts 输出用户增长曲线。每个插件节点的输出变量分别命名为 pie_img_url、bar_img_url、line_img_url。
方法二:用「画板」节点一键合成
把三个插件节点的输出 URL 全部传入「画板」节点,在编辑界面中拖入三张图片占位框,分别绑定对应变量。调整位置、加标题文字、设置背景色后,导出为一张完整大屏图。注意:画板默认分辨率是1920×1080,若需适配4K屏,需在画板设置里手动改宽高为3840×2160。
方法三:输出HTML片段供内嵌
不生成图片,改用「代码节点」拼接ECharts初始化脚本。把清洗后的 regional_breakdown 数组转成ECharts所需的series.data格式,再包裹进一段带id="chart"的div和script标签。结束节点输出该HTML字符串,由外部Web页面通过iframe或innerHTML直接加载——这种方式支持点击下钻、实时刷新,真正具备大屏交互能力。
对接大屏展示终端
第一步:发布工作流并获取API地址
点击右上角「发布」→「API」→复制生成的 endpoint URL,形如 https://api.coze.com/v1/workflows/xxx/run。
第二步:配置请求头与认证
调用该API时,【必须携带 Authorization: Bearer {your_bot_token}】,否则返回403。Bot Token在「Bot设置→API Tokens」中生成,权限需勾选「Workflow Execution」。
第三步:设置定时轮询
在大屏所在服务器上用cron或Node.js的node-schedule,每5分钟发起一次POST请求,body为JSON:{"parameters": {"dashboard_data": {...}}}。不要用浏览器F5刷新,那会触发新会话且无Token校验。
第四步:错误降级处理
在调用方代码里判断响应状态码:若非200,则显示本地缓存的最后一版图表,并在角落标红字“数据更新异常”。切忌让大屏空白或报错弹窗——值班人员看不到控制台。











