Skip to main content

自訂 Agent

定義自訂 agent 後,即可依用途劃分角色的 sub-agent 架構。 Laravel 版可透過 SessionConfigcustomAgents 進行設定。 關於將多個 sub-agent 並行執行的協作,請參考 Fleet Mode

基本用法

也可以陣列形式指定。

設定項目

description 描述越具體,自動選擇的精準度越高。

Session 開始時選擇特定 agent

指定 agent 後,可從第一個 turn 就啟用特定的自訂 agent。

停用自動選擇(infer: false

執行風險較高操作的 agent,將自動選擇停用並明確使用會較為安全。

對預設 agent 隱藏工具

使用 defaultAgent.excludedTools 可只針對主 agent 隱藏特定工具。 如此更容易委派給能使用該工具的自訂 agent。

監控 sub-agent 事件

Sub-agent 執行過程中會流出 subagent.* 事件。 可透過 onEvent$session->on() 監控。

最佳實踐

  • researcher(以讀取為主)與 editor(負責變更)分開
  • tools 保持最小必要範圍,收斂權限
  • description 寫得越具體,自動委派精準度越高
  • 捕捉 subagent.failed 以準備重試或降級方案

參考

最後修改於 2026年8月2日