開始使用 Google Antigravity

1. 簡介

在本程式碼研究室中，您將瞭解 Google Antigravity，這個代理式開發平台專為代理程式時代而生。Antigravity 2.0 是 AI 代理的中央指揮中心，提供統一平台，可啟動、監控及調度代理的活動。

隨著 2.0 版推出，Antigravity 不再只是整合至 IDE 的代理管理工具，現在已成為完整的產品生態系統，專為代理優先時代設計：

  • Antigravity：適用於 macOS、Linux 和 Windows 的旗艦獨立應用程式。您可以在這裡平行管理多個本機代理程式、執行排定的工作等。與前身 Agent Manager 不同，Antigravity 2.0 是獨立應用程式，可獨立於 IDE 運作。
  • Antigravity IDE：功能齊全的原始代理功能 IDE 仍可使用，建議開發人員採用。這項工具隨附代理管理員、構件，以及對程式碼集的深入瞭解。
  • Antigravity CLI：指令列介面，可透過終端機與代理互動。本教學課程不會說明這項功能。
  • Antigravity SDK：開發人員可使用這項工具，以程式輔助方式將 Antigravity 整合至自家系統。本教學課程不會說明這項功能。

在本程式碼研究室中，我們將著重於 Antigravity，並簡要介紹 Antigravity IDE。本文不涵蓋另外兩個元件：Antigravity CLI 和 Antigravity SDK。

如果您對 Antigravity CLI (以終端機為基礎的應用程式) 的程式碼研究室有興趣，請參閱「開始使用 Antigravity CLI」程式碼研究室。

課程內容

  • 安裝及設定 Antigravity。
  • 探索 Antigravity 的重要概念，例如如何使用代理程式和工作區等。
  • 透過各種設定，按照個人偏好自訂 Antigravity。

軟硬體需求

您必須在本機系統上安裝 Antigravity。這項產品適用於 Mac、Windows 和特定 Linux 發行版本。除了自己的機器，還需要下列項目：

  • Chrome 網路瀏覽器。
  • Gmail 帳戶 (個人 Gmail 帳戶)。

本程式碼研究室適合各種程度的使用者和開發人員。

報表問題

在逐步完成程式碼研究室和使用 Antigravity 時，您可能會遇到問題。

如要回報程式碼研究室相關問題 (錯字、錯誤的操作說明)，請點選本程式碼研究室左下角的「Report a mistake」按鈕開啟錯誤：

e7d8a6055a16a773.png

如要回報 Antigravity 相關錯誤或要求功能，請在 Antigravity 內回報問題。如要回報產品意見，請按一下 Antigravity 產品左下角的「設定」，然後選擇 Provide Feedback 選項。

2. 安裝

安裝 Antigravity

前往 Google Antigravity 下載頁面。下載適用於您作業系統 (macOS、Linux 或 Windows) 的 Antigravity 應用程式。

31e6370c1744fe73.png

執行安裝程式。畫面如下所示：

4783c8ff21fbc6e7.png

使用 Google 帳戶登入。完成驗證後，畫面應會顯示下列內容：

12fa8752446a0458.png

按一下「開啟 Antigravity」。系統會顯示「安全性與資料使用」政策。按一下「下一步」。

8f2fe904767c34b.png

選取喜歡的主題：

cc2466b518c241c9.png

Antigravity 隨附一組外掛程式，可搭配各種 Google 開發人員工具使用。這些外掛程式會安裝一組技能，協助 Antigravity 搭配 Google 各種開發人員工具運作。以下列出可選擇安裝的外掛程式。本程式碼研究室不會介紹這些外掛程式。按一下「完成」。

3919ac5f462a5dfc.png

您應該會看到如下所示的 Antigravity 介面：

319cf98d41231a82.png

安裝 Antigravity IDE

您也可以選擇安裝 Antigravity IDE。前往 Google Antigravity 下載頁面。前往 Antigravity IDE 下載專區。

6d05924ef8098ae.png

成功安裝 Antigravity 和 Antigravity IDE 後，Dock 中會顯示兩個圖示：「Antigravity」 (白色背景) 和「Antigravity IDE」 (黑色格線背景)。

97b7906262ed8246.png

3. Antigravity 介面

