Gumloop 功能规格 - Subagents

初始上下文

产品/团队: Gumloop / AI Agent 平台
功能: Subagents — Agent 将任务委派给其他 Agent
描述: 父 Agent 使用 `invoke_agent` 工具派生子 Agent 来并行处理复杂任务的各个维度。支持两种模式：**Self-Cloning**（创建自身的副本，继承相同的工具和指令，默认开启）和**Invoking Other Agents**（调用不同的专业化 Agent）。子 Agent 并行运行，可相互查看进度并通过广播笔记通信
动机: 单个 Agent 顺序处理多个维度任务效率低下。用户需手动管理多个独立的 Agent 实例且这些实例之间无通信机制
目标用户与痛点: (1) 需要并行处理多维度任务的用户（如同时研究 5 家竞品） (2) 需要不同专业 Agent 协同工作的团队 (3) 手动管理多个 Agent 会话的用户
平台范围: Web 端
关键成功指标: 子 Agent 创建量、并行任务完成时间、广播去重次数

1. 概览

背景

Gumloop v9.0.0 发布 Subagents，将 Agent 从"执行者"转变为"管理者"。Subagents 让一个父 Agent 能将复杂任务拆解为多个子任务，派发给自身副本（self-cloning）或专业 Agent，然后汇总结果。

两种模式

模式	机制	适用场景
Self-Cloning	Agent 创建自身副本，继承相同的工具、指令和能力。默认开启	并行处理同类子任务（如同时研究 5 家公司）
Invoking Other Agents	父 Agent 通过 ID 调用不同的专业化 Agent	协作场景——协调者将任务分派给不同的专业 Agent

关键行为

并行执行：多个子 Agent 同时运行。最大并发数取决于订阅层级

进度追踪：批量调用时，共享进度面板追踪每个子 Agent 状态

兄弟通信：子 Agent "可以查看彼此的进度并通过广播笔记通信"

对话记录：每个子 Agent 有独立的交互记录，父对话引用子交互

凭据继承：子 Agent 使用父 Agent 发起者的用户凭据

上下文仪表盘：包含"Subagents"类别——来自已连接子 Agent 的 Token 开销

目标

零代码并行编排：用户通过自然语言即可触发多 Agent 并行工作

去重协作：通过兄弟广播减少重复查询

专业化协作：不同领域的专业 Agent 可通过 Subagents 机制协同工作

2. 竞品分析

竞品	功能/行为	优势	劣势	洞察/机会
OpenAI Assistants	单 Assistant + Thread	模型能力强	无原生多 Agent 编排	自建并行的工程成本高
LangGraph	多 Agent 图编排	高度灵活	需编码，无开箱 UI	零代码是关键差异
CrewAI	多 Agent 团队框架	与 Gumloop 概念最接近	需 Python 编码	产品化 vs 框架化
Claude Code Subagents	主 Agent 派生子 Agent，worktree 隔离	IDE/CLI 深度整合	限于代码场景	设计理念高度一致

3. 工作机制详解（基于官方文档）

3.1 Self-Cloning

Agent 创建自身副本作为子 Agent

副本继承相同的工具、指令和能力

默认对所有 Agent 开启

在 Subagents 列表中显示为"(Me)"

可通过 tool_scope 限制副本的 MCP 工具范围（仅限指定的 MCP 服务器），非 MCP 工具（沙箱、图片生成、网页搜索）始终保留

深度限制 1：副本不能再自我克隆

3.2 调用其他 Agent

父 Agent 通过 ID 调用不同的专业化 Agent

必须在父 Agent 的 Subagents 配置中显式添加目标 Agent

仅同一项目内的自定义 Agent 可选，正被配置的 Agent 自身被排除

跨 Agent 调用链无深度限制（Agent A → Agent B → Agent C 可以无限）

3.3 执行细节

当子 Agent 被调用时，发生六件事：

创建交互记录：每个子 Agent 有自己的交互记录。所有子 Agent 对话出现在聊天历史中

并行执行：多个子 Agent 同时运行。最大并发数取决于订阅层级

进度追踪：批量调用时共享进度面板追踪状态。兄弟 Agent "可以查看彼此的进度并通过广播笔记通信"

文件传输：父 Agent 可在子 Agent 启动前传输特定沙箱文件给它。子 Agent 完成后，对话记录被保存且父 Agent 可读

超时处理：子 Agent 作为排队的后台任务运行，时间预算约为父 Agent 时间限制的一半。超时时先发送优雅中止信号，若不响应则强制取消

深度限制：Self-cloning 深度限制为 1（副本不能再次克隆）。跨 Agent 调用链无限制

3.4 凭据与隐私

子 Agent "在与父 Agent 相同的用户上下文中运行"，使用对话发起者的凭据

Incognito 自动传播：Incognito 会话中创建的所有子 Agent 也自动为 Incognito 模式

3.5 FAQ 关键点

任何 Agent 都能用吗？：所有自定义 Agent 都有 invoke_agent 工具。Self-cloning 默认开启。调用其他 Agent 需显式添加到 Subagents 列表

子 Agent 能调用自己的子 Agent 吗？：可以——如果其 Subagents 列表中有其他 Agent。Self-clone 不能再克隆自身，但跨 Agent 调用无限制

