实践:定时数据采集与蓝信推送 | LanSphere 使用手册

实践:定时数据采集与蓝信推送

本篇以「每天早 8 点自动汇总前一日业务数据并推送到管理群」为例,讲解蓝域(LanSphere)工作流中定时执行、HTTP 请求、大模型与蓝信 MCP 工具的组合用法。适合需要把周期性报表、同步、巡检类工作自动化的开发人员阅读。

场景与价值

管理层习惯上班前看一眼前一日数据,但数据在业务系统里,靠人工同步问题不少:

  • 每天登录系统导出、整理、发群,重复劳动占用专人精力;
  • 节假日、出差时容易漏发,节奏不稳定;
  • 每人整理格式不一,群里历史消息难以对比;
  • 原始数据直接转发,指标多、可读性差,管理层抓不住重点。

用工作流把这条链路自动化:定时触发 → 接口取数 → 大模型生成中文摘要 → 蓝信群消息推送,无人值守、口径稳定,异常数据还能自动标注。

你将搭建什么

一个每天 08:00 自动运行的工作流:从业务系统接口拉取前一日数据(JSON),大模型把数据汇总为一段适合群聊阅读的中文摘要,再通过蓝信 MCP 的「发送群聊消息」工具推送到管理群。上班前,摘要已静静躺在群里。

链路:定时执行 → HTTP 请求 → 大模型 → MCP(发送群聊消息)

推荐流程

步骤 说明
1 准备工作 创建 MCP 服务(蓝信)、确认业务接口与凭证、拿到管理群群 ID
2 创建应用 新建工作流,配置环境变量(接口地址、保密凭证)
3 编排画布 定时执行 → HTTP 请求 → 大模型 → MCP(发送群聊消息)
4 整体调试 手动跑通一次,逐节点核对输入/输出,确认群里收到消息
5 保存上线 保存后定时任务生效,次日在对话日志中核对运行记录

准备工作

项目 要求
平台角色 开发人员及以上(创建工作流、添加 MCP 服务)
蓝信 MCP 服务 已在「左侧菜单 → MCP 服务」中添加蓝信 MCP 服务,消息类工具可用
业务系统接口 前一日数据查询接口的地址、请求方式与认证凭证
目标群聊 管理群的群 ID(可通过蓝信 MCP 的群组类工具查询获取)

第一步:创建应用并配置环境变量

  1. 点击「新建项目」,应用类型选择「工作流」,填写名称(如「每日数据摘要推送」)。
  2. 在环境变量中新增两个应用级变量:
    • API_BASE_URL:业务系统接口地址;
    • API_TOKEN:接口认证凭证,设为保密变量(值以星号隐藏)。

注意:凭证、密钥一律放环境变量并设为保密变量,不要直接写在节点配置或提示词里,避免随应用分享外泄。

第二步:编排画布

工作流是单轮自动化应用,接收触发即直达输出,全程无交互。按顺序添加四个节点(节点仅支持点击添加,可在节点列表中按名称模糊搜索):

1. 定时执行

开始类节点,作为流程起点(本场景无需「输入」节点)。在节点配置中按页面提示将周期规则设置为每天 08:00,工作流将按设定的周期规则自动触发运行。

提示:定时推送类工作流用「定时执行」作为唯一起点;如需同时保留手动运行能力,可在调试时手动触发整体调试验证链路。

2. HTTP 请求

调用业务系统接口拉取前一日数据:

  • 请求方式:GET
  • 请求地址:引用环境变量 API_BASE_URL
  • 请求头:按接口要求携带认证信息,值引用保密变量 API_TOKEN
  • 查询参数:按接口文档填写(如日期参数取前一日)。

地址与凭证引用环境变量而不是写死,是为了换环境(测试/生产)、换凭证时只改变量值,不动画布。

3. 大模型

把接口返回的 JSON 数据汇总成中文摘要。选择模型后,将 HTTP 请求节点的返回数据作为上下文传入,提示词示例:

你是数据摘要助手。以下是业务系统返回的前一日数据(JSON):

(此处插入 HTTP 请求节点的输出变量)

