為工作流程的 Agent 換模型

工作流程裡每個 Agent 步驟各自決定用哪個模型 —— 和「帳號設定 → AI 助理」那套設定完全無關。同一條工作流程裡，甲步驟用便宜模型分類、乙步驟用強模型寫報告，是常見做法。

在哪裡改

1. 開啟工作流程編輯器，在畫布上點選那個 Agent 步驟。
2. 開啟 Agent 設定對話框。
3. 先看最上面的「設定模式」：預設範本 還是 自訂。兩種模式改模型的位置不一樣。

預設範本模式：覆寫兩個欄位就夠

選了預設（universal、coder、researcher 等）之後，下面的欄位都是「覆寫預設值」的性質 —— 留空就用預設自帶的值。換模型只需要動兩個：

• Provider — 選服務商。改了它，模型清單會依新服務商重新抓取。
• LLM 模型 — 從清單裡選，或直接手動輸入模型 ID。留空則沿用預設的預設模型。

自訂模式：先選路由，再選模型

自訂模式下多了一層「External Agent 路由設定」，三選一，決定這個步驟由誰執行：

三種路由對系統提示詞的處理也不同：標準 Agent 直接使用；Claude Code 透過 --append-system-prompt 追加；Codex 沒有獨立的系統提示詞參數，這段內容會接在任務提示前面一起送出。

模型清單裡找不到想要的型號？

先看對話框上方的「模型類型」開關 —— 文字 / 影片 / 圖片：

• 選了影片或圖片時，清單只顯示支援該素材類型的模型，而且不允許手動輸入型號；
• 文字類型下才可以直接輸入任意模型 ID。

所以「模型清單怎麼空了」多半有兩個原因：一是模型類型選成了圖片 / 影片，二是剛換過 Provider、清單還沒重新抓。收合再展開下拉選單會觸發重新載入。

憑證是怎麼找到的

• 執行時會依 個人 → 團隊 → 系統 的順序，在憑證中心尋找同 Provider 的憑證，工作流程檔案裡不會保存明文 Key。
• 對話框裡的「憑證中心」摺疊區會列出目前設定引用到哪些 Provider，照著補齊即可。
• 舊工作流程的預設覆寫裡可能還內嵌著明文 Key，頁面會提示你遷移到憑證中心後再清理。

查看憑據管理的完整說明

自訂模型別名

對話框裡可以登記「自訂模型」：為一組 Provider + 模型 ID 取個別名，之後在模型下拉選單裡就能選到它。適合內部代理閘道、私有部署模型，或官方清單還沒收錄的新型號。

YAML 裡長什麼樣

畫布上的每一次修改都會同步到 YAML。直接寫 YAML 時，模型設定落在 agent 定義上：

agents:
  - name: summarizer
    preset: universal
    llm:
      provider: openrouter
      model: anthropic/claude-sonnet-4.5

  - name: classifier
    preset: lightweight
    llm:
      provider: deepseek
      model: deepseek-chat

provider 寫的是服務識別碼（openai、openrouter…），不是你為憑證取的標籤名稱。這是最常見的一處寫錯。

幾條實務建議

• 分類、擷取這類確定性強的步驟用小模型，寫作與推理步驟才上強模型 —— 一條工作流程混用不同模型完全正常。
• 換完模型先跑一次 dry-run 或單步執行，確認輸出格式沒變，再掛到定時任務上。
• 團隊共用的工作流程建議引用團隊憑證，否則同事執行時會解析不到 Key。

接著看

• Agent 配置詳解 — preset、工具集、最大輪次等其餘欄位。
• 切換助理身分與模型 — 站內 AI 助理的模型是另一套設定。
• BYOK 自帶 Key — 各家 Key 去哪申請、成本記在誰頭上。