子代理注册与管理

概述

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 自动创建即可。