异步子代理子代理是并行复杂任务并保留主代理上下文的绝佳方法。代理可以将任务（例如运行测试或执行广泛的代码库搜索）委托给专用的子代理，而不是串行执行每个步骤。这种架构使父代理能够继续并行地处理其他任务，并防止其上下文窗口被子代理工作的细节污染。

调用子代理父代理调用 invoke_subagent 工具来生成具有专用角色和初始提示的新并发会话。

  • 工作空间选项：子代理可以继承与其父级相同的工作空间，也可以创建独立的 Git 工作树。
  • 上下文隔离：子代理使用与其父代理相同的模型运行，但不继承父代理的现有对话历史记录（上下文窗口），从干净的状态开始。
  • 执行：一旦调用，子代理立即开始执行其任务。一个父代理可以随时调用多个子代理。
  • 监控：您可以通过子代理面板单击其对话来直接监控任何子代理的进度。

子代理生命周期和状态子代理在后台异步运行，允许父代理委托任务并立即恢复自己的工作。在任何时候，子代理都处于以下三种状态之一：

1. 跑步子代理正在主动执行其任务、调用工具并生成响应。

  • 取消：您可以通过单击子代理面板中的 停止子代理 按钮来取消正在运行的子代理。这会立即取消生成并将子代理转换为空闲状态。
  • 父控制：父代理还可以中断子代理（通过发送消息）或完全终止它。

2.空闲子代理已完成其任务，将包含结果的消息发送给其父代理，并停止执行。

  • 重新唤醒：空闲代理可以在收到来自另一个代理（不必是其父代理）的消息后被唤醒并返回到运行状态。
  • 上下文保留：当被唤醒时，代理会保留其之前工作的所有上下文。

3.被杀子代理被永久终止并且无法重新唤醒。

  • 清理：为子代理生成的任何临时 Git 工作树都会自动清理。
  • 可见性：您和其他特工仍然可以查看被杀死的子特工的历史对话记录。

代理间通信代理通过使用唯一的代理 ID 相互发送消息来进行通信。

  • 灵活路由：代理不仅可以与其直接父代理或子代理通信，还可以与 ID 已知的任何其他活动代理进行通信。
  • 自动唤醒：如果空闲代理收到消息，它会自动重新唤醒以处理新信息。
  • 共享转录本：座席可以查看彼此的对话转录本，从而提供协作工作流程的全面视图。

内置子代理与自定义子代理

内置子代理反重力预装了几个专门的子代理：

  • ** research **：针对代码库研究、导航和探索进行了优化。
  • ** browser **：操作沙盒 Web 浏览器来执行交互式浏览器任务（通过 /browser 斜杠命令专门调用）。
  • ** self **：调用代理的直接克隆，共享相同的系统提示符和工具集。

自定义子代理代理可以使用 define_subagent 工具动态定义自己的自定义子代理。

  • 配置：定义自定义系统提示符和用于只读、写入（包括运行终端命令）和子代理委派功能的特定工具集。
  • 范围：定义后，可以在对话的其余部分重复调用自定义子代理。

委托层次结构和限制子代理可以调用​​自己的子代理，从而实现多层授权和分层团队结构。

<公告> 图标：警告 iconColor: var(--主题-primary) 颜色：var(--主题-表面-表面-容器) 文本：嵌套深度限制：严格执行最大嵌套深度10 层（主代理下方的子代理层），以防止资源耗尽。 </公告>

权限和配置继承子代理继承其父代理的安全配置以维护强大的安全边界：

  • 继承的范围：子代理自动继承父代理允许的终端命令前缀和文件读/写目录范围。子代理无法执行用户尚未为父代理批准的任何操作。
  • 工作区访问：父代理保留对其子代理工作区的完全访问权限，包括在隔离的 Git 工作树上操作的工作区。
  • 权限冒泡：如果子代理遇到需要明确用户确认的工具调用，该请求将自动冒泡到子代理面板 UI 以供您批准。

多代理团队合作（仅限 Ultra Plan）

Antigravity 2.0 为极其复杂的任务引入了先进的多代理编排。

<公告> 图标：星 iconColor: var(--主题-primary) 颜色：var(--主题-表面-表面-容器) 文本：Ultra 计划独享： /teamwork-preview 斜杠命令当前处于预览状态，并且是 Ultra（200 美元/月）计划用户独享的。 </公告>

使用 /teamwork-preview 提示主代理启动协作多代理框架。该框架具有内置的错误恢复、自动重试和协调逻辑，使您可以简单地定义高级目标，同时平台管理合作代理团队的开销。