请生成一段推送到管理群的中文摘要,要求:
1. 开头一句话概括前一日整体情况(日期 + 核心指标)。
2. 分条列出关键指标及环比变化,指标名称使用中文。
3. 明显异常的数据(缺失、为零、波动过大)单独标注"需关注"。
4. 只依据给定数据总结,不推测原因,不补充数据中没有的内容。
5. 全文控制在 200 字以内,适合在群聊中快速阅读。

4. MCP 节点(发送群聊消息)

  1. 点击添加工具类节点,选择「MCP」分类,在弹出的工具列表中找到蓝信 MCP 服务的「发送群聊消息」工具。
  2. 配置目标群聊的群 ID;消息内容通过变量选择器引用大模型节点的输出。

如希望在运行记录中保留每次推送的摘要,可在末尾再连接一个「输出」节点,引用大模型节点的输出——工作流用「输出」节点在结束时返回结果。

节点配置速查表

节点 关键配置 说明
定时执行 周期规则:每天 08:00 开始类节点,到点自动触发
HTTP 请求 GET;地址引用 API_BASE_URL;请求头引用 API_TOKEN 凭证走保密环境变量
大模型 模型选择 + 摘要提示词 上下文引用 HTTP 请求返回的 JSON
MCP(发送群聊消息) 群 ID;消息内容引用大模型输出 蓝信 MCP 消息类工具
输出(可选) 引用大模型输出 在运行记录中保留结果

第三步:整体调试

  1. 点击「调试」执行一次整体调试,手动跑通全链路。
  2. 逐节点检查:
    • HTTP 请求节点:确认返回了预期的 JSON 数据;
    • 大模型节点:确认摘要符合提示词要求、无编造内容;
    • MCP 节点:确认管理群中收到消息、格式可读。
  3. 每个节点的输入、输出与报错都可在调试详情中查看,过往记录进入「调试历史」回看。

常见问题排查:

现象 排查方向
HTTP 请求节点报错 环境变量取值是否正确;请求头、凭证是否符合接口要求;接口地址能否从平台环境访问
大模型输出含编造内容 确认上下文变量引用正确;提示词中「不补充数据中没有的内容」约束是否保留
群里没收到消息 群 ID 是否正确;蓝信 MCP 服务授权是否有效;MCP 节点报错信息
摘要格式不适合群聊 在提示词中限定篇幅与分条格式,减少表格、链接等复杂排版

第四步:保存与上线

  1. 点击「保存」保存工作流。发布前检查清单会自动检查配置完整性与逻辑正确性,按提示补齐缺漏。
  2. 保存后,定时执行节点按设定的周期规则自动触发运行;具体的启用、停用方式以应用内提示为准。如需调整推送节奏,修改定时执行节点的周期规则后重新保存。
  3. 上线次日 08:00 后,进入应用详情页「对话日志」页签,确认有运行记录且状态正常——工作流日志包含状态、开始时间、运行耗时、Token 总数、输入/输出与各节点中间过程。

提示:上线初期建议连续几天核对群消息与业务系统实际数据,确认接口口径、「前一日」取数范围与摘要内容都符合预期,再放手让它长期运行。

验证要点

  • 每个工作日 08:00 后,管理群准时收到摘要消息;
  • 摘要中的指标、数值与业务系统前一日数据一致,无编造;
  • 数据异常时摘要中标注「需关注」,便于管理层快速定位;
  • 对话日志中每天的运行记录状态正常、无连续失败;
  • 凭证仅以保密变量形式存在,画布与消息中不出现明文。

扩展思路

  • 异常告警分流:在大模型节点后加「条件判断」节点,摘要中包含“需关注”时改走「发送私聊消息」工具,单独提醒负责人;
  • 多群批量推送:用「数组处理」节点对多个群 ID 批量执行发送;
  • 外部系统触发:把开始节点换成「Webhook 回调」,由业务系统在数据就绪时主动调用回调地址触发;
  • 保留原始数据:将接口返回的 JSON 一并写入输出,便于在日志中追溯摘要依据。