我們已準備好開始！我們先著重於使用 Antigravity。初始 Antigravity 畫面如下所示：

4b2ebaf5bbaa6a27.png

在本教學課程中，我們將視需要前往左下角的「設定」選項。

專案

首先，請瞭解 Antigravity 中的「專案」概念。這點非常重要，因為如果您注意到右側窗格中的介面，會清楚顯示「選取專案」，而 Antigravity 採用以專案為中心的方法，確保代理程式有權存取正確的檔案、工具、權限等。

專案是由定義代理程式環境和範圍的資料夾組合而成。專案可與一或多個資料夾 (例如前端和後端存放區) 搭配運作，而非強制代理程式在單一資料夾中運作，為代理程式提供程式碼集所需的所有內容。所有專案都有各自獨立的代理程式設定，方便您分別自訂不同專案的安全設定。

我們來建立第一個專案。在本機電腦的主資料夾中，建立名為 $HOME/agy2-projects/my-first-project 的資料夾。請注意，這個資料夾不一定要是空白資料夾。

我們現在要定義構成專案的資料夾，在 Antigravity 中建立第一個專案。在我們的初始案例中，這會是一個資料夾。

依序點選「選取專案」→「新增專案」，如下所示：

8fb15004219d1d6d.png

如預期，系統會要求您「選取資料夾」，如下所示：

3b194f9234cbf9ca.png

按一下「新增資料夾」，然後選取特定資料夾，例如「$HOME/agy2-projects/my-first-project」。

f907f3b64cf0d6a0.png

您還是可以為專案新增更多資料夾 (如「新增資料夾」所示)，但目前可以點選「下一步」按鈕。

系統會顯示如下所示的對話方塊。所有專案都有各自獨立的代理程式設定，方便您獨立自訂不同專案的安全設定。

45a29e5c40bf3ae7.png

每個專案都會從主要介面的「設定」繼承權限，包括檢閱構件、允許使用的工具，以及 Model Context Protocol (MCP) 伺服器設定。不過，您可以為每個專案個別設定這些權限和其他權限，進一步提升彈性，並為特定專案維持精簡的脈絡和工具。

目前請選擇「Default」選項。

您也可以在下一個對話方塊中命名專案，然後按一下「建立」：

529d6c23ef880f5.png

您現在會看到以下畫面。專案會顯示在專案清單和即時通訊介面中，如下所示。請注意，你可以選取模型、透過「+」符號或「@」或「/」動作傳遞其他內容，以及執行更多操作。

f2bfdb27bc878643.png

你傳送訊息向代理打招呼後，代理就會相應回覆。

7e4027bd7a9505e3.png

我們還有另一個取得新聞的要求，而且效果不錯。

a5b751531e25f2d3.png

對話

在我們的專案 (my-first-project) 中，我們啟動了對話串，目前該對話串中有一連串訊息 (使用者訊息和代理程式回覆)。

您會看到左側的對話討論串已歸類在專案下方。

e650cbd24d8b66ca.png

現在，讓我們做一些有趣的事，為這個對話串命名。我們將其命名為 conv-introduction。

方法是按一下對話旁三個直向點，系統會顯示 3 個選項。選擇「重新命名」動作。

244d0bd0fce7a213.png

請提供 conv-introduction 值，或任何您覺得合適的名稱。

如要在專案中開啟全新對話，請點選專案旁的「+」(專案中的新對話) 符號，如下圖所示。

7b834450020d8c03.png

你現在進入了全新的對話。

讓我們詢問世界各地的體育新聞。請注意，我們仍在 my-first-project 中。

4b3208b40a03b6d1.png

這會提供一些體育新聞，您會發現同一個專案中現在有兩個對話串。

aaf65af4b2791423.png

讓我們將這個對話重新命名為 conv-sportsnews。如要查看目前為止的所有對話，請前往左上方的「對話記錄」，如下所示：

3ed91bba75d70871.png

您隨時可以透過頂端的「New Conversation」(新對話) 選項，在目前專案或新專案中展開新對話。

專案設定

現在回到我們稍早討論的「專案設定」。在 Antigravity 中建立專案時，專案會沿用預設權限，但您可以視需要覆寫這些權限。

