Agent¶

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

這頁能幫你做什麼¶

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

需要先建立 Agent 資源

Agent 任務必須綁定一個已建立的 Agent 資源（內含指令、工具、可用模型等設定）。如何建立請見 Agent 資源。

提示詞與提示詞變數至少要填一個

試跑（執行）時，「提示詞」與「提示詞變數」兩者不可同時為空，否則無法執行。當有提示詞時，提示詞變數作為樣板的變數值；當提示詞為空時，提示詞變數會作為輸入訊息直接傳給 Agent。

欄位	必填	預設	說明
Agent	是	無	選擇這個步驟要呼叫的 Agent 資源。也可切換為用 JSONPath 從工作流程輸入帶入 Agent ID。
提示詞	視情況	空白	要給 Agent 的指示文字，支援 Jinja2 樣板語法，可用 `{{ variable }}` 插入提示詞變數。與「提示詞變數」至少要填一個。
提示詞變數	視情況	參考路徑 `$`	提供給 Agent 的變數。可用鍵值對逐項設定（值可為固定值或 JSONPath，如 `{ "message.$": "$.messages" }`），或切到 JSON 模式整批提供。有提示詞時作為樣板變數；提示詞為空時作為輸入訊息傳給 Agent。與「提示詞」至少要填一個。

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

欄位	必填	預設	說明
大型語言模型	否	沿用 Agent 預設	覆寫這次執行 Agent 預設使用的模型。可選項僅限該 Agent 允許切換的模型清單；若 Agent 未設定可切換模型，這裡無可選項。可清除以回到 Agent 預設。
工作階段 ID	否	空白	指定 Agent 執行要使用的工作階段 ID，可用來延續同一段對話記憶。未填則系統建立新的工作階段。
儲存庫	否	無	指定工作階段期間提供給 Agent 使用的儲存庫資源（例如供 Agent 讀寫檔案）。如何建立見儲存庫資源。
啟用結構化輸出	否	關閉	開關。開啟後，系統會把 Agent 最終回應再整理成結構化 JSON。開啟後會多出下方兩個欄位。
JSON Schema	是（啟用結構化輸出時）	預設空白物件結構	只在啟用結構化輸出時出現。定義 Agent 結構化回應要符合的結構，可用建構器或 JSON 模式編輯。
結構化大型語言模型	是（啟用結構化輸出時）	無	只在啟用結構化輸出時出現。指定負責把回應轉成結構化 JSON 的 LLM 資源。
最大工具使用次數	否	25	這次執行允許 Agent 使用工具的最大次數，範圍 1–100。用 JSONPath 帶入時不套用範圍檢查。
WebSocket 閒置逾時	否	30	Agent 執行期間每次 WebSocket 訊息接收的閒置逾時秒數，範圍 1–300。用 JSONPath 帶入時不套用範圍檢查。

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

Agent 任務開啟「啟用結構化輸出」後多出的「JSON Schema」與「結構化大型語言模型」欄位

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

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

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

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

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