Subagent 隔离、恢复与模型
选择前后台任务,隔离代码副本,并核对实际模型与用量。
This page has not been translated into English yet. The original Chinese version is shown below.
Subagent 默认有独立上下文,但共享父 Agent 的 checkout。上下文隔离不等于文件隔离,多个编辑任务可能覆盖彼此改动。
调用与隔离
可以在请求中用 /name 或自然语言指定已定义的 subagent。需要独立代码副本时明确要求每个任务在自己的环境中运行;Cursor 可创建独立 worktree 或云端 VM 与仓库 clone,各自使用分支,结果由父 Agent 后续合并。
前台任务等待结果,后台任务立即返回,状态写到 ~/.cursor/subagents。每次执行返回 agent ID,后续可要求恢复该 ID,沿用既有上下文继续工作。
云端子任务
在 Agents Window 输入 /in-cloud,下一项提交任务在独立云端 VM 与分支运行。/autopilot 可让 cloud subagent 跟进 PR 的反馈、检查等后续工作。
普通 subagent 继承父 Agent 工具,包括 MCP;cloud subagent 使用团队云端配置的 MCP,不继承本地会话服务器。云端环境按仓库配置准备。
嵌套限制
Cursor 2.5 起,主 Agent 和它的直接 subagent 可以创建下一层,但 subagent 的子任务不能继续创建更多层。当前模式还必须提供 Task tool,Hooks 或工具策略可以阻止创建。
模型与用量
自定义 model 默认 inherit,也可指定模型 ID;父 Agent 启动任务时也能指定模型,内置 Explore/Bash/Browser 可选择适合子任务的模型。模型方括号参数使用 id=value,多项逗号分隔,具体键随模型变化。
团队禁用、套餐不含模型或旧 request-based 套餐的 Max Mode 限制可能导致回退。旧 request-based 套餐未开 Max Mode 时使用 Composer;若 Composer 也被管理员禁用,则需启用 Max Mode 才能运行。
父聊天选择 Auto、Grok 或 Composer 不保证子任务从相同用量池扣费。具名第三方模型按实际运行模型计入 Other Models,Teams/Enterprise 还可能涉及 Cursor Token Rate。任务卡与 usage dashboard 可核对实际模型,价格见官方当前说明。
验收委派结果
为每项任务说明范围、已有证据和输出格式。父 Agent 收到摘要后仍应检查 diff 与验证结果;独立上下文适合长探索或并行工作,简单一次性任务通常用 Skill 即可。