GSP1348

總覽

直覺式程式開發是新興的軟體開發做法，運用人工智慧 (AI) 技術，根據自然語言提示詞生成可運作的程式碼，不僅能加快開發速度，還可降低應用程式建構門檻，特別適合程式設計經驗有限的開發人員。

這個詞彙由 AI 研究人員 Andrej Karpathy 在 2025 年初提出，是指開發人員在開發流程中的主要工作，從逐行編寫程式碼轉為透過更自然的對話，引導 AI 助理 (如 Antigravity CLI) 生成、修正應用程式並偵錯。這樣一來，開發人員就能將重心放在整體架構或應用程式的主要目標上，而實際的程式碼編寫工作則由 AI 負責。

Antigravity CLI 是開放原始碼 AI 代理，可讓您直接在終端機中使用 Gemini 的強大功能。Antigravity CLI 專案採用開放原始碼，您可以查看公開發展藍圖，進一步瞭解功能強化細節、即將推出的功能和錯誤修正內容。

課程內容

在本實驗室中，您將瞭解如何執行下列工作：

• 設定 Antigravity CLI，以便使用。
• 與 Antigravity CLI 互動。
• 探索 Antigravity CLI 內建工具。
• 在殼層模式下使用 Antigravity CLI。
• 在 Antigravity CLI 中設定 MCP 伺服器。
• 使用 Antigravity CLI 進行直覺式程式開發。

必備條件

本實驗室可完全在 Google Cloud Shell 中執行，該環境已預先安裝 Antigravity CLI。

本實驗室適合各種程度的使用者和開發人員 (包括初學者) 參加。

設定和需求

瞭解以下事項後，再點選「Start Lab」按鈕

請詳閱以下操作說明。實驗室活動會計時，且中途無法暫停。點選「Start Lab」後就會開始計時，顯示可使用 Google Cloud 資源的時間。

您將在真正的雲端環境完成實作實驗室活動，而不是模擬或示範環境。為此，我們會提供新的暫時憑證，供您在實驗室活動期間登入及存取 Google Cloud。

為了順利完成這個實驗室，請先確認：

• 可以使用標準的網際網路瀏覽器 (Chrome 瀏覽器為佳)。

注意事項：請使用無痕模式 (建議選項) 或私密瀏覽視窗執行此實驗室，這可以防止個人帳戶和學員帳戶之間的衝突，避免個人帳戶產生額外費用。

• 是時候完成實驗室活動了！別忘了，活動一旦開始將無法暫停。

注意事項：務必使用實驗室專用的學員帳戶。如果使用其他 Google Cloud 帳戶，可能會產生額外費用。

啟動 Cloud Shell

Cloud Shell 是搭載多項開發工具的虛擬機器，提供永久的 5 GB 主目錄，而且在 Google Cloud 中運作。Cloud Shell 提供指令列存取權，方便您使用 Google Cloud 資源。

1. 點按 Google Cloud 控制台頂端的「啟用 Cloud Shell」圖示 。

2. 系統顯示視窗時，請按照下列步驟操作：

   • 繼續操作 Cloud Shell 視窗。
   • 授權 Cloud Shell 使用您的憑證發出 Google Cloud API 呼叫。

連線建立完成即代表已通過驗證，而且專案已設為您的 Project_ID：。輸出內容中有一行文字，宣告本工作階段的 Project_ID：

Your Cloud Platform project in this session is set to {{{project_0.project_id | "PROJECT_ID"}}}

gcloud 是 Google Cloud 的指令列工具，已預先安裝於 Cloud Shell，並支援 Tab 鍵自動完成功能。

3. (選用) 您可以執行下列指令來列出使用中的帳戶：

gcloud auth list

4. 點按「授權」。