如要前往特定專案的專案設定，請按一下左側導覽列中每個專案旁的設定齒輪圖示。

7f7158d07780eba9.png

系統會將您導向特定專案 (即「my-first-project」) 的設定，如下所示：

d73f96c9f4f8f61b.png

請注意，左側專案下方已選取「my-first-project」。如果還有其他專案，這些專案會顯示在這個清單下方，您可以輕鬆選取任何專案，並視需要調整設定。

現在，請將焦點放在右側，也就是「my-first-project」顯示的專案設定。您會發現其中只有我們新增至這個專案的單一資料夾。你也可以在這裡新增更多資料夾。

建議您先瀏覽完整清單，瞭解目前提供的彈性，以便根據專案自訂需求變更大量設定。

包括：

  • 安全預設：決定代理程式執行動作前，是否要先由您審查所有終端機指令和檔案存取權。
  • 代理程式行為：決定代理程式是否要經過審查，才能執行實作計畫。
  • 各種本機權限：允許或封鎖代理程式的檔案路徑、網址等。
  • 您甚至可以設定允許這個專案使用的特定 MCP 工具。這項功能相當實用，可防止代理在專案中存取所有全域設定的 MCP 伺服器。

注意：您隨時可以透過 Antigravity 介面中的主要設定選項，前往 Antigravity 或專案設定。

9632f5815b5f00c5.png

4. 斜線指令

Antigravity 提供一些有趣的斜線 / 指令，在對話介面中輸入 /，應該會看到如下所示的指令：

a6b3198f2b693d8d.png

請考慮使用 /browser 指令。這是啟動瀏覽器並要求執行特定動作的明確指令。

嘗試瀏覽網站，如下所示：

1a23771f8cc1f7d2.png

這會產生瀏覽器子代理程式，嘗試啟動與 Chrome 的偵錯工作階段，並先徵求您的許可：

1380710b74477b94.png

允許後，系統會視需要要求權限並取得詳細資料。

8620b739bc192f7.png

6d592e977d54337b.png

如要設定定期或一次性工作，讓代理程式以固定間隔或在排定的時間執行 (例如週一和週三上午 9 點)，可以使用 /schedule 指令。

同時，您也可以透過使用者介面執行這項操作，這部分會在下一步的「排定指令」一節中說明。

5. 排程指令

您可以使用主介面中的「排程」選項，自動執行重複性工作，或在特定專案中設定一次性提醒。

4749901a164cd1ad.png

我們來建立每日工作，提醒我們每天下午 6 點要開會。按一下「新增」，然後填寫詳細資料，如下所示：

41865ad9a5242407.png

按一下「新增排定工作」，系統隨即會將工作新增至排定工作清單，如下所示：

a4cecc4896c59893.png

我們再新增一個提醒，每 20 分鐘提醒我們休息一下：

e3b75ee01010eb9.png

現在有兩項排程工作，如下所示：

6d122472143e48f3.png

你可以停用或刪除任何工作。請注意，我們使用的是基本提示，但您可以根據需求，使用詳細提示、叫用工具 (與外部系統通訊)，以及定期在幕後執行更多工作。

6. Model Context Protocol (MCP) 伺服器

Model Context Protocol (MCP) 已成為協助代理程式連結外部系統的標準。這類工具可確保代理程式在資料和整合方面保持基礎。

Antigravity 支援本機和遠端 MCP 伺服器。此外，這項服務也隨附與多個 MCP 伺服器的整合功能，可搭配 Google Cloud 服務使用，只要按一下滑鼠並提供少許設定資料，即可安裝。

首先，請查看預先設定的 MCP 伺服器選項清單。依序前往「設定」→「自訂」，然後按一下「新增 MCP+」按鈕，即可新增伺服器。這時會顯示對話方塊，其中列出完整伺服器清單：

dbde58f6f5f99df9.png

按一下「+ 新增」按鈕，即可新增任何 MCP 伺服器。您需要提供專案 ID、資料庫詳細資料等資訊，視 MCP 伺服器而定。

新增現有 MCP 伺服器

在幕後，MCP 伺服器是在 $HOME/.gemini/config/mcp_config.json 檔案中設定。如果您使用現有的遠端 MCP 伺服器，只要將詳細資料新增至這個檔案即可。如要瞭解如何設定自訂 MCP 伺服器，請參閱這個網頁的相關章節。

