子代理系統

概述

子代理（Subagent）是工作空間的任務分解與委派機制。主 Agent 可以將複雜的並行任務拆分為子任務，建立專門的子代理來獨立執行，子代理完成後將結果回傳給主 Agent 繼續處理。

系統支援三種子代理類型，最大巢狀深度 3 級。

三種子代理類型

自動建立子代理（create_local_sub_agent）

Agent 在推理過程中判斷目前任務需要分解時，會自主呼叫 create_local_sub_agent 工具建立臨時子代理。使用者也可以透過對話提示詞要求 Agent 建立子代理，例如：

「請建立一個子代理來負責搜尋相關資料，再建立另一個子代理來撰寫文件」

建立參數：

執行流程：

1. 主 Agent 決定建立子代理並指定任務
2. 系統啟動獨立的 Agent Loop（預設最大 50 輪）
3. 子代理擁有獨立工具迴圈，執行過程在父對話視窗可見
4. 子代理完成後回傳最終結果給主 Agent
5. 主 Agent 基於結果繼續後續工作

預先註冊派發子代理（dispatch_sub_agent）

使用者可在 APP 設定中預先註冊具有特定設定的子代理，Agent 在需要時透過 dispatch_sub_agent 工具呼叫。

預先註冊子代理的描述會自動注入到主 Agent 的系統提示中，LLM 看到符合的任務時會自動選擇合適的子代理。

設定項：

管理介面詳見 子代理註冊與管理。

跨節點派發（dispatch_multi_node_agent）

當任務需要遠端裝置的資源或能力時，Agent 可透過 dispatch_multi_node_agent 工具將任務派發到其他節點執行。

工作流程：

1. 主 Agent 檢視上線節點清單（注入到系統提示）
2. 根據節點能力宣告選擇目標節點
3. 透過 Gateway WebSocket 發送 node.invoke.request
4. 遠端節點啟動獨立 Agent Loop 執行任務
5. 完成後透過 node.invoke.result 回傳結果

場景範例：

• A 電腦上的 Web 端發起對話
• 任務需要存取 B 電腦上的本地檔案
• Agent 透過 Gateway 將檔案操作子任務派發到 B 電腦的 APP 節點
• B 節點執行後回傳結果，A 電腦上繼續顯示對話

巢狀深度控制

子代理支援巢狀建立，最大深度 3 級：

                      
                      深度 0: 主 Agent（用户对话）
  └── 深度 1: 子代理 A
        └── 深度 2: 子子代理 A-1
              └── 深度 3: 最深层代理（不可再委派）

                    

深度越高，自主性越強，但 Token 消耗和執行時間也相應增加。

工具繼承機制

UI 展示

子代理在 Work 對話視窗中有特殊標記展示：

使用者可以清楚看到哪些操作由主 Agent 執行、哪些由子代理執行。

如何透過對話建立子代理

你可以在對話中用自然語言要求 Agent 建立子代理。以下是一些範例提示詞：

子代理執行中的介面解讀

費用影響

子代理的 token 消耗是獨立計算的：

建議：子代理適合真正需要分解的複雜任務。簡單任務直接讓主 Agent 處理即可，不必建立子代理。

什麼時候該用 / 不該用子代理

SubAgent 不建議賦予不同角色讓其分工協作，在 AI 時代協作反而是降低效率和品質的。在並行任務執行以節省時間、提升效率的場景更加適合。

相關文件

• 子代理註冊與管理 — 預先註冊子代理設定
• 多節點架構 — 跨節點派發的底層機制
• Agent 循環引擎 — 子代理使用的 Agent Loop