跳轉到

執行與查看結果

流程建好之後,就可以實際執行它、給一筆輸入、看它跑出什麼結果。這頁說明如何啟動一次執行、查看輸出,以及檢視每一步的執行細節。

開始前

啟動一次執行

  1. 進入工作流程的詳細頁,按右上角的「執行應用程式」() 按鈕,即可在新的瀏覽器分頁直接進入「新的執行」畫面(網址 /workflows/<工作流程 ID>/execute)。若按了沒看到反應,請檢查是不是開在新分頁了。

    工作流程詳細頁:右上角「執行應用程式」

  2. 在「新的執行」表單填寫名稱與輸入。

    「輸入」欄位長相取決於你有沒有設定「輸入結構」

    「輸入」欄位會依這條流程的「開始」節點有沒有定義「輸入結構」而改變樣子,未必會像截圖那樣直接出現一格一格的填寫欄位

    • 有定義輸入結構:平台會依結構自動產生對應的填寫欄位(例如下圖的「Question」),你直接在欄位裡填值即可。

      新的執行表單:已定義輸入結構時,自動產生「Question」填寫欄位

    • 沒有定義輸入結構(例如剛建立的空白流程):「輸入」會改以 JSON 編輯器呈現,需要自己輸入 JSON(不需要輸入時可留空的 {})。

      新的執行表單:未定義輸入結構時,輸入改以 JSON 編輯器呈現

    想要那種好填的表單,請先到「開始」節點設定「輸入結構」,做法見編輯器介面導覽

  3. 按「開始」。

「新的執行」表單欄位

欄位 必填 預設 說明
名稱 系統自動產生一組代碼 這次執行的識別名稱,方便日後在執行清單中辨認。可改成有意義的名字。
輸入 空白 這次執行要餵給流程的輸入資料。流程裡的步驟可用 JSONPath(如 $.query)引用這些值。顯示方式視「開始」節點的「輸入結構」而定:有定義時是自動產生的填寫欄位,沒定義時是 JSON 編輯器(編輯器右上角工具列說明見通用介面元件)。若流程不需要外部輸入,可留空。
進階設定 收合 點開後可設定執行的進階選項(見下)。一般情境用預設即可。

「進階設定」展開後有兩個欄位:

欄位 必填 預設 說明
上傳輸入至外部記憶體 關閉 開關。開啟後,這次執行的輸入會先上傳到外部記憶體再帶入流程,適合輸入資料很大、或流程需要從外部記憶體讀取的情境。
狀態記憶體輸入選擇器 空白 僅在「上傳輸入至外部記憶體」開啟時出現。用一段 JSON 指定要從這次的輸入裡,挑哪幾塊資料保留在「狀態記憶體」中,讓後續步驟仍能直接引用。填寫方式見下方怎麼填「狀態記憶體輸入選擇器」

「進階設定」展開後:上傳輸入至外部記憶體開關(已開啟)與狀態記憶體輸入選擇器

怎麼填「狀態記憶體輸入選擇器」

當輸入資料很大時,開啟「上傳輸入至外部記憶體」會把整包輸入搬到外部記憶體,流程裡的步驟就無法像平常一樣用 $.欄位名 直接拿到值。這個選擇器的用途,就是從整包輸入裡挑出少數幾塊關鍵資料,原封不動留在「狀態記憶體」中,讓後續步驟還是能直接引用,不必每次都回外部記憶體撈。

填的內容是一個 JSON 物件,由一組或多組「鍵值對」組成:

  • 鍵(冒號左邊):你自己取的名稱,代表這塊要保留的資料,之後步驟就用這個名稱引用。
  • 值(冒號右邊):一段 JSONPath 表示式,從「這次執行的輸入」裡指出要取哪一段——最外層的 $ 代表整包輸入,$.question 代表輸入裡的 question 欄位,$.documents 代表 documents 欄位,依此類推。值一定要是參考輸入內容的 JSONPath,不能直接寫一個固定文字。

例如這次執行的輸入是:

{
  "question": "這份合約的付款條件是什麼?",
  "documents": ["...很長的合約全文..."]
}

若希望把 question 留在狀態記憶體中讓後續步驟方便引用,選擇器就填:

{
  "question": "$.question"
}

之後步驟即可用 question 這個名稱取得該值。要保留多塊資料時,就多寫幾組鍵值對:

{
  "question": "$.question",
  "documents": "$.documents"
}

Note

這個欄位是 JSON 編輯器,內容必須是合法的 JSON;每個值都要是 $ 開頭的 JSONPath,指到的欄位若在輸入裡不存在,這次執行會失敗。不需要保留任何資料時,把開關關掉即可,不必填這個欄位。

「關於」頁籤

執行畫面上方除了預設停在的「執行」頁籤,還有一個「關於」頁籤,顯示這條流程的說明文字(在編輯器中填寫的描述),方便執行前快速確認用途。

左側欄會列出這個流程過去的執行紀錄;按「新的執行」可隨時再發起一次。

查看執行結果

按「開始」後,畫面會切換到這次執行的結果頁,並即時更新狀態。執行完成後,狀態會顯示「成功」或「失敗」。

工作流程執行結果

結果頁主要分成:

  • 輸入:這次執行實際收到的輸入資料。可按「再次執行」用同樣的輸入重跑。
  • 輸出:流程的最終輸出,以「Markdown 檢視器」呈現,附目次(可「回到頂部/移至底部」)。輸出卡片右上角有一排圖示:
  • 複製內容
  • 下載成 PDF
  • 以 JSON 檢視(看原始結構化結果)
  • 在對話方塊中檢視(放大檢視輸出,內容較長時更好讀)
  • 詳細資料:這次執行的基本資訊與分頁(見下)。「執行 ARN」欄位旁有 複製與 開啟連結( 會導向底層 AWS 主控台,一般使用者多半會看到錯誤頁,請改用 複製或下方分頁,詳見通用介面元件);卡片右上角有 編輯與 收合(見通用介面元件)。

「詳細資料」面板

「詳細資料」顯示名稱、狀態、執行 ARN、執行時間、開始時間與停止時間,並提供以下分頁:

分頁 內容
一般 這次執行的基本資訊(名稱、狀態、ARN、耗時、起訖時間)。
串流輸出 若步驟有開啟串流,這裡會顯示即時串流的內容。
歷史 逐步的執行歷程,方便追查每一步發生了什麼。
執行流程圖 以流程圖呈現這次實際走過的路徑與各節點狀態,一眼看出流程跑到哪、哪一步出錯。

執行流程圖

用範例驗證流程

剛建立的空白流程預設是「開始 → 大型語言模型任務 → 結束」。即使還沒接任何外部資料,也可以直接「執行應用程式 → 開始」跑一次,確認流程能正常運作,再逐步把步驟換成你真正要的內容。

從詳細頁的「執行」頁籤查看

流程詳細頁上方的「執行」頁籤,集中列出這個流程的所有執行紀錄;點任一筆即可開啟上述結果頁,回顧當時的輸入、輸出與每一步細節。

下一步