子代理註冊與管理
子代理註冊與管理
概述
子代理管理頁面用於預註冊具有特定設定的子代理。預註冊的子代理會自動注入到主 Agent 的系統提示中，Agent 在遇到符合的任務時自動選擇呼叫。
預註冊子代理設定
基本設定
| 參數 | 說明 | 必填 |
|---|---|---|
name |
子代理名稱 | 是 |
description |
能力描述（注入到父 Agent 系統提示） | 是 |
systemPrompt |
身分／角色定義 | 是 |
工具設定
| 參數 | 說明 |
|---|---|
tools |
工具白名單（省略則繼承父級全部工具） |
disallowedTools |
工具黑名單（在繼承的基礎上排除） |
skills |
可用技能 ID 列表 |
mcpServers |
可用 MCP 伺服器名稱列表 |
執行設定
| 參數 | 說明 | 預設值 |
|---|---|---|
model |
覆寫父級 LLM 模型 | 繼承父級 |
maxTurns |
最大迴圈輪次 | 50 |
canSpawn |
是否可建立下級子代理 | false |
maxSpawnDepth |
最大巢狀深度（1-3） | 1 |
管理操作
| 操作 | 說明 |
|---|---|
| 新增 | 建立新的預註冊子代理 |
| 編輯 | 修改現有子代理設定 |
| 刪除 | 移除預註冊子代理 |
| 排序 | 調整子代理在列表中的順序 |
與 Work 對話的連動
預註冊的子代理透過以下方式與 Work 對話連動：
- 系統提示注入：子代理的
name和description被列在主 Agent 的系統提示中 - 自動比對：LLM 根據使用者訊息語意自動選擇合適的子代理
- 手動呼叫：使用者可在對話中指定使用某個子代理
使用場景範例
| 子代理名稱 | 描述 | 專長工具 |
|---|---|---|
| 程式碼審查員 | 負責程式碼審查和品質分析 | Read File, Search Files, Glob |
| 文件編寫者 | 負責撰寫和格式化文件 | Write File, Edit, Web Fetch |
| 研究助理 | 負責資訊搜尋和資料蒐集 | Web Fetch, Search Files |
| 資料分析師 | 負責資料處理和分析 | Bash, Read File, Write File |
操作指南：建立預註冊子代理
步驟
- 開啟 APP → 設定 → 子代理
- 點擊 新增子代理
- 填寫基本資訊：
- 名稱：如「程式碼審查員」
- 描述：如「負責審查程式碼品質、發現潛在 bug 和最佳化建議」（此描述會注入主 Agent 系統提示，協助 Agent 判斷何時呼叫）
- 系統提示：如「你是一位資深程式碼審查專家，關注程式碼品質、效能、安全性和可維護性...」
- （可選）設定工具白名單／黑名單
- （可選）覆寫模型或調整 maxTurns
- 儲存
設定範例：「程式碼審查員」子代理
名称: 代码审查员
描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。
系统提示: 你是一位资深代码审查专家。你的职责是：
1. 分析代码质量和可维护性
2. 发现潜在的 bug 和安全漏洞
3. 提供具体的优化建议
请对每个问题给出严重等级（低/中/高）和修复建议。
工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改）
模型: Claude Sonnet 4（推理能力强）
maxTurns: 30
canSpawn: false（不需要再委派）
名称: 代码审查员
描述: 负责审查代码质量、发现潜在 bug、提供优化建议。擅长多语言代码分析。
系统提示: 你是一位资深代码审查专家。你的职责是：
1. 分析代码质量和可维护性
2. 发现潜在的 bug 和安全漏洞
3. 提供具体的优化建议
请对每个问题给出严重等级（低/中/高）和修复建议。
工具白名单: Read File, Search Files, Glob Files（只需要读取能力，不需要修改）
模型: Claude Sonnet 4（推理能力强）
maxTurns: 30
canSpawn: false（不需要再委派）
此代碼塊在浮窗中顯示
maxSpawnDepth 的實際影響
| 設定 | 含義 | 適用場景 | 費用影響 |
|---|---|---|---|
| 1（預設） | 子代理不能再建立下級子代理 | 簡單的專項任務 | 低 |
| 2 | 子代理可以再建立一層子代理 | 中等複雜任務，需要二次分解 | 中 |
| 3 | 最大巢狀深度，允許三級委派 | 高度複雜的多步驟任務 | 高（每級子代理獨立消耗 token） |
注意：每一級子代理都會啟動獨立的 Agent Loop（預設 50 輪），消耗獨立的 LLM token。深度 3 意味著最多可能有 4 個 Agent 同時執行（主 + 3 級子代理），費用可能是單一 Agent 的數倍。
預註冊 vs 自動建立：怎麼選？
| 對比 | 預註冊（dispatch_sub_agent） | 自動建立（create_local_sub_agent） |
|---|---|---|
| 設定 | 預先設定好，一勞永逸 | Agent 每次按需臨時建立 |
| 一致性 | 每次使用相同設定，結果穩定 | Agent 每次可能給不同的身分和工具 |
| 適合場景 | 經常重複使用的專業角色 | 一次性的臨時任務分解 |
| 系統提示 | 自動注入主 Agent，Agent 知道可以使用 | Agent 自主決定是否建立 |
建議：如果某類任務你經常需要（如程式碼審查、文件編寫、資料分析），建立預註冊子代理。對於偶爾的臨時任務分解，讓 Agent 自動建立即可。
相關文件
- 子代理系統 — Work 中的子代理使用
- 工具管理 — 子代理可用的工具
- Agent 迴圈引擎 — 子代理使用的 Agent Loop