跳轉到

編輯器介面導覽

工作流程編輯器是你「畫流程」的地方：在畫布上新增一個個步驟、用線把它們接起來、設定每個步驟要做什麼。這頁帶你認識編輯器的各個區塊與操作。

開始前

需要先有一個工作流程。建立方式見 建立 Workflow。在流程詳細頁按「編輯」即可進入編輯器（網址會是 /workflows/<流程 ID>/edit）。

編輯器整體版面

工作流程編輯器

由上而下、由左而右大致分成：

  1. 頂端工具列：流程名稱、「設計／程式碼」檢視切換、草稿儲存狀態、「動作」選單。
  2. 左上方的新增狀態（）按鈕：打開步驟選擇面板，把新步驟加進流程。
  3. 中央畫布：以節點 (node) 和連線呈現流程；「開始」與「結束」是固定的起點與終點，中間是你加入的步驟。
  4. 畫布右下角工具列：縮放、全圖顯示、整理佈局等檢視輔助。
  5. 節點設定面板：點任一節點時，從右側滑出，用來設定該步驟的細節。

設計檢視與程式碼檢視

頂端可切換兩種檢視：

檢視 說明
設計 預設檢視，用拖拉節點的視覺化方式編輯流程。一般使用者都用這個。
程式碼 直接檢視／編輯流程底層的定義（一段描述流程的 JSON）。適合進階使用者核對或微調。

什麼是 ASL？

「程式碼」檢視看到的內容，是用一種叫 Amazon States Language（簡稱 ASL） 的格式寫成的 JSON——它是描述「流程有哪些步驟、彼此怎麼接」的標準寫法（源自 AWS Step Functions）。你不需要會寫 ASL 也能正常使用編輯器：在「設計」檢視拖拉節點時，平台就會自動幫你產生這段定義。本手冊沒有 ASL 語法專章，只有需要核對或微調底層定義的進階使用者才會用到它。

「程式碼」是側邊面板，不是整頁切換

按「程式碼」時，會從畫面右側彈出一個「ASL 編輯器」側邊面板，中央畫布仍看得見；它不是把整個畫面切換成程式碼。看完關閉面板即可回到純設計檢視。

草稿與「動作」選單

編輯器採「草稿」機制：你的修改會先存成草稿，頂端會顯示「草稿已儲存」。草稿不會立刻影響正式流程，要按「動作」選單裡的「更新」才會把草稿發布成正式版本。

點頂端「動作」會展開下列選單：

「動作」選單展開後的項目

  • 更新：把目前草稿發布為正式的工作流程（選單最上方也會顯示最近一次更新的時間）。
  • 還原：捨棄草稿，還原到最近一次更新的正式版本。
  • 執行應用程式：直接執行這個工作流程、給一筆輸入看結果（見 執行與查看結果）。
  • 下載定義：把這個流程的定義檔（JSON）下載下來，可用於從定義建立。
  • 設定排程：設定讓這個流程定時自動執行。

Tip

編輯到一半要先離開沒關係，草稿會保留；確認流程可用後，記得回到「動作 → 更新」正式發布。

新增步驟：「新增狀態」面板

點左上方「新增狀態」會打開步驟選擇面板，分成「任務」與「流程」兩個頁籤，上方還有搜尋框可直接搜步驟名稱。

任務（Action）

「任務」就是實際做事的步驟（即 Action），依用途分成幾個類別：

新增狀態面板－任務頁籤

類別 包含的任務
生成式 AI Agent、大型語言模型、結構化大型語言模型
雲端運算 程式碼、Lambda 等
網路傳輸與 API HTTPS API、讀取網址等
網頁互動 搜尋引擎等
資料庫 MySQL、OpenSearch 等
檢索與排序 檢索、Retriever、Ranker 等
工作流程執行 啟動工作流程執行、啟動同步工作流程執行、查詢工作流程執行
文字與資料處理 文字、轉換等