輸出內容：

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`

5. (選用) 您可以使用下列指令來列出專案 ID：

gcloud config list project

輸出內容：

[core] project = {{{project_0.project_id | "PROJECT_ID"}}} 注意：如需 gcloud 的完整說明，請前往 Google Cloud 參閱 gcloud CLI 總覽指南。

工作 1：根據需求設定 Antigravity CLI

為 Antigravity CLI 啟用 Cloud Logging

為了讓系統能針對本實驗室的部分工作評分，請為 Antigravity CLI 啟用 Cloud Logging。

• 在 Cloud Shell 執行下列指令，為 Antigravity CLI 設定 Cloud Logging：

mkdir -p ~/.antigravity cat < ~/.antigravity/settings.json { "project": "{{{ project_0.project_id }}}", "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://{{{ project_0.startup_script.external_ip }}}:4318", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } } EOF

您可能會注意到，AGENTS.md (or GEMINI.md) 範例檔案提供了一些一般指示，以及非常具體的程式設計樣式、依附元件管理等指示。您可以根據所用的程式設計語言、框架、程式設計樣式和其他專案專屬偏好，以類似的方式撰寫自己的準則。

如要讓 Antigravity CLI 按照您的偏好運作，必須妥善設定 AGENTS.md (or GEMINI.md) 檔案。您可以參閱 Practical Antigravity CLI (實際運用 Antigravity CLI) 系列文章，進一步瞭解如何為專案自動生成這類檔案、自訂系統提示詞等。

設置專案專屬設定

開始使用 Antigravity CLI 前，請先建立一個資料夾，做為所有專案的主資料夾，您可以在其中建立各項專案。雖然 Antigravity CLI 可能會視需要參照系統中的特定其他資料夾，但這個資料夾是它的工作起點。

1. 在 Cloud Shell 執行下列指令，建立範例資料夾 antigravity-projects，然後前往該資料夾：

export GOOGLE_CLOUD_PROJECT="{{{ project_0.project_id }}}" mkdir antigravity-projects cd antigravity-projects

2. 接著執行下列指令，建立包含 settings.json 設定檔的 .gemini 子目錄：

mkdir -p ~/.antigravity echo '{ "project": "{{{ project_0.project_id }}}", "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://{{{ project_0.startup_script.external_ip }}}:4318/v1/logs", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } }' > ~/.antigravity/settings.json

Antigravity CLI 已預先安裝在 Cloud Shell 中。

3. 為了開始與 Antigravity CLI 互動，請切換至 Cloud Shell 終端機中的「✦ Antigravity CLI」分頁。

首次使用 Antigravity CLI 時，系統可能會要求您選擇驗證方式。

4. 如果系統提示您選取驗證模式，請按 2 選擇「2. Use Cloud Shell user credentials」。如果系統未提示您進行驗證，也沒關係。您可以忽略這個步驟，繼續執行實驗室的操作。

順利完成驗證後，Antigravity CLI 便可開始接收指令。螢幕截圖範例如下：

在後續工作中，您將開始進一步操作模型，因此現在可先退出 Antigravity CLI。

5. 連按兩次 CTRL+D 或 CTRL+C，或發送 /quit 指令，即可退出 Antigravity CLI。

工作 2：與 Antigravity CLI 互動

在這項工作中，您將開始使用 Antigravity CLI。為確保本實驗室的評分功能穩定運作，請先安裝特定版本的 Antigravity CLI。接著，由於要在先前特別建立的專案專屬資料夾中開始操作，因此須啟動新的 Gemini 工作階段。

1. 在 Cloud Shell 發送下列指令，以全域方式安裝相關版本的 Antigravity CLI： npm install -g @google/antigravity-cli@0.6.1

注意：您可以在 Antigravity CLI 中使用 /model 指令嘗試其他模型。

在 Antigravity CLI 運作期間，您可以查看 Antigravity CLI 終端機右下方，確認當下執行的是哪一個模型，如下方螢幕截圖所示：

使用非互動模式

Antigravity CLI 還有個有趣的用法，就是以非互動模式執行。這表示您可以直接提供提示詞，Antigravity CLI 會回覆您，但不會開啟互動式終端機。如果您打算在指令碼或任何其他自動化程序中，以自動化的方式使用 Antigravity CLI，這項功能便可派上用場。

1. 結束工作階段 (連按兩次 CTRL+D 或 CTRL+C，或傳送 /quit 提示詞)。

2. 在 Cloud Shell 使用 -p 參數執行下列指令：

gemini -p "What is the gcloud command to deploy to Cloud Run?"

請注意，在非互動模式下，您無法透過追問來延續對話，也無法授權工具 (包括 WriteFile) 或執行殼層指令。

點選「Check my progress」，確認目標已達成。 使用 Gemini 非互動模式

工作 4：在殼層模式下使用 Antigravity CLI

您也可以直接在 Antigravity CLI 中使用殼層。

1. 使用下列指令再次啟動 Antigravity CLI：

gemini

2. 在提示詞輸入框按下 !，即可切換至殼層模式。

進入殼層模式後，提示詞開頭便會顯示 !，如下所示：

在殼層模式下，您可以直接使用標準指令，例如 pwd、cat 和 ls。

現在請試著透過 cat 指令，讓系統顯示檔案內容。

3. 對 Antigravity CLI 傳送下列提示詞： cat finance-news-today.txt

輸出內容範例：

4. 再次按下 !，或按 ESC 鍵，即可退出殼層模式。

點選「Check my progress」，確認目標已達成。 在殼層模式下使用 Antigravity CLI

工作 5：設定 Model Context Protocol (MCP) 伺服器

MCP 伺服器是應用程式，透過 Model Context Protocol 公開工具和資源，讓 Antigravity CLI 能夠與外部系統和資料來源互動，就像 Gemini 模型與本機環境或其他服務 (如 API) 之間的橋梁。

有了 MCP 伺服器，Antigravity CLI 就能探索及執行工具，進而擴充功能，執行內建功能以外的操作，例如與資料庫、API、自訂指令碼或專門的工作流程互動。

Antigravity CLI 支援設定 MCP 伺服器，以便探索及使用自訂工具。

1. 如果已啟動 Antigravity CLI，可以透過 /mcp 指令檢查設定的 MCP 伺服器，如下所示：

如果尚未設定任何 MCP 伺服器，系統會開啟 Antigravity CLI 的 MCP 伺服器說明文件。

您可以在 ~/.antigravity/settings.json 檔案或專案的根目錄中，於全域層級設定 MCP 伺服器。

如果 Antigravity CLI 正在執行，可以按 CTRL+D 或連按兩次 CTRL+C 來結束工作階段。

2. 在 Cloud Shell 終端機，點選工具列中的「開啟編輯器」，啟動 Cloud Shell 編輯器。
3. 系統預設會隱藏 .gemini 子目錄，因此請依序選取「View」>「Toggle hidden files」，顯示隱藏的檔案和目錄。
4. 在 Cloud Shell 編輯器中，前往專案專屬資料夾 antigravity-projects，然後開啟 ~/.antigravity/settings.json 檔案。

您必須在 ~/.antigravity/settings.json 檔案中設置 mcpServers 設定區塊，語法如下：

"mcpServers": { "server_name_1": {}, "server_name_2": {}, "server_name_n": {} }

您將在下一項工作中設定這個檔案，以支援 MCP 伺服器。

根據參考文件所述，每個伺服器設定都支援下列屬性：

必要 (下列其中一項)

• command (字串)：用於 Stdio 傳輸的執行檔路徑
• url (字串)：SSE 端點網址 (例如「http://localhost:8080/sse」)
• httpUrl (字串)：HTTP 串流端點網址

選用

• args (string[])：用於 Stdio 傳輸的指令列引數
• headers (物件)：使用 url 或 httpUrl 時的自訂 HTTP 標頭
• env (物件)：伺服器程序的環境變數。值可以使用 $$VAR_NAME 或 $${VAR_NAME} 語法來參照環境變數
• cwd (字串)：Stdio 傳輸的工作目錄
• timeout (數字)：要求逾時時間，以毫秒為單位 (預設值：600,000 毫秒 = 10 分鐘)
• trust (布林值)：如設為 true，系統會略過這個伺服器所有工具呼叫的確認步驟 (預設值：false)
• includeTools (string[])：要加入的 MCP 伺服器工具名稱清單。指定後，這個伺服器只會提供這裡列出的工具 (許可清單行為)。如未指定，系統預設會啟用伺服器的所有工具。
• excludeTools (string[])：要排除的 MCP 伺服器工具名稱清單。即使伺服器公開這裡列出的工具，模型也無法使用。請注意，excludeTools 的優先順序高於 includeTools。如果工具同時出現在這兩個清單中，系統會排除該工具。

注意：在繼續操作前，請務必留意，整合或連線至第三方 MCP 伺服器時應格外謹慎。為保護資訊及維護系統完整性，建議您只整合來源可靠且經過完整審查的 MCP 伺服器。

設定本機 Git MCP 伺服器

官方的模型上下文協定 (MCP) Git 伺服器 (git-mcp-server) 允許 Antigravity CLI 直接在本機儲存庫上執行 Git 版本控制操作。

在本節中，您將設定本機 Git 儲存庫並在 Antigravity CLI 的設定檔中設定 Git MCP 伺服器。

1. 在 Cloud Shell 編輯器整合終端機中，執行以下指令以建立並初始化範例 Git 儲存庫：

mkdir -p ~/event-talks-app cd ~/event-talks-app git init git config user.name "Student" git config user.email "student@qwiklabs.net" echo "# Event Talks App" > README.md git add README.md git commit -m "Initial commit"

2. 在終端機中執行以下指令以建立包含 git MCP 伺服器設定的 mcp_config.json：

mkdir -p ~/.antigravity ~/.gemini cat < ~/.antigravity/mcp_config.json { "mcpServers": { "git": { "command": "npx", "args": [ "-y", "git-mcp-server", "$HOME/event-talks-app" ], "trust": true } } } EOF cp ~/.antigravity/mcp_config.json ~/.gemini/mcp_config.json jq -s '.[0] * .[1]' ~/.antigravity/settings.json ~/.antigravity/mcp_config.json > temp.json && mv temp.json ~/.antigravity/settings.json cp ~/.antigravity/settings.json ~/.gemini/settings.json

3. 執行以下指令以啟動 Antigravity CLI：

agy

4. 要驗證 Git MCP 伺服器是否已載入且其工具是否已啟用，請輸入 /mcp 指令：

/mcp

/mcp 指令輸出顯示作用中的 git MCP 伺服器以及可用工具（例如 git_status、git_log、git_add 和 git_commit）。

注意：當 Antigravity CLI 提示請求權限時，請按 ENTER 鍵選擇 允許一次（或 總是允許）。

5. 提示 Antigravity CLI 檢查儲存庫狀態：

Check the git status of the repository at /home/student/event-talks-app using the git MCP server tools.

點選確認我的進度。 使用 Git MCP 工具驗證本機儲存庫

6. 現在提示 Antigravity CLI 新增新檔案並將變更提交到 Git：

Create a new file named talks.json in /home/student/event-talks-app with sample event schedule data, add it to git, and commit the changes with the message "Add talks schedule".

點選確認我的進度。 使用 Git MCP 工具建立提交

設定 GitHub MCP 伺服器後，您可以使用自然語言提出以下查詢，以便處理 GitHub 專案相關工作：

• <repo-name> 是什麼？
• 將 <repo-name> 複製到我的本機電腦。
• 說明 @<file-name> 或 @<directory-name>/
• 這個存放區有哪些不同的元件？
• 我已完成必要的變更。請使用 GitHub MCP 伺服器工具將變更推送至 GitHub。

• Firebase MCP 伺服器
• Google 生成式 AI 媒體服務 (Imagen、Veo、Lyria)
• MCP Toolbox for Databases (適用於 Firestore、BigQuery 和 Google Cloud 資料庫)
• Google Workspace MCP 伺服器 (適用於 Google 文件、試算表、日曆、Gmail)

如需這些 MCP 伺服器的設定操作說明，請參閱這篇網誌文章。

工作 6：使用 Antigravity CLI 進行直覺式程式開發

在這項工作中，您將使用 Antigravity CLI，透過直覺式程式開發打造網站，要求 Antigravity CLI 生成網站結構並完成設定。

注意：進行直覺式程式開發時，即使您的指令非常精確，模型有時可能還是會偏離指示、產生幻覺或陷入迴圈。如果模型卡住，請按下 Esc 鍵，並視需要以更新過的指令提示模型，或重複先前的指令。

1. 在 Antigravity CLI 中傳送下列提示詞：

請針對一場單日活動生成網站，當天將依序進行 6 場技術講座，每場 1 小時。每個講座都包含下列資訊：標題、1 位或最多 2 位講者、類別 (1 個或最多 3 個關鍵字)、時間長度和說明。網站只有一個頁面，可供使用者查看全天行程和詳細的時間安排。活動將於上午 10:00 開始，中間有 1 小時的午休時間。每場講座之間請預留 10 分鐘的過渡時間。我希望伺服器端使用 Node.js，前端則使用標準 HTML、JavaScript 和 CSS。使用者應能依類別搜尋講座。 請按照下列指示採取行動： 1. 規劃如何設計這個應用程式及編寫對應的程式碼。 2. 過程中如有任何不清楚的地方，請隨時向我確認。 3. 我確定沒問題後，請生成程式碼，並將網站編譯成一個無伺服器 HTML 檔案。 4. 提供執行及測試網站的操作說明 (透過簡單的 Python 伺服器提供 index.html 檔案，以便我在本機預覽)。

此時 Antigravity CLI 會開始執行一系列動作。

2. 如果模型要求您確認接下來應採取什麼行動，或詢問後續處理方式，請提供以下提示詞：

使用預留位置資料建立網站，並按照您的規劃建議採取行動。 注意：Antigravity CLI 可能會發生逾時或使用錯誤的使用者名稱等情況，請視需要與其互動並提供修正建議。

接下來呈現的幾個提示詞和回覆是我們觀察到的流程，只是參考範例。您實際上可能會得到完全不同的回覆。

您需視情況與 Antigravity CLI 來回互動。

有時 Antigravity CLI 會建議執行某個指令。為配合本實驗室的學習目標，您應該控制整個工作流程。

如果模型提議要執行某個指令，您可按下 Esc 鍵來略過，並透過訊息 (例如傳送以下提示詞) 重新引導模型採取特定做法：

按照操作說明啟動伺服器並前往首頁後，就會看到範例網站，如下所示 (如果您使用相同的提示詞，應該會看到類似網站的變化版本)：

您可以繼續使用 Antigravity CLI 進行其他變更。

• 建立存放區。
• 使用多個 Git 指令：init、add、commit 來管理本機 Git 存放區。
• 設定 Git 遠端並執行推送作業。

注意：Antigravity CLI 有時可能會發生逾時或使用錯誤的使用者名稱等情況，請視需要與其互動並提供修正建議。

如果 Antigravity CLI 在推送變更時遇到驗證相關問題，請提醒它使用 GitHub MCP 伺服器的工具。

如果一切順利，應該就會成功建立 GitHub 存放區。螢幕截圖範例如下：

做得好！您已在 Antigravity CLI 的協助下建立網站，並將變更推送至您建立的 GitHub 存放區。

注意：在本實驗室中，您並未為專案建立容易使用的 README.md 檔案，但在實際的正式環境中，還是建議您完成這項作業。如果您願意，可以請 Antigravity CLI 代為完成。

點選「Check my progress」，確認目標已達成。

恭喜！

太棒了！您已成功探索 Antigravity CLI、瞭解其功能，並在特定情境下實際應用。

後續步驟/瞭解詳情

• Antigravity CLI 公告貼文
• Antigravity CLI 專案首頁
• Antigravity CLI 說明文件

使用手冊上次更新日期：2025 年 10 月 16 日

實驗室上次測試日期：2025 年 10 月 16 日

Copyright 2026 Google LLC 保留所有權利。Google 和 Google 標誌是 Google LLC 的商標，其他公司和產品名稱則有可能是其關聯公司的商標。