建立 Workflow¶

工作流程 (Workflow) 是一個視覺化的流程編輯器，讓你把「大型語言模型、檢索、資料庫查詢、呼叫 API、寫程式」等一個個步驟串成一條可重複執行的自動化流程，打造客製化的生成式 AI 應用。這頁說明如何從頭建立一個工作流程。

開始前

你的帳號需要有建立工作流程的權限。怎麼確認：進入「工作流程」列表頁，看得到右上角的建立按鈕（清單已有資料時是一顆紫色＋圖示）就是有權限；完全找不到那顆鈕，請洽公司的平台管理員開通。
多數任務會用到資源 (Resource)，例如大型語言模型任務需要先建立好「LLM 資源」。可先參考資源總覽，不過你也可以先建立空白流程，之後再補資源。

建立方式¶

在左側選單點「工作流程」進入列表頁，按右上角的「建立」（清單已有資料時它是一個無文字的紫色＋圖示；清單為空時畫面中央會有有文字的「建立」按鈕），會出現一個選單，提供兩種起手式：

方式	說明	適合情境
從空白開始	建立一個全新的空白流程，自己從零設計。	想自己一步步搭流程。
從定義建立	上傳一份既有的工作流程定義檔（JSON），直接匯入成新流程。	已有別人匯出的流程定義，想快速重建。

選單只有兩項是正常的，不是公司還沒建樣板

完整的建立選單其實有三項，中間那一項是「從樣板建立」，但它只有管理員身分的帳號看得到——判斷依據是帳號有沒有管理員身分，不是「公司有沒有建樣板」，也不是可以逐一開通的權限。如果你的選單只有兩項，就代表你不是管理員，不必去找樣板在哪裡。詳見使用樣板建立。

樣板與匯入定義的完整說明見使用樣板建立。本頁聚焦最常用的「從空白開始」。

操作步驟：從空白開始¶

在「工作流程」列表頁按右上角的「建立」（＋）。
在選單選擇「從空白開始」。
在「建立工作流程」對話框填寫名稱。名稱是必填的，但平台已經幫你預填了一個預設名稱（如 MyWorkflow），所以你不改也能直接送出——只是之後在清單裡不好認，建議改成看得懂用途的名字。需要時再填「標籤」與「附註」。
按右上角「儲存」，系統會建立工作流程並直接進入編輯器。（同一排左邊的「放棄」是取消，按下去不會建立任何東西——但會先跳出一個「放棄修改／你所做的修改將不會被保存。」的確認框，再按一次「放棄」才會關掉；即使你什麼都沒改也一樣會問。）

「建立工作流程」對話框欄位¶

欄位	必填	預設	說明
工作流程名稱	是	系統會帶入一個預設名稱（如 `MyWorkflow`）	這個流程的顯示名稱，建議取一個看得懂用途的名字，例如「天氣問答示範」。
標籤	否	無	分類用的小標，貼上後可在工作流程清單頁用「標籤」把同一群流程一次篩出來。填法與數量／長度限制見「標籤」欄位。
附註	否	空白	給自己或團隊看的備註，說明這個流程的用途，不影響執行。這個欄位雖然帶有行號與工具列、看起來像程式碼框，但其實只是一般的多行文字輸入，直接打字即可，不必理會行號與工具列。

建立後會看到什麼¶

儲存後會直接進入編輯器。空白流程並非完全空的——系統會預先放好一條最基本的流程：「開始 → 大型語言模型任務 (LLMAction) → 結束」，方便你直接接著改。如何在編輯器裡新增與設定步驟，見編輯器介面導覽。

已設定過的示範流程：開始（含 question 輸入欄位）→ 大型語言模型任務（已選好模型與提示詞）→ 結束

上圖是一個已經設定過的示範流程。你剛建立的空白流程長得幾乎一樣——三個節點、連線相同，「大型語言模型任務」節點上也已經帶著模型名稱 default-llm 與「使用者」提示詞這兩塊內容。和上圖的差別只有兩點：「開始」節點下方還沒有 question 這個輸入欄位（那是設定過才會出現的），以及提示詞區塊的名字是 default-prompt，不是圖上的 default-content。畫面和圖不完全一樣是正常的，不是你建錯了。

