实验设置说明和要求
保护您的账号和进度。请务必在无痕浏览器窗口中,使用实验凭证运行此实验。

直覺式程式開發與 Gemini CLI 入門

实验 1 小时 30 分钟 universal_currency_alt 3 积分 show_chart 入门级
info 此实验可能会提供 AI 工具来支持您学习。
此内容尚未针对移动设备进行优化。
为获得最佳体验,请在桌面设备上访问通过电子邮件发送的链接。

GSP1348

Google Cloud 自學實驗室標誌

總覽

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

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

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

課程內容

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

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

必備條件

本實驗室可完全在 Google Cloud Shell 中執行,該環境已預先安裝 Gemini 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」圖示 「啟動 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 鍵自動完成功能。

  1. (選用) 您可以執行下列指令來列出使用中的帳戶:
gcloud auth list
  1. 點按「授權」

輸出內容:

ACTIVE: * ACCOUNT: {{{user_0.username | "ACCOUNT"}}} To set the active account, run: $ gcloud config set account `ACCOUNT`
  1. (選用) 您可以使用下列指令來列出專案 ID:
gcloud config list project

輸出內容:

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

工作 1:根據需求設定 Gemini CLI

為 Gemini CLI 啟用 Cloud Logging

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

  • 在 Cloud Shell 執行下列指令,為 Gemini CLI 設定 Cloud Logging:
export ZONE=$(gcloud compute instances list \ --filter "name="lab-vm"" --format "value(zone.basename())") export EXTERNAL_IP=$(gcloud compute instances describe \ lab-vm --zone=$ZONE \ --format='get(networkInterfaces[0].accessConfigs[0].natIP)')

Gemini CLI 設定選項

Gemini CLI 的行為由設定檔和環境變數控制,主要透過以下兩個檔案設定:

  • .gemini/settings.json:這個檔案用來控管 CLI 的設定,包括如何連線至外部工具。

  • GEMINI.md:這個檔案為模型提供自然語言準則和背景資訊。CLI 會讀取這個檔案,瞭解專案的程式設計標準和慣例。

透過 settings.json 設定 Gemini CLI

使用 Cloud Shell 執行 Gemini 時,系統會直接幫您選取及設定 Gemini CLI 的預設主題和驗證方式。Gemini CLI 會使用 settings.json「記住」您的偏好設定,您也可以透過這個檔案自訂 Gemini CLI。

在 Cloud Shell 中,這個檔案位於下列目錄:

~/.gemini/settings.json

透過 GEMINI.md 設定 Gemini CLI

雖然 Gemini CLI 的某些行為可以透過 ~/.gemini/ 目錄中的 settings.json 檔案設定,但 GEMINI.md 檔案也可用來設定 Gemini CLI 的行為。

GEMINI.md 檔案是背景資訊檔案 (預設為 GEMINI.md,但可透過 settings.json 檔案中的 contextFileName 屬性設定)。如要設定提供給 Gemini 模型的指示背景資訊,就必須使用這個檔案。

您可以在這個檔案中提供專案專屬指示、程式設計樣式指南或任何相關背景資訊給 AI,確保 AI 的回覆更符合需求,也更準確。

GEMINI.md 檔案採用 Markdown 格式。

GEMINI.md 檔案包含哪些內容?以下是根據 Gemini CLI 官方說明文件製作的範例內容。

GEMINI.md 範例檔案:

