必须采用“HTTP请求+云监控API+前端渲染”路径,因Coze不支持原生SDK且腾讯云图依赖云监控指标与前端配置;需开通云监控高级版、获取合法鉴权凭证、构造签名请求、格式化时间序列数据,并通过嵌入式iframe卡片展示图表。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

要在扣子(Coze)机器人中直接调用腾讯云图(Tencent Cloud Vision)API生成复杂数据分析结果的精美图表,必须绕过其不支持原生云服务 SDK 的限制,改用「HTTP 请求 + 云监控 API 数据源 + 前端渲染」组合路径——因为腾讯云图本身并非图像识别类 API,而是数据可视化平台,其核心能力依赖云监控指标接入与前端图表配置。
确认腾讯云图数据源可用性
登录腾讯云控制台 → 进入「云监控」→ 点击左侧「自定义仪表盘」→ 新建仪表盘后,检查右上角是否显示「添加控件」按钮。若无该按钮,说明当前账号未开通云监控高级版或未授权云监控读取权限。【未开通云监控高级版将无法使用云图的API数据源功能】
在「云产品监控」中任选一个已部署的服务(如CVM、CKafka),确认其有至少1条近5分钟内上报的监控指标(如CPU使用率、消息堆积量)。没有实时指标数据的资源无法被云图拉取。
获取云监控 API 接口地址与鉴权凭证
进入云监控「API 文档」页 → 找到「GetMonitorData」接口 → 点击「在线调试」→ 自动填充 Region、Namespace、MetricName 等参数 → 点击「发送请求」,观察返回结果是否含有效 TimeSeries 数据。
复制调试页右侧「SDK 调用示例」中的 Python 请求代码段,从中提取出 AccessKey ID 和 SecretKey —— 这两个密钥将用于后续 Coze HTTP 请求签名,【SecretKey 绝不可硬编码在 Bot 插件或工作流中,必须通过 Coze 的「环境变量」安全注入】。
记下该接口的 Endpoint(例如 https://monitor.tencentcloudapi.com),注意不是 cos 或 cv 类域名,云图只认 monitor 域名下的监控数据接口。
在 Coze 中构造带签名的 HTTP 请求节点
打开 Bot 编辑器 → 进入「工作流」→ 添加「HTTP 请求」插件节点。
方法一:使用 Coze 内置签名模板(推荐)
在「请求 URL」栏粘贴:https://monitor.tencentcloudapi.com/
「请求方法」选 POST
「Headers」添加:
Content-Type: application/json
X-TC-Action: GetMonitorData
X-TC-Version: 2018-07-24
X-TC-Region: ap-guangzhou(按实际资源地域填写)
「Body」选择 JSON 格式,填入标准云监控请求体,含 Namespace、MetricName、Instances 等字段。
方法二:手动拼接签名串(仅限调试)
需按腾讯云签名 v3 规范,对 timestamp、nonce、secret key 三者哈希生成 Authorization 头。这一步极易出错,Coze 工作流不支持 HMAC-SHA256 计算,【强行手写签名将导致 401 Unauthorized 错误且无法排查】,务必优先选用方法一。
将云监控响应数据映射为云图可识别格式
HTTP 请求节点执行成功后,在「输出」中找到「response_body」字段 → 使用「JSON 解析」节点提取 TimeSeries → 再用「数组映射」节点将原始时间戳(Unix 秒)转为 ISO 格式,将数值数组扁平化为 [{x: '2026-07-29T09:20:00Z', y: 63.2}, ...] 结构。
此结构必须严格匹配云图「折线图」控件要求的 data 字段格式,否则前端渲染为空白。云图不接受嵌套对象或非 ISO 时间字符串。
最后,把处理好的数组存入变量 chart_data,作为下一步「发送卡片消息」的 payload 输入。
通过卡片消息嵌入云图渲染链接
添加「发送卡片消息」节点 → 卡片类型选「自定义卡片(JSON Schema)」→ 在 content 字段中填入标准云图 iframe 模板:
{"type":"image","url":"https://console.cloud.tencent.com/monitor/dashboard/embed?dashboardId=xxx&data="+ encodeURIComponent(JSON.stringify(chart_data))}
注意:dashboardId 必须提前在云监控控制台创建好空白仪表盘并复制其 ID;embed 功能需主账号开启「仪表盘分享」开关,子账号默认不可用。
保存并发布 Bot,触发工作流后,用户收到的卡片将直接加载云图渲染后的动态图表,支持缩放、悬停查看数值、切换时间范围。


















