---
url: /antigravity/cli-subagents.md
description: 在保持您的活动编程流的同时，将慢速构建、多文件代码生成和研究扫描委托给并行的后台 Agent。
---

# 后台任务与子 Agent (Background Tasks & Subagents)

在保持您的活动编程流的同时，将慢速构建、多文件代码生成和研究扫描委托给并行的后台 Agent。

## 异步执行模型 (Asynchronous Execution Model)

为了最大限度地提高开发速度，Antigravity CLI 采用了多线程异步执行架构。主 Agent 不会在长时间的构建、大规模代码库搜索扫描或复杂的多文件编辑期间锁定您的终端会话，而是将这些操作委托给并行的子 Agent (Subagents) 或后台任务 (Tasks)。

这种委托模型确保您永远不需要等待高延迟的 AI 进程。当多个自主的后台线程并行执行验证任务时，您可以继续编写代码、提交提示词或检查文件。

## 管理 Agent：`/agents` 面板 (Managing Agents: The `/agents` Panel)

活跃的 Agent 层级结构是完全透明的，并可以通过交互式终端界面进行管理。

### 打开面板

在提示符中输入 `/agents` 并按 `Enter` 即可打开交互式的“Agent 管理器面板 (Agent Manager Panel)”。

### 面板概述

该面板显示了所有活跃、已完成、已终止或失败的后台 Agent 的实时清单：

* **Identifier**：唯一的对应子 Agent ID。
* **Role**：Agent 的专业角色（例如“Codebase Researcher”或“Database Debugger”）。
* **State**：实时状态指示器（运行中、已完成、已终止或错误）。
* **Step**：当前正在执行的工具或推理步骤的实时摘要。

### 深度监控

要检查特定后台 Agent 的内部推理、思考和日志：

1. 打开 `/agents` 面板，并使用 `↑/↓` 选中目标 Agent。
2. 按 `Enter` 键打开“子 Agent 详情视图 (Subagent Detail View)”。
3. 此全屏视图显示了子 Agent 的整个推理日志，包括其内部私有的思考、工具调用以及执行输出。
4. 按 `Esc` 键退出并返回到主 Agent 管理器列表。

## 使用 `/tasks` 监控后台任务 (Monitoring Background Tasks with `/tasks`)

对于非 Agent 的后台操作（例如直接运行 Shell 命令、测试套件，或者通过 `/btw` 发起的简单后台查询），请使用 `/tasks` 命令。

```text
/tasks
```

任务跟踪列表允许您：

* 跟踪标准的非交互式后台进程。
* 使用 `↑/↓` 选择任务并按 `Enter` 键查看 `stdout` 日志。
* 安全地终止失控的终端进程。

## 键盘人机工学 (Keyboard Ergonomics)

为了在子 Agent 需要手动交互或工具授权时减少上下文切换的阻力，Antigravity CLI 集成了高效的快捷路径。

### 详情“传送”导航 (`Ctrl+J` / `Alt+J`)

当子 Agent 遇到需要审批的工具（例如写入文件或运行数据库迁移）时，状态栏通知会闪烁。

* 在主提示面板内按 `Alt+J` 可以立即从您当前的对话“传送”到等待您审批的下一个子 Agent 的详情视图。
* 确认或拒绝该操作，然后按 `Esc` 传送回您的主线程。

### “快速通道”确认 (`Ctrl+K`)

无需离开当前活跃的工作空间即可立即授权 Agent 的操作：

* 查看处于活动提示框正上方的行内状态通知。它会摘要显示挂起的动作（例如：`Subagent 12 asks to run "npm test"`）。
* 按 `Ctrl+K` 可以立即批准挂起的快速通道操作，而无需切换面板或打开覆盖图层。

## 下一步 (Next Steps)

配置视觉 Shell 行为并自定义您的配置偏好：

* **设置、渲染与键绑定 (Settings, Rendering & Keybindings)**：自定义键映射、缓冲和 JSON 规则。
* **权限与沙箱 (Permissions & Sandbox)**：在后台进程上强制执行安全容器化隔离环。
* **插件与技能 (Plugins & Skills)**：创建您自己的自定义技能和斜杠命令。