# 專案:我的絕佳 TypeScript 程式庫 ## 一般指示: - 生成新的 TypeScript 程式碼時,請採用現有的程式設計樣式。 - 確保所有新函式和類別都有 JSDoc 註解。 - 視情況採用函式程式設計方法。 - 所有程式碼均須與 TypeScript 5.0 和 Node.js 20 以上版本相容。 ## 程式設計樣式: - 縮排使用 2 個空格。 - 介面名稱應須以「I」開頭 (例如「IUserService」)。 - 私有類別成員應以底線 (「_」) 開頭。 - 一律採用嚴格相等運算 (「===」和「!==」)。 ## 特定元件:「src/api/client.ts」 - 這個檔案負責處理所有傳出 API 要求。 - 新增 API 呼叫函式時,務必加入完善的錯誤處理和記錄功能。 - 對所有 GET 要求使用現有的「fetchWithRetry」公用程式。 ## 關於依附元件: - 除非絕對必要,否則請避免導入新的外部依附元件。 - 如果需要新的依附元件,請說明原因。

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

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

設置專案專屬設定

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

  1. 在 Cloud Shell 執行下列指令,建立範例資料夾 gemini-cli-projects,然後前往該資料夾:
mkdir gemini-cli-projects cd gemini-cli-projects
  1. 接著執行下列指令,建立包含 settings.json 設定檔的 .gemini 子目錄:
mkdir -p .gemini echo '{ "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://${EXTERNAL_IP}:4318/v1/logs", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } }' > .gemini/settings.json

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

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

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

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

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

Gemini CLI 執行個體範例

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

  1. 連按兩次 CTRL+D 或 CTRL+C,或發送 /quit 指令,即可退出 Gemini CLI。

工作 2:與 Gemini CLI 互動

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

  1. 在 Cloud Shell 發送下列指令,以全域方式安裝相關版本的 Gemini CLI: npm install -g @google/gemini-cli@0.6.1
注意:安裝程序應該會在 5 分鐘內完成。
  1. 執行下列指令,啟動 Gemini CLI 與新的工作階段:

    gemini
  2. 複製及貼上下列內容,然後按下 Enter 鍵,向 Gemini CLI 提出第一個查詢:

請提供一句關於人工智慧的名言,並說明出處。

預期的回覆如下。

輸出內容:

╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮ │ ✓ GoogleSearch 正在網路上搜尋「關於人工智慧的名言」 │ │ │ │ 已傳回「關於人工智慧的名言」的搜尋結果。 │ ╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯ ✦「人工智慧全面發展可能意味著人類的滅亡。」- 史蒂芬霍金。

您可能會注意到,執行剛才的查詢後,系統叫用了 Gemini CLI 的內建工具 GoogleSearch。本實驗室稍後會進一步介紹內建工具。

點選「Check my progress」,確認目標已達成。 與 Gemini CLI 互動

  1. 想快速瞭解 Gemini CLI 及其支援的各種指令嗎?只要輸入 /help (正斜線),即可查看各種指令和鍵盤快速鍵,如下所示:
/help 指令範例

/help 指令是斜線指令的一種。如要進一步瞭解這些內建的 Gemini CLI 指令,請參閱「斜線指令 (/)」說明文件。

工作 3:探索 Gemini CLI 內建工具

Gemini 模型會使用 Gemini CLI 內建的一組工具,與本機環境互動、存取資訊及執行動作。這些工具讓 CLI 的功能變得更加強大,不僅能生成文字,還可協助使用者處理各種工作。

詳情請參閱工具說明文件

  • 您可以叫用 /tools 指令,取得目前可用的內建工具清單: /tools

輸出內容範例:

ℹ Available Gemini CLI tools: - Edit - FindFiles - GoogleSearch - ReadFile - ReadFolder - ReadManyFiles - Save Memory - SearchText - Shell - WebFetch - WriteFile

Gemini CLI 能在需要時直接呼叫這些工具嗎?簡單來說,答案是不行。根據預設,如需執行可能涉及寫入本機系統、從外部系統讀取資料、連線至外部網路等敏感作業,模型一律會先要求權限。

雖然啟動 CLI 時可以使用 --yolomode (通常不建議),但 Gemini CLI 選定要執行的工具後,可能會提示您授予執行權限。您可以拒絕授權、僅允許執行一次,或全面授權,選擇一律允許 Gemini CLI 執行該工具。一切操作都由您掌控,您應該保有完整的控制權。

