實踐:定時資料採集與藍信推送 | 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 一併寫入輸出,便於在日誌中追溯摘要依據。