新增遠端 MCP 伺服器並儲存檔案後，即可前往 Antigravity 的 MCP 伺服器部分，步驟如下：

  1. 在 Antigravity 主介面中，按一下「Settings」(設定)。
  2. 前往「自訂」。如果仍未看到 MCP 伺服器，請按一下「重新整理」。

7d004eba523578fd.png

  1. 如要停用任何 MCP 伺服器，請使用「切換」按鈕。或者，您也可以點選任一 MCP 伺服器，查看該伺服器公開的工具。

如要使用已設定的 MCP 伺服器，可以詢問 Antigravity 需要 MCP 伺服器的問題。舉例來說，您可以啟用 cloudrun-mcp 伺服器，然後向 Antigravity 提出以下要求：Build and deploy a Cloud Run service。這會提示 Antigravity 尋找並使用 cloudrun-mcp 伺服器，設定及部署 Cloud Run 服務。

7. 構件

Antigravity 會在規劃及完成工作時建立構件，藉此傳達工作內容並取得人類使用者的意見回饋。包括豐富的 Markdown 檔案、架構圖、圖片、瀏覽器錄影、程式碼差異等。

構件可解決信任缺口。如果代理程式聲稱修正了錯誤，開發人員先前必須閱讀程式碼才能驗證。在 Antigravity 中，代理程式會產生構件來證明。

Antigravity 主要產生的構件如下：

  • Task Lists：代理會在編寫程式碼前生成結構化計畫。您通常不需要編輯這項計畫，但可以查看，並視需要新增留言來變更計畫。
  • Implementation Plan：用於設計程式碼集內的變更，以完成工作。這些計畫包含必要修訂內容的技術詳細資料，除非您將構件審查政策設為「一律繼續」，否則使用者必須審查這些計畫。
  • Walkthrough：代理程式完成任務實作後，系統會建立這項內容，做為變更摘要和測試方式。
  • Code diffs：雖然嚴格來說不是構件，但 Antigravity 也會產生程式碼差異，供您審查及加上註解。
  • Screenshots：代理程式會擷取變更前後的 UI 狀態。

如要進一步瞭解構件，請使用下列提示詞，在新的或現有專案中建立對話：

Design a Node application that I can run from the command line to get me the latest news from Google.

代理程式開始運作，並傳回第一項成果：實作計畫。

884916b26ead9728.png

如要查看 Antigravity 產生的任何構件，請切換右上角顯示的「輔助窗格」。

94738a4b59d84fd7.png

如果切換「輔助窗格」，您會看到下列輸出內容，其中提到已產生 1 個構件 (實作計畫)。

3ad614ce81650142.png

點選「實施計畫」即可查看詳細資料，如下所示：

90e8ccae66dba76b.png

目前我們對這項方案沒有異議，只要按一下「繼續」按鈕即可。

現在，當它開始工作時，會建立另一個構件「工作計畫」和其他檔案。如下所示，您可以在輔助窗格中查看所有這些內容：

5e7c8edfff5390ee.png

按一下「工作」構件，即可查看達成目標的逐步工作清單，以及已完成和尚未完成的步驟。

a18a60fc2a5c136f.png

最後，當所有事項都完成、經過測試並由服務專員驗證後，你會收到訊息，表示工作已完成。另一個構件「Walkthrough」也已準備就緒。最終清單如下所示：

125f41b0a983f57a.png

請注意，除了構件 (工作、逐步說明和實作計畫) 之外，還有來源檔案 (package.json、index.js)。

您可能不需要功能齊全的編輯器 / IDE 即可查看產生的檔案。您可以點選 package.json 或 index.js 檔案，查看內容並加上註解。

8. Antigravity IDE

如果您偏好使用 IDE，可以選擇使用本程式碼研究室稍早安裝的 Antigravity IDE。你會發現，在主要 Antigravity 介面中切換輔助面板時，會出現「開啟 IDE」選項。

94738a4b59d84fd7.png

按一下即可開啟 Antigravity IDE。啟動 Antigravity IDE 時，您可能會看到如下所示的警告：