提示 CLI 使用內建工具

在本節中,您將傳送提示詞,讓 Gemini CLI 選擇並執行其中一項內建工具,以便進一步瞭解整個運作方式。

假設您想取得全球最新的財經新聞,並將該資訊儲存至本機工作目錄 (也就是您啟動 Gemini CLI 的位置) 的檔案中。

  1. 對 Gemini CLI 傳送下列提示詞:
搜尋今天財經領域的最新頭條新聞,並將結果儲存至名為 finance-news-today.txt 檔案

首先,Gemini CLI 會叫用 GoogleSearch 工具來搜尋網路。

正在叫用的 GoogleSearch 工具

搜尋完畢後,便會擷取資料,如下所示:

GoogleSearch 工具的搜尋結果

完成後,Gemini CLI 就可以使用 WriteFile 工具將內容寫入檔案,但這屬於敏感作業 (寫入),因此系統會要求您授予權限。您可以決定權限類型,即「僅允許一次」、「一律允許」等。

  1. 直接按下 Enter 鍵,暫時選擇僅允許一次
WriteFile 工具的輸出內容

接著,系統會將資訊寫入檔案,並顯示成功訊息 (如下所示)。

預期的輸出內容:

✦ 我已將最新的財經頭條新聞儲存至 finance-news-today.txt。

如要確認檔案是否已寫入,可以使用 @file 要求系統讀取內容。輸入 @ 時,系統會顯示目前資料夾中的檔案清單,包括剛建立的檔案。

注意:如要使用 Flash 模型,可以在 Cloud Shell 執行下列指令,指定 -m 參數,並在後面加上模型名稱:

gemini -m "gemini-2.5-flash"

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

Gemini CLI 的模型名稱

使用非互動模式

Gemini CLI 還有個有趣的用法,就是以非互動模式執行。這表示您可以直接提供提示詞,Gemini CLI 會回覆您,但不會開啟互動式終端機。如果您打算在指令碼或任何其他自動化程序中,以自動化的方式使用 Gemini 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:在殼層模式下使用 Gemini CLI

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

  1. 使用下列指令再次啟動 Gemini CLI:
gemini
  1. 在提示詞輸入框按下 !,即可切換至殼層模式。

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

殼層模式已啟用

在殼層模式下,您可以直接使用標準指令,例如 pwdcatls

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

  1. 對 Gemini CLI 傳送下列提示詞: cat finance-news-today.txt

輸出內容範例:

cat 指令輸出內容範例
  1. 再次按下 !,或按 ESC 鍵,即可退出殼層模式。

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

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

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

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

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

  1. 如果已啟動 Gemini CLI,可以透過 /mcp 指令檢查設定的 MCP 伺服器,如下所示:
叫用的 /mcp 指令

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

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

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

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

您必須在 ~/.gemini/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 伺服器。

設定 GitHub MCP 伺服器

GitHub 官方 MCP 伺服器有完整的說明文件,說明公開的工具和該伺器的設定方式。Gemini CLI 也支援遠端 MCP 伺服器,因此您可以選擇在本機或遠端執行該伺服器。

在本節中,您將設定 GitHub 的遠端 MCP 伺服器。為此,您必須先取得 GitHub 的個人存取權杖 (PAT)

接著,您需要在 settings.json 檔案中新增 MCP 伺服器物件,指向 GitHub MCP 伺服器設定。

建立傳統版 GitHub PAT

在本節中,您將建立傳統版 GitHub PAT、將權杖效期設為永不過期,並授予所有可用權限。

  1. 前往 GitHub 的「Developer Settings」頁面,展開「Personal access tokens」下拉式選單,然後選擇「Tokens (classic)」
  2. 點選「Generate new token」,然後在下拉式選單中選取「Generate new token (classic)」
  3. 在「Note」欄位中輸入權杖的專屬名稱,並將「Expiration」設為「No expiration」,然後勾選「Select scopes」底下的核取方塊,授予所有可用的權限。
  4. 點選「Generate token」
  5. 點選「複製」(⧉) 圖示,將權杖複製到剪貼簿並加以儲存,以供日後使用。

