第一個工作流程¶

這頁帶你先認識平台介面，再親手做出第一個成果——一個會回答問題的工作流程（Workflow）。全程在瀏覽器上點選操作，不需要寫任何程式。

預計花費：約 10–15 分鐘。

一、先認識介面¶

登入後，左側選單是你的主要入口，分成「建立」「探索」「實驗室」三個區段。

建立——做出你自己的成果：

• Agent（對話助理）：建立與管理會對話的 AI 助理。想做一個能用聊天方式互動的助理（例如採購助理、勞動法規顧問），就從這裡開始。
• 工作流程 (Workflow)：建立與管理自動流程的地方，也能看到每次執行的狀態與結果。本頁的教學會帶你做一個工作流程。
• 資源 (Resource)：放置 AI 要用到的「零件」，例如 AI 模型 (LLM)、知識庫、外部連線等。設定一次，就能被多個工作流程或助理重複取用。

探索——先看看別人做出什麼：

• 案例 (Demo)：平台預先準備好的範例，可直接打開看實際做好的成果長什麼樣、能完成哪些任務。還不確定要做什麼時，從這裡看靈感最快。

實驗室——動手前先試玩：

• 遊樂場 (Playground)：可以快速試玩、實驗的地方，不必先建立完整工作流程就能直接體驗平台能力。

二、動手做：第一個問答工作流程¶

我們要做一個簡單的工作流程：接收一個問題 → 交給 AI 回答 → 回傳答案。例如做一個「氣象署民眾問答」「補助申請問答」之類的單句問答工作流程。

flowchart LR
    Start([開始<br/>收到問題]) --> LLM[大型語言模型任務<br/>交給 AI 回答]
    LLM --> End([結束<br/>回傳答案])

步驟 1：建立新的工作流程¶

1. 從左側選單進入「工作流程」。
2. 按右上角的 +（新增）按鈕（清單已有資料時是一顆無文字的紫色 + 圖示；清單為空時畫面中央會出現有文字的建立按鈕）。

3. 在跳出的選單選擇「從空白開始」。

   

4. 在「建立工作流程」對話框填寫名稱（例如 weather-qa-demo），需要時填附註。

5. 按「儲存」，系統會建立工作流程並直接進入編輯器。

   

更完整的建立說明見 建立 Workflow。

步驟 2：進編輯器，設定「大型語言模型任務」節點¶

1. 儲存後會直接進入編輯器，畫布上已有「開始 → 大型語言模型任務 → 結束」。直接點選中間的「大型語言模型任務」節點，右側會滑出設定面板。

   

2. 在「設定」分頁，設定以下重點欄位：

   • 名稱：給這一步一個看得懂的名字（例如 generate_answer）。
   • 大型語言模型：從下拉選單選擇你要用的 AI 模型資源。
   • 對話：你要交辦給 AI 的訊息與指令；本教學會在這裡帶入使用者的問題（見步驟 3）。
   • 下一個狀態：選「結束」，讓這一步跑完直接結束。
   • 附註：選填，給自己或團隊看的備註。

   

節點設定面板上方還有「設定／輸入與輸出／錯誤處理」三個分頁；初次使用只需用「設定」分頁即可，其餘維持預設。

步驟 3：告訴 AI 怎麼回答、要回答什麼¶

節點「設定」分頁的「對話」區，是你幫 AI 做行前交代的地方。一段對話通常由兩種「提示詞 (Prompt)」組成，分工不同：

先把背景與規則交代清楚（系統提示詞），AI 才有足夠的脈絡 (context) 知道怎麼回應；再把使用者當下輸入的問題動態帶進來（使用者提示詞），AI 才知道這次要回答的是什麼。

舉個氣象問答的實際例子，看看這兩種提示詞各會寫什麼：

系統提示詞（靜態）——固定的背景與規則，先讓 AI 知道自己的身分與作答方式：

你是氣象問答小幫手，請依政府公告的標準，用簡潔的繁體中文回答民眾的問題。

使用者提示詞——這次要 AI 回答的問題。它有兩種寫法：

• 靜態（寫死）：直接打一句問題，例如「颱風天要不要上班？」。但這樣每次執行都只會問這一句，換不了。
• 動態（帶入輸入）：不要打死，改成「抓使用者這次輸入的問題」，使用者問什麼、AI 就收到什麼。

要把使用者提示詞變成「動態」，平台是用 JSONPath 來寫——填 $.question，意思就是「取開始節點輸入裡的 question 欄位」（這個欄位我們會在步驟 4 定義）。你現在不用懂語法，下面步驟會帶你一步步點。

