子代理註冊與管理

概述

SubAgent 頁（設定 → GWork Settings → SubAgent）用於預註冊具有特定配置的子代理。預註冊的子代理會自動注入主 Agent 的系統提示詞；主 Agent 遇到匹配的任務時，會透過 dispatch_sub_agent 把任務分派給它。

SubAgent 頁面

在你建立第一個子代理之前，頁面顯示 "No sub-agents registered yet"——只有存在至少一個子代理時，主 Agent 的 dispatch_sub_agent 工具才會啟用。

點選 + SubAgent 開啟 Create sub-agent 表單：

欄位	說明	必填
ID	唯一標識，如 `code-reviewer`	是
Name	顯示名稱，如 `Code Reviewer`	是
Description	子代理能做什麼。主 Agent 根據這段描述決定何時分派——請準確、簡潔	是
System prompt	分派時載入，成為子代理的身份，直接影響任務品質	是
Max turns	每次分派的最大迴圈輪次；留空則使用 APP 預設值（50）	否
Can spawn sub-agents	該子代理是否可以再建立下級子代理	否（預設開啟）

點選 Save 完成註冊。除非任務上下文另有指定，子代理繼承主 Agent 的模型和工具。

子代理的執行受此處的 Max turns 以及設定 → Task Control 中的 Sub-agent timeout (minutes)（預設 30 分鐘；取消時已完成的工作會保留）約束。

子代理	說明	常用工具
Code Reviewer	審查程式碼的正確性、效能與安全	Read file、Search in files、Find files
Document Writer	撰寫並排版文件	Write file、docx / pptx 技能
Research Assistant	搜尋與收集資料	Browser、web-search 技能
Data Analyst	資料處理與分析	Run command、Read file、Write file

開啟 APP → ⚙ 設定 → SubAgent
點選 + SubAgent
填寫：
- ID：code-reviewer
- Name：Code Reviewer
- Description："負責審查程式碼品質、發現潛在 bug、提供最佳化建議。擅長多語言程式碼分析。"
- System prompt："你是一位資深程式碼審查專家。分析程式碼的正確性、效能、安全性和可維護性。對每個問題給出嚴重等級（低 / 中 / 高）和修復建議。"
（可選）設定 Max turns（如 30）；若不需要再委派，關閉 Can spawn sub-agents
點選 Save

設定	含義	成本影響
Can spawn sub-agents：關	子代理不能再建立下級子代理	低
Can spawn sub-agents：開	子代理可以繼續委派	較高——每一層都執行獨立的 Agent Loop，消耗獨立的 Token / 積分

注意：每一層子代理都會啟動獨立的 Agent Loop（預設 50 輪）。多層委派可能讓單個任務的成本成倍增加；對於簡單的專業角色，建議關閉再委派。

建議：如果你經常需要某類任務（如程式碼審查、文件撰寫、資料分析），建立預註冊子代理；偶爾的臨時拆解，交給 Agent 自動建立即可。