如需詳細說明,請參閱以下 GitHub 說明文件,瞭解如何建立自己的 PAT:Creating a personal access token (classic) (建立傳統版個人存取權杖)。

繼續設定 GitHub MCP 伺服器

  1. 在 Cloud Shell 執行下列指令,以便在 Cloud Shell 編輯器中開啟 settings.json 檔案:

    edit .gemini/settings.json
  2. 編輯 settings.json 檔案 (目前的內容應如下所示):

    { "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://${EXTERNAL_IP}:4318/v1/logs", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } }
  3. 接著,將 "Bearer " 後的 [placeholder] 部分改成您的 PAT,並在檔案頂端的第一個大括號後插入下列 JSON:

"theme": "Default", "mcpServers": { "github": { "httpUrl": "https://api.githubcopilot.com/mcp/", "trust": false, "headers": { "Authorization": "Bearer [replace-with-your-github-PAT]" } } },

settings.json 中可能還有其他設定,但最終結果的格式應大致如下:

{ "theme": "Default", "mcpServers": { "github": { "httpUrl": "https://api.githubcopilot.com/mcp/", "trust": false, "headers": { "Authorization": "Bearer [replace-with-your-github-PAT]" } } }, "telemetry": { "enabled": true, "target": "gcp", "otlpEndpoint": "http://${EXTERNAL_IP}:4318/v1/logs", "otlpProtocol": "http", "logPrompts": true, "useCollector": true } }
  1. 點選工具列中的「開啟終端機」,回到 Cloud Shell 終端機,然後執行下列指令,啟動 Gemini CLI 並在啟動時載入更新後的 settings.json 檔案,藉此啟用設定的 GitHub MCP 伺服器:
gemini
  1. 傳送 /mcp 提示詞,確認 MCP 伺服器是否已設定成功並可使用。

下方的螢幕截圖以醒目方式顯示某部機器上設定的 GitHub MCP 伺服器,以及 Gemini CLI 現在可用來操作 MCP 的各種工具。

輸出內容範例:

已設定的 MCP 伺服器清單輸出內容

接著,您將傳送提示詞,叫用 GitHub MCP 伺服器的某項工具。

  1. 輸入下列提示詞:
我在 GitHub 的身分是?

預期的輸出內容:

叫用的「我在 GitHub 的身分是?」指令

請注意,系統會選擇合適的 GitHub MCP 伺服器工具,但與其他內建工具一樣,您必須明確授予權限,才能叫用該工具。

  1. 按下 Enter 鍵,選擇「1. Yes, allow once」,這樣 GitHub 伺服器的「get_me」工具就能執行查詢。
注意:在本例中,您必須選擇「Yes, allow once」,才能取得這項工作的分數。

點選「Check my progress」,確認目標已達成。 詢問「我在 GitHub 的身分是?」

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

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

其他 MCP 伺服器

以下列出您可能會感興趣的其他 MCP 伺服器:

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

工作 6:使用 Gemini CLI 進行直覺式程式開發

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

注意:進行直覺式程式開發時,即使您的指令非常精確,模型有時可能還是會偏離指示、產生幻覺或陷入迴圈。如果模型卡住,請按下 Esc 鍵,並視需要以更新過的指令提示模型,或重複先前的指令。
  1. 在 Gemini CLI 中傳送下列提示詞:
