Google Antigravity IDE 教學 (一)：環境建置與 Agentic Mode 初探

步驟一：下載與安裝

目前 Google Antigravity IDE 處於預覽階段 (Preview)。請前往官方網站申請試用或下載安裝檔。

前往 Google Antigravity 官網

下載適用於 Windows 的安裝檔後，執行安裝程序。安裝過程與 VS Code 類似，會自動配置必要的環境路徑。

步驟二：登入與權限設定

首次啟動 Antigravity IDE 時，系統會要求您登入 Google 帳號以存取 Gemini 模型服務。

1. 點擊歡迎畫面上的 "Sign in with Google"。
2. 在彈出的瀏覽器視窗中完成驗證。
3. 回到 IDE，您會看到右下角的連線狀態顯示為 Connected。

步驟三：關鍵設定與環境調校

安裝完成並登入後，為了讓 Agent 發揮最大戰力，我們需要調整幾個關鍵設定。請點擊左下角的齒輪圖示 進入 Settings。

1. Project Indexing (專案索引)

這是 Antigravity 的「大腦」來源。Antigravity 會自動對您的專案進行索引，以便 Agent 理解程式碼結構。

• Antigravity 會在背景建立專案的語意索引 (Semantic Index)。
• 這讓 AI 不只做關鍵字搜尋，而是真正理解程式碼的依賴關係與邏輯。
• 注意： 首次開啟大型專案時，索引可能需要幾分鐘，請耐心等待狀態列顯示就緒。

2. 快速設定面板 (Quick Settings)

點擊 IDE 右下角的狀態列或齒輪圖示，會彈出快速設定面板（如下圖）。這裡分為 Agent 與 Tab 兩大區塊：

Agent 設定 (代理程式行為)

這區塊控制主要 Agent 的自主權與行為模式：

• Agent Auto-Fix Lints (自動修復程式碼問題)：
  • On：Agent 偵測到簡單的 Linter 錯誤（如縮排錯誤、未使用的變數）時，會自動嘗試修復。
  • Off：關閉自動修復功能。
• Auto Execution (自動執行指令)：
  • Always Continue：Agent 可以自動執行終端機指令（如 ls, npm install），不需詢問。
  • Request Review：Agent 想執行指令前，必須先獲得您的批准。（預設推薦）
• Review Policy (實作計畫審查)：
  • Always Continue：Agent 產生的 Implementation Plan 會直接執行，不等待審查。
  • Request Review：Agent 必須先提交計畫讓您看過，您點擊 "Approve" 後才會開始寫 Code。

Tab 設定 (智慧補全)

這區塊控制編輯器中的 "Ghost Text" 自動補全體驗：

• Tab Gitignore Access：
  • Off：智慧補全模型不會讀取被 gitignore 排除的檔案（保護敏感資料）。
  • On：允許讀取，能增加補全的上下文準確度，但需注意隱私。
• Tab Speed：
  • Fast：使用較輕量的模型，延遲極低，適合快速打字。
  • Smart (若有)：使用較強模型，補全品質較高但稍慢。
• Tab to Import：
  • On：當補全建議使用了尚未 import 的套件時，按下 Tab 會自動幫您補上 import 語句。
• Tab to Jump：
  • On：允許使用 Tab 鍵在建議的程式碼片段 placeholder 之間跳轉。

3. Custom Rules (自定義規則)

Antigravity 允許您設定「規則」來引導 Agent 的行為。這就像是給您的 AI 助手一份「員工守則」。

如何開啟設定： 點擊 Agent Manager 右上角的 ... 選單，選擇 Customizations。

• Global Rules (全域規則)： 適用於所有專案。例如：「一律使用繁體中文回應」、「程式碼必須加上註解」。
• Workspace Rules (工作區規則)： 僅適用於當前專案。例如：「在此專案中使用 TailwindCSS」、「依循 Google Java Style Guide」。

4. MCP Store (擴充功能商店)

想讓您的 Agent 能力更強大嗎？MCP (Model Context Protocol) 是 Antigravity 支援的一種開放標準，允許 Agent 連接外部工具與資料源。

點擊左側邊欄的 MCP Store 圖示，您可以一鍵安裝各類官方與社群開發的擴充功能，例如：

• Cloud Run / Firebase： 讓 Agent 直接幫您部署應用程式。
• BigQuery / PostgreSQL： 讓 Agent 能查詢資料庫並進行分析。
• Linear / JIRA： 讓 Agent 讀取工單並更新狀態。

步驟四：認識雙介面 (Editor vs. Agent Manager)

Antigravity 最大的特色在於它擁有兩種核心檢視模式，分別對應不同的工作層級：

1. Editor View (編輯器視角)

這是您熟悉的程式碼編輯介面，適合進行具體的程式碼修改與閱讀。在這邊，您可以像使用 VS Code 一樣操作檔案，但多了一個強大的 AI 側邊欄，隨時準備協助您修改當前檔案。

2. Agent Manager (代理程式管理員)

這就是 Antigravity 的靈魂所在。按下 Cmd/Ctrl + E (或點擊右上方的 Open Agent Manager 按鈕) 進入此模式。這是一個以「任務 (Task)」為核心的控制台，介面採用高效的三欄式佈局 (Three-Column Layout)：

• 左側：導覽面板 (Navigation)：
  • Inbox： 查看所有歷史對話與任務。
  • Workspaces： 管理您的專案工作區。
  • Playground： 快速測試 Prompt 或進行非專案相關的對話。
• 中間：主控台 (Task Stream)： Agent 執行任務的核心區域。
  • 顯示當前任務進度、執行的指令以及 Agent 的思考過程。
  • 底部輸入框可隨時下達新指令或補充需求。
• 右側：上下文預覽 (Context Panel)：
  • 即時預覽 Agent 正在編輯的檔案內容、Diff 差異或 Markdown 渲染結果。
  • 讓您在同一畫面就能完成「指令 -> 執行 -> 審核」的完整迴圈。

Agent Manager 實戰應用場景

根據官方建議，您可以這樣運用 Agent Manager：

• Playground (草稿區)：
  不確定問題如何描述？先在 Playground 與 Agent 聊聊。這裡像是一個沙盒，等到對話內容成熟後，可以一鍵 "Open Workspace" 將對話轉為正式專案任務，甚至直接生成檔案。
• Editor Synergy (無縫協作)：
  雖然在 Agent Manager 可以看預覽，但您可以隨時點擊 "Open Editor" 切換回編輯器。
  進階技巧： 在編輯器中，您可以直接在程式碼裡寫下註解或偽代碼 (Pseudo-code)，然後切回 Agent Manager 告訴 Agent：「請實作我剛剛寫的註解」，Agent 會讀取檔案上下文並精準補完程式碼。
• Browser Automation (瀏覽器自動化)：
  需要測試網頁嗎？直接在 Agent Manager 下令：「打開 localhost:8000 並嘗試登入」。
  Antigravity 會啟動專屬的 Browser Sub-agent，它能像人類一樣點擊按鈕、輸入文字、甚至截圖回報。這對於驗收測試 (Acceptance Testing) 特別有用。請注意不要讓它打開不安全的網站，也不要讓它記憶並輸入您任何帳號密碼。

任務：請幫我建立一個簡單的 Python "Hello World" 網頁伺服器，並寫一份 README 說明如何執行。