這條空白流程現在就跑得起來，先跑一次確認平台正常

你什麼都還不用改。到流程詳細頁按「執行應用程式」，輸入保持預設的 {} 直接按「開始」，十幾秒後狀態就會變成「成功」，輸出是大型語言模型的招呼語。先跑通這一次，之後遇到問題就能確定是自己接的東西還沒設好，而不是平台壞了。完整步驟見執行與查看結果。

回到「工作流程」列表頁，就會看到剛建立的流程，狀態顯示為「就緒」。狀態只有三種：「就緒」代表這條流程隨時可以執行（正常情況一建好就是這個狀態）、「等待中」代表平台還在處理你剛送出的建立或修改、「刪除中」代表正在刪除。看到「等待中」稍等一下再重新整理即可。

工作流程列表，每一列顯示名稱、ID、狀態與最後更新（圖中已有兩條示範流程）

點流程名稱進入它的詳細頁。詳細頁包含：

上方頁籤：「一般」、「關於」、「執行」、「依賴資源」、「被依賴資源」、「排程」、「版本紀錄」（見版本紀錄）。
「詳細資料」區：列出「ID」、「名稱」、「標籤」（見「標籤」欄位）、「狀態機器 ARN」、「上傳輸入至外部記憶體」（預設為「否」；這是給輸入資料很大、塞不進一般欄位時用的進階選項，見外部記憶體）、「狀態」、「版本」、「建立者」、「更新者」、「最後更新」，右上角還有一排操作圖示（見下）。「建立者」「更新者」是建立與最後修改這個工作流程的使用者，由平台自動建立時顯示「系統」。「狀態機器 ARN」旁的開啟連結會導向底層 AWS 主控台，一般使用者多半會看到錯誤頁，可忽略，詳見通用介面元件。
「工作流程」區：流程的視覺化流程圖。
「輸入結構」、「輸出結構」區：描述這個流程預期的輸入與輸出資料結構，供進階使用者參考。
「定義」區：對應的流程定義（JSON），進階使用者可直接檢視。畫面上這一區排在最後。

工作流程詳細頁

「詳細資料」卡片右上角的操作圖示，由左到右為（頁面標題那一行的紫色「執行應用程式」按鈕不在這一排，見執行工作流程）：

詳細資料卡片右上角的操作圖示：編輯、複製、下載定義、檢視用量分析、檢視程式碼（API 端點）、刪除、收合

圖示	作用
編輯	進入編輯器修改這個流程。
複製	以這個流程為基礎，複製出一個新流程。
下載定義	下載這個流程的定義檔（JSON），可用於從定義建立。
檢視用量分析	在新的瀏覽器分頁開啟這個流程的用量分析頁（原本的詳細頁還留著）。這一頁需要管理權限，一般使用者點下去會看到「權限不足」，見用量分析。
檢視程式碼	開啟一個標題為「API 端點」的視窗（滑過這顆鈕時 tooltip 才寫「檢視程式碼」，所以標題和鈕名不一樣是正常的），裡面用 Shell／Python／Node.js 三個頁籤，各給「開始執行」與「取得執行結果」兩段可直接複製的程式碼。用途：想把這條流程接進公司自己的系統或網站時，把這裡的程式碼複製給工程同事即可，不必自己看懂。
刪除	刪除這個流程，會先跳出確認視窗，確認後無法復原。視窗裡還有一個預設未勾選的「刪除依賴資源」勾選框：不勾就只刪這條流程、它用到的資源留著；勾了會連那些資源一起刪掉。那些資源可能還有別的流程或 Agent 在用，不確定就別勾。
收合	收合／展開「詳細資料」卡片（共用元件，見通用介面元件）。

找不到「發布成樣板」圖示?

把流程「發布成樣板」只有管理員身分的帳號做得到，不是可以逐一開通的權限。非管理員的詳細資料卡片右上角不會出現「發布成樣板」（）圖示，操作圖示就只有上表這幾項。若你需要發布樣板，請洽管理員協助，見使用樣板建立。

下一步¶

點「編輯」進入編輯器，新增與設定步驟：編輯器介面導覽
想用既有定義或樣板快速建立：使用樣板建立
設定好流程後實際執行並查看結果：執行與查看結果
認識每一種任務：任務總覽