請針對一場單日活動生成網站,當天將依序進行 6 場技術講座,每場 1 小時。每個講座都包含下列資訊:標題、1 位或最多 2 位講者、類別 (1 個或最多 3 個關鍵字)、時間長度和說明。網站只有一個頁面,可供使用者查看全天行程和詳細的時間安排。活動將於上午 10:00 開始,中間有 1 小時的午休時間。每場講座之間請預留 10 分鐘的過渡時間。我希望伺服器端使用 Node.js,前端則使用標準 HTML、JavaScript 和 CSS。使用者應能依類別搜尋講座。 請按照下列指示採取行動: 1. 規劃如何設計這個應用程式及編寫對應的程式碼。 2. 過程中如有任何不清楚的地方,請隨時向我確認。 3. 我確定沒問題後,請生成程式碼,並將網站編譯成一個無伺服器 HTML 檔案。 4. 提供執行及測試網站的操作說明 (透過簡單的 Python 伺服器提供 index.html 檔案,以便我在本機預覽)。

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

  1. 如果模型要求您確認接下來應採取什麼行動,或詢問後續處理方式,請提供以下提示詞:
使用預留位置資料建立網站,並按照您的規劃建議採取行動。 注意:Gemini CLI 可能會發生逾時或使用錯誤的使用者名稱等情況,請視需要與其互動並提供修正建議。

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

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

計畫輸出內容範例

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

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

要求模型只提供操作說明的提示詞

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

講座活動網站的輸出內容範例

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

將變更推送至 GitHub 存放區

確定網站符合需求後,在本節中,您將透過在工作 5 設定的遠端 GitHub MCP 伺服器,將變更推送至您建立的 GitHub 存放區。

首先,請運用 Gemini CLI 建立 .gitignore 檔案。

  1. 向 Gemini CLI 傳送下列提示詞:
為這項專案建立 .gitignore 檔案。

接下來,您將指示 Gemini CLI 透過 GitHub 帳戶推送這個存放區 (這項操作應會在背景使用 GitHub MCP 伺服器工具)。

  1. 傳送類似以下內容的提示詞 (務必將 [Your-name] 預留位置改成您的名稱):
太棒了!現在請使用 GitHub MCP 伺服器和「push_files」工具,將這個存放區推送至我 GitHub 帳戶中的新存放區。務必使用為 GitHub MCP 伺服器設定的個人存取權杖 (PAT),透過 HTTPS 向 GitHub 驗證,並將這個存放區命名為 [Your-Name]-event-talks-app。

Gemini CLI 此時會執行一連串指令:

  • 建立存放區。
  • 使用多個 Git 指令:init、add、commit 來管理本機 Git 存放區。
  • 設定 Git 遠端並執行推送作業。
注意:Gemini CLI 有時可能會發生逾時或使用錯誤的使用者名稱等情況,請視需要與其互動並提供修正建議。

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

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

GitHub 範例存放區輸出內容

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

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

點選「Check my progress」,確認目標已達成。 將變更推送至 GitHub 存放區

恭喜!

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

後續步驟/瞭解詳情

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

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

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

准备工作

  1. 实验会创建一个 Google Cloud 项目和一些资源,供您使用限定的一段时间
  2. 实验有时间限制,并且没有暂停功能。如果您中途结束实验,则必须重新开始。
  3. 在屏幕左上角,点击开始实验即可开始

使用无痕浏览模式

  1. 复制系统为实验提供的用户名密码
  2. 在无痕浏览模式下,点击打开控制台

登录控制台

  1. 使用您的实验凭证登录。使用其他凭证可能会导致错误或产生费用。
  2. 接受条款,并跳过恢复资源页面
  3. 除非您已完成此实验或想要重新开始,否则请勿点击结束实验,因为点击后系统会清除您的工作并移除该项目

此内容目前不可用

一旦可用,我们会通过电子邮件告知您

太好了!

一旦可用,我们会通过电子邮件告知您

一次一个实验

确认结束所有现有实验并开始此实验

使用无痕浏览模式运行实验

请使用无痕模式或无痕式浏览器窗口运行此实验。这可以避免您的个人账号与学生账号之间发生冲突,这种冲突可能导致您的个人账号产生额外费用。