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