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