d5919244c996af7f.png

這是正常的狀況。請按一下「是」。這會開啟 Antigravity IDE，如果您曾使用 IDE，應該會覺得很熟悉。其中包含所有生成的資料夾/檔案、編輯器和「代理面板」，您可以在這裡與代理討論程式碼 (說明、生成、修正等)。

f6af75f8e99cbbc6.png

9. 技能

雖然 Antigravity 的基礎模型功能強大且用途廣泛，但並不瞭解您的具體專案背景或團隊標準。將所有規則或工具載入代理程式的內容視窗，會導致工具膨脹、成本增加、延遲和混淆。

技能會透過逐步揭露的方式解決這個問題。技能是專業知識的特殊套件，在需要時才會啟動。只有在特定要求符合技能說明時，才會載入代理程式的情境。

結構和範圍

技能是目錄式套裝組合，您可以視需求在兩個範圍中定義這些項目：

  • 全域範圍 (~/.gemini/config/skills/)：適用於所有 Antigravity 產品 (Antigravity、Antigravity IDE、Antigravity CLI) 和專案。
  • 專案/工作區範圍 (<project-root>/.agents/skills/)：這會讓技能僅適用於特定專案。

技能剖析

典型的技能目錄如下所示：

my-skill/
├── SKILL.md    #(Required) metadata & instructions.
├── scripts/    # (Optional) Python or Bash scripts for execution.
├── references/ # (Optional) text, documentation, or templates.
└── assets/     # (Optional) Images or logos.

現在來新增一些技能。

程式碼審查技能

這項技能僅提供指令，也就是說，我們只需要建立 SKILL.md 檔案，其中會包含中繼資料和技能指令。讓我們建立一項技能，向服務專員提供詳細資料，以審查程式碼變更是否有錯誤、樣式問題和最佳做法。

假設您位於特定專案資料夾 (例如 $HOME/agy2-projects/my-skills-project))，第一步是在專案資料夾中建立目錄，用來存放技能。

mkdir -p .agents/skills/code-review

在專案資料夾 (例如我們剛才建立的 .agents/skills/code-review) 中建立 SKILL.md 檔案，並加入以下內容：

---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?

## How to provide feedback

- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible

請注意，上方的 SKILL.md 檔案頂端包含中繼資料 (名稱和說明)，接著是指令。代理程式載入時，只會讀取技能的中繼資料，並只在必要時載入完整的技能指令。

讓我們驗證程式碼審查技能。在 Antigravity 中開啟所選專案的對話，然後提供下列提示。

732820afe6db3ce0.png

畫面應會顯示 code-review 技能。

立即試用

在 $HOME/agy2-projects/my-skills-project 中建立名為 demo_bad_code.py 的新檔案，並加入下列內容：

import time

def get_user_data(users, id):
   # Find user by ID
   for u in users:
       if u['id'] == id:
            return u
   return None

def process_payments(items):
   total = 0
   for i in items:
       # Calculate tax
       tax = i['price'] * 0.1
       total = total + i['price'] + tax
       time.sleep(0.1) # Simulate slow network call
  
   return total

def run_batch():
   users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
   items = [{'price': 10}, {'price': 20}, {'price': 100}]
  
   u = get_user_data(users, 3)
   print("User found: " + u['name']) # Will crash if None
  
   print("Total: " + str(process_payments(items)))

if __name__ == "__main__":
   run_batch()

在 Antigravity 的特定專案中開啟新對話，然後輸入下列提示：review the @demo_bad_code.py file。

代理程式應找出 code-review 技能、載入詳細資料，然後根據 code-review/SKILL.md 檔案中的指示執行動作。

輸出範例如下所示：

a6e2b1b775feda28.png

10. 結語

恭喜！您已成功安裝 Antigravity、設定環境，並瞭解如何控制代理程式。

贏得 Kaggle 5 天 AI 代理徽章

您是否已完成這個實驗室，並參加 Kaggle 的「5-Day AI Agents: Intensive Vibe Coding Course with Google」？領取結業徽章：取得 5 天 AI 代理徽章。

後續步驟 如要查看 Antigravity 在建構實際應用程式時的運作方式，請參閱下列程式碼研究室：

參考文件