---
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="/zh-Hant/docs/antigravity/understanding/04-agent-loop" />
  <Card title="Agent Manager 查詢手冊" description="查 workspace、conversation、Fast/Planning 和狀態觀察。" href="/zh-Hant/docs/antigravity/official/01-agent-manager" />
</Cards>