這個教學先做最關鍵的一步：把預設那則「使用者」訊息的提示詞設成動態 $.question。（系統提示詞是選填；想讓回答更準，可在「對話」裡再新增一則「系統」訊息，把上面那段背景與規則填進去，完整設定見 大型語言模型任務。）

設定的入口是一層層相套的，要由外而內打開：「對話」→「使用者」訊息 →「內容」（提示詞）→ 在提示詞上開啟 JSONPath。請依序操作：

1. 在「設定」分頁找到「對話」，點「使用者 (User) 」那一列的編輯（）圖示，開啟「編輯對話」。

   

2. 在「編輯對話」的「內容」表格，點該內容列的編輯（）圖示，開啟「編輯內容」。「提示詞來源」維持預設「自訂提示詞」即可，不用更動。

3. 在「編輯內容」找到「提示詞」欄位，打開欄位右上角的「JSONPath」開關。

   

4. 打開 JSONPath 開關後，「提示詞」欄位會收合成一個顯示 $ 的輸入框。這時還不會自動跳出對話框——要再點這個 $ 輸入框右側的鉛筆（ 附加操作）圖示，才會開啟「編輯參考路徑」。

5. 在「編輯參考路徑」：「來源」選「狀態輸入」，「JSONPath」填 $.question。

   

6. 由內而外逐層按「儲存」，回到設定面板。

步驟 4：在「開始」節點定義輸入¶

上一步我們在 AI 節點用 $.question 引用了使用者的問題，現在到「開始」節點把這個 question 欄位正式定義出來——讓工作流程知道「執行時會收到什麼輸入」。這在「開始」節點的「輸入結構」設定。

定義輸入結構有兩個好處：

• 步驟 3 在 AI 節點填的 $.question 就能對應到這個欄位、取到值。
• 執行時，平台會依這個結構自動產生填寫表單，使用者直接在欄位裡填問題即可，不必手寫 JSON。

操作步驟：

1. 在編輯器畫布點選「開始」節點，右側會滑出設定面板，最上面就是「輸入結構」——一張有「名稱」／「類型」／「必填」／「可空」欄位的表格。
2. 按「輸入結構」表格的新增（）按鈕，開啟「新增屬性」對話框。

3. 在「新增屬性」設定這個欄位，然後按「儲存」：

   • 類型：選「字串」。
   • 名稱：填 question。
   • 必填：建議開啟，確保執行時一定帶到問題。
   • 「可空」與「進階設定」（標題、描述、預設值、列舉等）初次使用可先略過。

   

步驟 5：儲存工作流程¶

設定好後，把草稿發布成正式版本：

1. 點右上角的「動作」選單。
2. 選「更新」，把目前草稿發布為正式的工作流程。

步驟 6：實際跑跑看¶

1. 在「動作」選單點「執行應用程式」，開啟「執行」畫面。

2. 在「新的執行」表單：

   • 名稱：可改成有意義的名字，或用系統自動產生的代碼。
   • 輸入：因為步驟 4 定義了輸入結構，這裡會依結構長出對應的填寫欄位——也就是一個必填的「Question」欄位，直接把問題打進去即可，例如「颱風天上班上課的判定標準是什麼？」，不必手寫 JSON。

   

   沒有定義輸入結構的話？

   若工作流程沒有在「開始」節點定義輸入結構，這個區塊會改以 JSON 編輯器呈現，需自己填入 {"question": "…"} 這樣的 JSON。這也是為什麼步驟 4 建議先把輸入結構定義好。

3. 按「開始」。

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

執行完成後可在結果頁看到完整紀錄：

• 輸入：你提供的 JSON，也就是這次的問題。
• 輸出：工作流程的最終輸出，以 Markdown 檢視器呈現，可複製、下載 PDF 或以 JSON 檢視原始結構。
• 詳細資料：這次執行的基本資訊，並可切到「執行流程圖」看實際走過的路徑與各節點狀態。

之後想回頭看這個工作流程的詳細，可到工作流程詳細頁——這頁能看到流程圖、輸入／輸出結構與定義，右上角也有「執行應用程式」（）按鈕可再次執行。

🎉 完成！你已經做出第一個會用 AI 回答問題的工作流程。完整的執行與查看說明見 執行與查看結果。

你做出來的工作流程長這樣¶

flowchart LR
    Start([開始]) --> generate_answer[大型語言模型任務]
    generate_answer --> End([結束])

下一步¶

• 想讓 AI 引用你自己的文件（例如法規、財報、產品手冊）→ Knowledge Base 知識庫
• 想做會對話的助理（例如採購助理、勞動法規顧問）→ 建立 Agent
• 想認識編輯器的各個區塊與更多步驟 → 編輯器介面導覽、Actions 總覽
• 還不熟名詞 → 回頭看 概念