Skip to content
FunCoding

Search

Search docs, Skills and MCP

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 即可。