每一種任務的用途與完整設定欄位，請見 Action 總覽 與各任務專屬頁面。

流程（控制流程）

「流程」頁籤是控制「流程怎麼走」的節點，不直接產生內容：

新增狀態面板－流程頁籤

流程節點 用途
依條件分類 依條件把流程導向不同分支（相當於 if／else）。
迭代執行 對一份清單裡的每一筆資料重複執行同一段流程。
並行執行 同時執行多個分支，全部完成後再繼續。
傳遞資料 不做運算，只把資料整理／傳遞到下一步。
等待 暫停一段時間或等到指定時間點再繼續。
成功 提前以「成功」結束流程。
失敗 以「失敗」結束流程，可標記錯誤原因。

每一種流程節點的完整設定欄位、實際效果與執行結果截圖，見 流程控制節點。

要把一個任務或流程節點加入畫布，請用滑鼠把它從面板「拖曳」到畫布上想放的位置，放開滑鼠才會新增節點。請注意：在面板裡只是點擊項目並不會新增節點，那只會顯示該項目的說明提示（tooltip）。節點加入後，把節點之間用連線接起來，就形成流程的執行順序。

設定一個步驟：節點設定面板

在畫布上直接點任一節點本體（例如「大型語言模型任務」），右側就會滑出該步驟的設定面板。面板上方有步驟類型名稱、「定義」開關（顯示底層 JSON）與「測試」（）按鈕；下方用頁籤分區：

節點設定面板（大型語言模型任務）

頁籤 內容
設定 該步驟的主要欄位（例如名稱、要用哪個大型語言模型、對話內容、下一個狀態、附註，以及進階／執行設定）。
輸入與輸出 控制資料怎麼進、怎麼出，例如 InputPath、ResultSelector、ResultPath、OutputPath（皆以 JSONPath 表示）。
錯誤處理 設定重試器與捕捉器，決定步驟出錯時要重試或跳到哪個處理分支。

這三個頁籤裡的共用欄位（名稱、附註、下一個狀態、輸入與輸出、錯誤處理、進階與執行設定）對所有任務都相同，集中說明在 Action 通用設定；各步驟「特有」的欄位則在該步驟的專屬頁面。

測試單一步驟

面板上的「測試」（）可以單獨試跑這個步驟、馬上看到輸出，方便邊設定邊驗證，不必每次都跑整條流程。

開始與結束節點

「開始」與「結束」是每條工作流程固定的起點與終點，點選後一樣從右側滑出設定面板，但它們設定的不是「這一步做什麼」，而是「整條流程的輸入與輸出長相」：

  • 「開始」節點：用「輸入結構」宣告執行時會收到哪些輸入欄位。

    「開始」節點的「輸入結構」面板

  • 「結束」節點：用「輸出結構」定義流程最後要回傳什麼樣的結構。

    「結束」節點的「輸出結構」面板

兩者的完整欄位說明、設定步驟與實際效果截圖，見 開始與結束節點。

畫布工具列

畫布右下角提供一排檢視與排版輔助（都只影響畫面呈現，不會改變流程邏輯）：

畫布右下角工具列，由左到右為復原、重做、放大、縮小、全圖顯示、拖曳整理佈局、拖曳排序節點、展開／折疊全部、整理佈局、程式碼檢視

由左到右：

圖示 作用
復原 / 重做 撤銷或重做上一步編輯動作。
放大 / 縮小 放大、縮小畫布檢視。
全圖顯示 自動縮放到剛好看見整張流程圖。
拖曳整理佈局 切換是否允許用拖曳調整節點佈局（啟用／停用）。
拖曳排序節點 切換是否允許用拖曳重新排序節點（啟用／停用）；啟用後圖示變為 。
展開／折疊全部 一次展開或折疊所有節點，方便綜覽或聚焦。
整理 自動把節點重新排列成整齊的佈局。
程式碼檢視 切換到流程的原始定義（JSON）檢視。

下一步