Agent¶

Agent 任務讓你在工作流程的某個步驟中，呼叫一個已建立好的 Agent 資源。Agent 會依照你給的提示詞自行推理、視需要呼叫工具（工具迴圈），最後把回應交給下一個步驟。和直接呼叫 LLM 不同，Agent 能自己決定要不要用工具、用哪個工具來完成任務。

這頁能幫你做什麼¶

• 把開放式的推理或工具選擇交給 Agent 處理（例如「查資料庫後再總結」）。
• 在工作流程中重複使用同一個 Agent 設定，不必每次重建。
• 需要時讓 Agent 輸出結構化 JSON，方便後續步驟取用。

本頁只說明 Agent 任務特有的欄位。名稱、附註、下一個狀態、輸入與輸出、錯誤處理及共用開關，集中在 任務通用設定。

開始前¶

操作步驟¶

1. 在工作流程編輯器中新增一個 Agent 任務（如何新增請見 任務使用指南）。

   

2. 填入「名稱」。

3. 在「Agent」欄位選擇要呼叫的 Agent 資源。這是一個資源挑選欄位：點欄位或右側的鉛筆鈕會開啟挑選對話框，選取時請點該列「名稱」以外的任一格（或列前面的圓鈕）——點「名稱」會在新分頁開啟該資源的詳細頁，不會選取它——再按對話框右上角的「儲存」（見資源挑選欄位）。
4. 在「提示詞」填入要給 Agent 的指示，可用 Jinja2 樣板語法（如 {{ variable }}）插入變數（樣板語法見 Template 語法）。編輯器工具列上有「改寫」（）鈕，可以請系統幫你把草稿改寫成更清楚的提示詞（用法與 LLM 任務 的同名工具相同）。
5. 在「提示詞變數」設定要帶進來的資料（見下方「提示詞變數的兩種角色」）。

6. 視需要展開「進階任務設定」，覆寫模型、設定工作階段、結構化輸出、最大工具使用次數等。

   

7. 設定「下一個狀態」，必要時填「附註」。

8. 用「測試任務」按鈕（）試跑。

提示詞變數的兩種角色¶

「提示詞變數」是本頁最容易搞混的欄位，因為它會依「提示詞」有沒有填而扮演兩種完全不同的角色：

這個欄位預設就把「JSONPath」開關打開、值為 $，也就是「把這一步收到的整包輸入原封不動送給 Agent」。三種常見寫法：

• 整包輸入直接丟給 Agent（預設）：提示詞留空、提示詞變數維持 JSONPath 模式的 $。上一步的輸出就是 Agent 收到的訊息。
• 只把某個欄位當訊息：提示詞留空、提示詞變數的 JSONPath 改成 $.question，Agent 只收到使用者的問題那一段。
• 用提示詞包住動態值：「提示詞」填 請用親切的語氣回答這個問題：{{ question }}，再把「提示詞變數」的 JSONPath 開關關掉、改打開「JSON」開關填 { "question.$": "$.question" }——鍵名 question 要和樣板裡的 {{ question }} 一致，鍵名結尾加 .$ 代表這個值是一條路徑而不是字面字串。

Agent 任務特有欄位¶

設定分頁¶

進階任務設定（摺疊區塊）¶

展開設定分頁底部的「進階任務設定」，Agent 任務提供下列特有欄位。

開啟「啟用結構化輸出」後，下方會多出「JSON Schema」與「結構化大型語言模型」兩個欄位：

執行設定（摺疊區塊）¶

執行設定區塊（上傳輸出至外部記憶體、即時輸出串流、錯誤時中止、預設輸出）皆為共用欄位。其中「預設輸出」在啟用結構化輸出時會套用你定義的 JSON Schema。說明見 任務通用設定。

實際範例¶

提示詞¶

請查詢訂單 {{ order_id }} 的狀態並用一句話回覆顧客。

提示詞變數¶

{
  "order_id.$": "$.order_id"
}

測試執行輸出¶

{
  "errors": null,
  "action_type": "agent_action",
  "message": "您的訂單已於今日出貨，預計兩個工作天內送達。",
  "response": {}
}

文字回應在 message 欄位；若啟用結構化輸出，結構化結果會放在 response 欄位。

技術識別¶

• action_type：agent_action

下一步¶

• 先到 Agent 資源 設定 Agent 的指令與工具。
• 只需要單純呼叫模型時，改用 大型語言模型 (LLM)。
• 共用設定請見 任務通用設定。