工作流
工作流係 LanSphere 提供嘅單輪自動化應用：接收一次輸入後，按你編排好嘅節點流程自動執行，直達輸出結果，全程無需人工互動。
本篇介紹工作流嘅適用場景、畫布操作、三類觸發器、連線同變數引用、環境變數、調試方法，以及儲存同發佈，適合需要搭建自動化流程嘅開發人員閱讀。各節點嘅詳細設定方法請參閱《節點參考》。
適用場景
工作流適合「一次輸入、一次輸出」嘅自動化作業，典型場景包括：
- 數據處理：對輸入嘅文本、檔案或結構化數據進行解析、提取、匯總同格式化。
- 定時任務：按設定嘅週期規則自動執行，例如定時採集數據、定時生成報表。
- 批量作業：對批量數據逐條執行相同嘅處理邏輯，例如批量審核、批量改寫。
- 接口編排：串聯多個系統接口同內部工具，將跨系統嘅多步操作整合為一次調用。
建立工作流
- 點擊左側選單頂部嘅「新建項目」。
- 喺彈出視窗中選擇應用類型「工作流」。
- 填寫應用名稱（必填，1-30 字符，僅支援漢字、大小寫字母、數字、連字號）；應用描述選填，最多 300 字符；頭像支援自訂上載。
- 確認後進入「應用開發」頁，即可喺畫布上編排流程。
提示：除空白建立外，你亦可以從範本商店建立，或匯入 DSL 檔案建立。舊版智能體 DSL 會被拒絕匯入，請前往智能體模組建立。
畫布操作
工作流喺可視化畫布上編排，基本操作如下：
- 新增節點：喺節點列表中點擊目標節點即可新增到畫布，節點僅支援點擊新增，唔支援拖放。
- 搵節點：節點列表可展開、收縮，並支援按名稱模糊搜尋，節點較多嗰陣可快速定位。
- 「輸入」節點全局唯一：一個工作流淨係允許存在一個「輸入」節點；畫布中已存在嗰陣，節點列表會自動隱藏該節點。
- 畫布縮放：使用畫布底部嘅「放大」「縮小」按鈕調整視圖比例。
- 復原與重做：畫布底部提供「復原」「重做」，支援節點增刪同節點內編輯內容嘅回退。
- 變更歷史：畫布底部嘅「變更歷史」可查看畫布嘅修改記錄。
開始節點：三類觸發器
每個工作流由觸發器開始執行，開始類節點共三種：
| 觸發器 | 觸發方式同用途 |
|---|---|
| 輸入 | 手動觸發。執行嗰陣由使用者填寫輸入參數，係最常用嘅開始方式，適合表單式嘅單輪作業 |
| 定時執行 | 按設定嘅週期規則自動觸發工作流執行，適合定時採集、定時匯總等無人值守任務 |
| Webhook 回呼 | 生成回呼地址，外部系統調用該地址即觸發工作流，適合與其他系統嘅事件聯動 |
連線與節點設定
節點之間透過連線傳遞數據：前一節點執行產生嘅輸出，可喺後一節點嘅設定中被引用為輸入變數，從而將多個節點串聯成完整流程。例如「HTTP 請求」節點取得嘅報文，可作為「大模型」節點嘅輸入進行匯總，再由「輸出」節點返回結果。
點擊畫布中嘅節點即可開啟該節點嘅設定面板，按面板提示完成參數設定同變數引用。各節點「係咩、設定咩、輸出咩」嘅完整說明，請參閱《節點參考》。
提示：連線同變數引用係工作流編排嘅核心。建議先理清每個節點嘅輸入嚟自邊度、輸出交畀邊個，再開始連線。
工具類節點
除內建功能節點外，節點列表仲提供四類工具類節點，用於調用平台內外嘅能力：
- 系統插件：調用已安裝並啟用嘅系統插件能力。
- 工作流：調用已發佈為組件嘅工作流（嚟自「協作組件 → 工作流」），實現流程重用。
- MCP：調用已喺「MCP 服務」中新增嘅服務所提供嘅工具。
- 自訂工具：調用喺「插件管理」中建立嘅自訂工具。
點擊其中任一類後，會彈出對應嘅工具列表視窗，由列表中選擇要調用嘅工具即完成節點新增。
環境變數
環境變數係應用級嘅動態參數，用於統一存放服務地址、金鑰等隨環境變化嘅值，流程中嘅節點可統一引用，避免喺多個節點中重複填寫。
環境變數支援設定為「保密變數」：設定後變數值以星號隱藏，適合存放金鑰等敏感資料。
提示：唔同部署環境（例如測試同正式）嘅服務地址、金鑰往往唔同，建議一律透過環境變數傳入，避免將具體值寫死喺節點設定中。
變數檢查
「變數檢查」用於喺執行前偵測流程中嘅變數定義、類型匹配同引用有效性，幫你盡早發現「引用咗唔存在嘅變數」「變數類型唔匹配」等設定問題。建議每次較大改動後執行一次變數檢查。
調試
工作流支援兩個粒度嘅調試：
- 單節點調試：淨係執行選中嘅單個節點，用於驗證該節點嘅設定係咪正確，適合逐個排查問題。
- 整體調試：由開始節點完整執行整個流程，驗證端到端嘅執行效果。
推薦嘅調試順序係：先對關鍵節點做單節點調試，確認輸入輸出符合預期，再執行整體調試。執行後，每個節點都可查看本次嘅輸入、輸出同報錯資訊，便於定位失敗環節；「調試歷史」中可查看過往嘅執行記錄，用於對比唔同版本嘅執行結果。
檢查清單
發佈前，系統會自動執行「檢查清單」，對流程嘅設定完整性同邏輯正確性進行檢查。請按檢查結果嘅提示逐項修正，全部通過後再發佈。
儲存與發佈
畫布右上方「儲存」按鈕嘅懸浮下拉固定為三項：
| 操作 | 說明 |
|---|---|
| 儲存 | 儲存為草稿，僅本人可見；草稿唔可以發佈到應用廣場 |
| 發佈到應用廣場 | 儲存最新內容後上架應用廣場，平台內全員（包括閱覽成員）可見可用 |
| 發佈為組件 | 僅工作流類型可見。儲存後設定組件資料，成為工作流組件，自動同步到「協作組件 → 工作流」，供其他應用調用 |
注意：「發佈為組件」同「發佈到應用廣場」互斥，且透過「發佈為組件」入口發佈嘅組件唔會上架應用廣場。
除應用廣場外，工作流仲可以透過「發佈渠道」頁籤開通網頁連結、API 存取等渠道。工作流唔支援發佈到藍信 AI 助理，如需面向藍信終端用戶嘅對話式應用，請使用對話流或智能體。各渠道嘅完整說明請參閱《發佈渠道》。
應用狀態說明
工作流由建立到上線會經歷以下狀態：建立（未儲存）→ 儲存（草稿，僅本人可見）→ 發佈（應用廣場/組件，各渠道獨立）→ WebApp 線上應用（開通網頁連結後，與發佈渠道可共存）。發佈渠道頁籤嘅「版本管理」會記錄每次已發佈嘅版本說明、發佈人同時間，支援回溯查看。
相關閱讀
- 《節點參考》：全部節點嘅功能、關鍵設定同輸出說明。
- 《對話流》：需要多輪互動同上下文記憶嗰陣嘅應用類型。
- 《發佈渠道》：網頁連結、API 存取、應用廣場、發佈為組件嘅完整流程。
- 《協作組件》：片段、工作流組件、智能體組件嘅重用同調用。