如何查看子 Agent 做了什么？：出现在 Agent 聊天历史中。父对话包含指向每个子交互的链接。完整子 Agent 对话记录可通过 Gumloop UI 查看

子 Agent 失败了怎么办？：失败报告回父 Agent。父 Agent 可以决定重试、尝试不同方法或向用户报告错误

并发有限制吗？：最大并发子 Agent 数基于订阅层级

4. 用户场景与故事

场景 1 — 产品经理：并行研究 5 家竞品

用户画像： 李明，32 岁，SaaS 公司产品经理。每周更新竞品动态报告，手动逐家研究需约 4 小时。

用户故事： 作为产品经理，我希望一次指令就能让父 Agent 创建 5 个子 Agent（self-clones）同时研究 5 家公司，子 Agent 之间能通过广播笔记共享发现避免重复，最后父 Agent 汇总为统一报告。

验收标准：

父 Agent 收到"研究竞品 A/B/C/D/E"后自动创建 5 个 self-clone

子 Agent 启动时广播自己的研究目标

任一子 Agent 完成后结果回传父 Agent

父 Agent 等所有子 Agent 完成（或超时）后汇总输出

如果某个子 Agent 失败，父 Agent 在报告中标注并继续

场景 2 — 运营经理：三个数据源并行查询

用户画像： 王芳，29 岁，电商运营经理。需要从 Notion、Salesforce、Linear 三个系统拉取信息做周报。

用户故事： 作为运营经理，我希望一条指令让父 Agent 同时派生子 Agent 分别查询三个系统，然后汇总为一份周报。

场景 3 — 客服团队 Lead：协调多个专业 Agent

用户画像： 陈立，28 岁，客服团队 Lead。有三个专业 Agent：Sales Research Agent（查 CRM 数据）、Marketing Insights Agent（查活动参与度）、Support Agent（查工单历史）。

用户故事： 作为客服团队 Lead，我希望一个"协调者 Agent"能将客户问题委派给对应的专业 Agent 并行处理，然后汇总结果。

5. 配置流程

┌─────────────────────────────────────────────────────────────┐
│  Agent Settings → Subagents                                 │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│  ┌─ Self-Cloning ──────────────────────────────────────┐   │
│  │  🔍 Research Agent (Me)                    [Enabled] │   │
│  │  enables me to clone myself as a subagent           │   │
│  │  to parallelize work                                │   │
│  │  ──────────────────────────────────────────────     │   │
│  │  tool_scope: [All MCP tools ▾]                      │   │
│  │  可选：限制 clone 只能使用指定的 MCP 服务器          │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
│  ┌─ Other Agents ──────────────────────────────────────┐   │
│  │  📊 Sales Research Agent      [Remove]               │   │
│  │  📈 Marketing Insights Agent  [Remove]               │   │
│  │  ──────────────────────────────────────────────     │   │
│  │  [+ Subagent] ← 从项目内选择自定义 Agent             │   │
│  └─────────────────────────────────────────────────────┘   │
│                                                             │
│  💡 仅同一项目内的自定义 Agent 可选                         │
│  💡 Self-cloning 默认开启，可通过三点菜单关闭               │
└─────────────────────────────────────────────────────────────┘

6. 遥测

漏斗阶段	事件名称	触发条件	指标/KPI	优先级
采用	`subagent_created`	父 Agent 创建子 Agent	创建数/日	P0
使用	`subagent_self_clone`	使用 self-cloning 模式	Self-clone 占比	P0
使用	`subagent_invoke_other`	调用其他 Agent	跨 Agent 调用占比	P0
使用	`subagent_parallel_count`	单次并行子 Agent 数	并行规模分布	P1
质量	`subagent_success_rate`	子 Agent 完成任务	成功率	P0
质量	`subagent_timeout_rate`	子 Agent 超时	超时率	P1
留存	`subagent_repeat_use`	用户 7 天内再次使用	重复使用率	P1

7. 路线图与未来演进方向

阶段	时间线	里程碑	状态
Phase 1 — 基础编排	v9.0.0	Self-cloning + 调用其他 Agent + 并行执行 + 兄弟广播	✅ 已发布
Phase 2 — 增强可靠性	v9.7.0	超时延长至 1 小时（Longer-Running Subagents）	✅ 已发布
Phase 3 — 编排可视化	v10.x	子 Agent 拓扑图、实时甘特图、历史执行回放	⬜ 规划中
Phase 4 — 高级编排	v11.x	条件分支（基于子 Agent 结果决定下一步）、动态扩缩（根据任务量自动增减子 Agent 数）、跨组织 Subagent	⬜ 探索中

关键演进判断

Self-cloning 深度限制 1 是合理的安全边界：防止指数级 Agent 爆炸。跨 Agent 调用链无限制更灵活——用户可以通过多个中间 Agent 构建深度管道

进度广播是协作的核心：兄弟 Agent 之间的"广播笔记"是 Gumloop Subagents 与简单并行调用的关键差异——它不仅并行，还协调

文件传输打开了数据管道：父→子的文件传输和子→父的对话记录回传，本质上构建了 Agent 间的数据流

可视化编排是下一步：当前编排完全依赖 Agent 的判断。引入可视化拓扑和控制界面可以让用户更信任和更精确地控制多 Agent 工作流

由 Claude spec-generate 系统生成 · 来源：Gumloop Agents 帮助文档 - Subagents