---
title: "03 · Editor 与 Agent Manager 怎么分工"
description: "理解 Antigravity 的两种核心界面：Editor 适合同步局部协作，Agent Manager 适合异步任务编排与 artifacts 验收。"
verifiedAt: "2026-05-07"
---

Antigravity 有两个核心界面，不是为了好看，而是为了把两种工作方式分开：你在代码现场和 agent 同步协作，还是你把一个任务交给 agent 并在 Agent Manager 里看计划、状态和 artifacts。

> [!NOTE]
> **一句话判断**：你知道要改哪一段，就用 Editor；你只知道目标和验收标准，需要 agent 自己计划、执行、验证，就用 Agent Manager。

## 1. 两种界面，两种角色

| 界面 | 你在做什么 | agent 在做什么 |
| --- | --- | --- |
| Editor | 和 agent 同步协作，局部修改 | 补全、解释、改小块代码 |
| Agent Manager | 定义目标、审计划、看 artifacts | 计划、执行、验证、交付证据 |

官方 Editor 文档说，Editor 是基于 VS Code codebase 的 AI-powered IDE；官方 Agent Manager 文档说，它提供更高层的视角，让你跨多个 workspace 同时监督几十个 agent，并主要通过 agent 与代码库交互。两句话合在一起，就是这套产品的分工。

Editor 的角色更像 pair programming。Agent Manager 的角色更像任务调度和成果审查。

## 2. 分工图

```mermaid
flowchart TD
    Task["任务"] --> KnowFile{"知道要改哪个文件/函数?"}
    KnowFile -->|是| Editor["用 Editor"]
    KnowFile -->|否| NeedProof{"需要 browser/test/artifact 验收?"}
    NeedProof -->|是| Manager["用 Agent Manager"]
    NeedProof -->|否| Scope{"范围很小?"}
    Scope -->|是| Editor
    Scope -->|否| Manager

    Editor --> Diff["局部 diff review"]
    Manager --> Artifacts["Plan / screenshot / walkthrough"]
```

## 3. Editor 的甜区

Editor 适合你能直接看懂上下文的任务。官方文档也强调，在这里你仍然可以打开文件、编辑文件、使用 Tab（智能补全）、Command（行内自然语言指令）、Agent side panel（编辑器侧栏 agent）、Review Changes（改动审查）和 source control（版本控制）。

- 改一个函数。
- 解释一段报错。
- 让它重写一小段代码。
- 从 Problems 面板修一个类型错误。
- 把 terminal 输出转成排障建议。
- 看 staged / unstaged diff。
- 处理一个 workspace 内的局部修复。

这类任务不要过度流程化。你已经站在代码旁边，就让 agent 做局部辅助。

## 4. Agent Manager 的甜区

Agent Manager 适合有目标但路径不确定的任务：

- 修一个 UI bug 并截图验证。
- 复现 issue、写测试、修复、跑测试。
- 把文档目录重组并生成 walkthrough。
- 让多个 workspace 分别做不同调研或修复。
- 后台跑依赖升级、测试补齐、排障。

这类任务如果放在 Editor side panel 里，容易变成长聊天；放在 Agent Manager 里，它可以形成 conversation、task、artifact 和 review 状态。

官方 Workspaces 文档还说明，在 Agent Manager 中可以同时打开多个 workspace，并通过左侧边栏在 workspace 和 conversation 之间切换。这说明 Agent Manager 不是“更大的聊天窗口”，而是多任务管理面。

## 5. 任务写法差异

Editor prompt 可以短：

```text
解释这个函数为什么会重复请求，并给一个最小修复。
```

Agent Manager prompt 要完整：

```text
修复设置页保存按钮无响应的问题。
要求：
1. 先输出 implementation plan，等我确认。
2. 修改范围限制在 settings 页面和相关测试。
3. 修复后启动本地服务并用浏览器验证保存流程。
4. 交付 diff、screenshot 和 walkthrough。
5. 不要修改无关样式和配置。
```

## 6. 快捷切换和实际动作

官方 Getting Started 和 Agent Manager 文档给出的切换方式：

- Editor 到 Agent Manager：顶部按钮或 `Cmd + E`（Mac）/ `Ctrl + E`（Windows）。
- Agent Manager 到 Editor：workspace 下拉菜单里的 **Focus Editor**，或 **Open Editor**。
- Agent Manager 内：通过 workspace 和 conversation 切换不同任务。

实战里可以这样判断：

```text
我要看文件、diff、终端       -> Editor
我要看 agent 是否还在跑       -> Agent Manager
我要评论 implementation plan  -> Agent Manager / Artifact
我要手动改一行代码            -> Editor
我要并行处理多个 workspace    -> Agent Manager
```

## 7. 常见误用

| 误用 | 后果 | 改法 |
| --- | --- | --- |
| 在 Editor 里要求完成复杂多步任务 | chat 变长，验收散乱 | 切到 Agent Manager + Planning |
| 在 Manager 里问一个小语法问题 | 流程过重 | 直接用 Editor 或 inline command |
| 多 agent 改同一片代码 | diff 冲突 | 按模块拆 workspace 或任务 |
| 没写验收标准 | agent 只交“已完成” | 要求 screenshot、test、walkthrough |

## 8. 实战建议

新手可以用这个规则：

1. 5 分钟内能看完 diff：Editor。
2. 需要 browser 或 test 证明：Agent Manager。
3. 需要先审 plan：Agent Manager。
4. 只问概念或解释：Editor side panel。
5. 要并行多个任务：Agent Manager。

<details>
<summary>深读：为什么不要把所有任务都丢进 Agent Manager</summary>

Agent Manager 的价值在于任务编排、状态观察和 artifacts 审查。如果只是问一个函数含义、改一行命名、修一个局部类型错误，它会变成过重流程。Antigravity 保留 Editor，不是历史包袱，而是为了让局部开发仍然直接。

反过来，复杂任务一直塞在 Editor side panel 里，也会让上下文、计划和验收散落在聊天里。判断入口时，看任务是否需要 plan、parallel workspace、browser evidence 或 artifact comments。
</details>

## 本章自检

你应该能回答：

1. Editor 和 Agent Manager 分别服务哪类任务？
2. 什么时候应该从 Editor 切到 Agent Manager？
3. 为什么多 agent 不能无边界地同时改同一片代码？
4. Agent Manager 里的 artifact 和 conversation 如何帮助验收？

通过标准：你能为一个真实任务选择入口，并写清它在哪个界面启动、在哪里审查、在哪里回到代码。

## 官方来源

- [Google Antigravity Editor](https://antigravity.google/docs/editor)：官方 Editor 文档，说明 VS Code 基础、Tab、Command、Agent side panel 和 source control。
- [Google Antigravity Agent Manager](https://antigravity.google/docs/agent-manager)：官方 Agent Manager 文档，说明跨 workspace、监督多个 agent、切换 Editor。
- [Google Antigravity Workspaces](https://antigravity.google/docs/workspaces)：官方 Workspaces 文档，说明多 workspace 和 conversation 管理。
- [Getting Started with Google Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)：Google Codelab，说明 Editor、Agent Manager、`Cmd + E`（Mac）/ `Ctrl + E`（Windows）、Focus Editor 和 Open Editor。

## 接下来去哪

<Cards>
  <Card title="Agent 任务循环" description="拆开 Antigravity agent 从计划到验收的完整循环。" href="/docs/antigravity/understanding/04-agent-loop" />
  <Card title="Agent Manager 查询手册" description="查 workspace、conversation、Fast/Planning 和状态观察。" href="/docs/antigravity/official/01-agent-manager" />
</Cards>
