在工作區中設定 Gemini

Firebase Studio 提供下列 AI 輔助程式碼功能，可簡化開發工作流程：

  • 在您輸入時提供程式碼補全建議。

  • AI 輔助對話功能，可感知工作區，並與程式碼完全整合。可生成、翻譯及說明程式碼。經您審查並核准後，Gemini 可直接與工作區互動，更新檔案、執行終端機指令、解讀指令輸出，以及決定後續步驟。詳情請參閱「在 Firebase Studio 中試用 Gemini 聊天功能」。

  • 可對所選程式碼片段執行的內嵌動作。例如，您可以要求 Gemini 讓所選程式碼更易於閱讀。

  • 內嵌程式開發輔助。

您可以調整設定並新增 AI 規則檔案，自訂 Gemini 的協助方式：

在工作區中使用 Gemini

使用 Gemini，透過對話面板、終端機或內嵌程式碼輔助功能，提高程式碼編寫效率。

  1. 在工作區中使用對話或內嵌程式開發輔助功能：

    • 如要使用對話功能，請在開啟的工作區中，按一下工作區底部的「spark」圖示 Gemini。

    • 如要使用內嵌程式開發輔助功能，請開始輸入程式碼，然後按下 Tab 接受建議。

  2. 請注意，系統預設會啟用下列兩個選項：

    • 輸入時提供建議：提供內嵌程式碼補全功能。
    • 程式碼集索引：提供更完善的自訂功能和更實用的回覆。

    日後如要變更工作區設定，請按照下列步驟操作：

    您也可以將特定檔案和目錄排除在 AI 索引範圍之外。請參閱「使用 .aiexclude 檔案從 Gemini 排除檔案」。

Gemini 個捷徑

如要快速開啟與Gemini的對話，請按下 Ctrl+Shift+Space (在 macOS 上為 Cmd+Shift+Space)。

如要從指令面板查看 Gemini 指令，請按照下列步驟操作：

  1. 按下 Ctrl+Shift+P (在 macOS 上為 Cmd+Shift+P) 開啟指令面板。

  2. 搜尋 Gemini。

    系統會顯示 Gemini 指令清單。

調整程式碼補全設定

為協助您編寫程式碼，Firebase Studio 提供 AI 程式碼補全功能，可在您開始輸入時，預測並自動填入任何開啟檔案中的程式碼。

請注意，程式碼完成功能預設為開啟。

如要開啟或關閉程式碼補全功能，請使用下列任一方法調整程式碼補全設定：

  • 如果使用 settings.json 檔案，請將 "IDX.aI.enableInlineCompletion" 設為 true 或 false。

  • 如要更新「Firebase Studio」工作區的設定，請按照下列步驟操作：

    1. 按一下 齒輪圖示「Manage」(管理) (位於工作區左下方)，然後選擇「Settings」(設定)，或按下 Ctrl+, (Mac 則為 Cmd+,)。

      如果您在 Prototyper 檢視畫面中使用 App Prototyping agent，請按一下 程式碼切換圖示「Switch to Code」，開啟 Code 檢視畫面。

    2. 選取「Workspace」分頁標籤，然後搜尋「Firebase Studio > AI > Enable Inline Completion」設定。

    3. 如要關閉程式碼補全功能，請取消選取「Enable inline code completion as you type」選項。

調整程式碼集索引設定

您可以控管 Gemini 是否要為程式碼建立索引。 為程式碼建立索引後，使用對話或內嵌 AI 輔助功能時，就能獲得更實用的結果。

請注意，程式碼集索引功能預設為開啟。

如要開啟或關閉程式碼索引功能，請使用下列任一方法調整程式碼集索引設定：

  • 如果使用 settings.json 檔案，請將 "IDX.aI.enableCodebaseIndexing" 設為 true 或 false。

  • 如要更新「Firebase Studio」工作區的設定，請按照下列步驟操作：

    1. 按一下工作區左下方的 齒輪圖示「Manage」(管理)，然後選擇「Settings」(設定)，或按下 Ctrl+, (Mac 則為 Cmd+,)。

      如果您在 Prototyper 檢視畫面中使用 App Prototyping agent，請按一下 程式碼切換圖示「Switch to Code」，開啟 Code 檢視畫面。

    2. 選取「Workspace」分頁標籤，然後搜尋「Firebase Studio > AI > 自動完成程式碼」設定。

    3. 依序選取「Firebase Studio」>「AI: Enable Codebase Indexing」(AI：啟用程式碼集索引)。

    4. 如要關閉程式碼索引功能，請取消選取「AI: Enable Codebase Indexing」。您必須更新每個工作區的程式碼索引設定。

使用 AI 規則檔案自訂 Gemini 的指令

您可以建立 AI 規則檔案，新增背景資訊和系統提示資訊：

Gemini 聊天室會優先使用 .idx/airules.md，但如果 .idx/airules.md 不存在，則會使用 GEMINI.md。

Gemini 會將規則視為系統指令和情境，根據您的用途自訂回覆。

您可以使用 AI 規則檔案，與 Gemini 分享自訂提示、最佳做法，甚至是專案的重要背景資訊，以達成下列目標：

  • 影響 Gemini 的人物設定，並專精其專業知識。
  • 套用專案層級標準，例如程式碼樣式、慣例和技術偏好。
  • 提供專案的重要背景資訊，減少您在程式碼或對話中明確分享的資訊量。

建立及測試 AI 規則檔案

如要建立及測試 AI 規則檔案，請按照下列步驟操作：

  1. 在 Firebase Studio 工作區的 .idx/airules.md (或 GEMINI.md) 建立新檔案。您可以使用下列任一選項：

    • 在「Explorer」(Ctrl+Shift+E) 中，對上層目錄按一下滑鼠右鍵，然後選取「New file」。為檔案命名，然後按下 Enter 鍵。
    • 在終端機中，使用偏好的文字編輯器開啟 GEMINI.md 或 .idx/airules.md。

  2. 在檔案中新增內容。您可以新增 Gemini 應使用的角色資訊 (例如「您是專業開發人員和得力助手，對 Next.js 瞭若指掌」)、程式設計和對話標準，以及專案背景資訊。如需 AI 規則檔案範例，請參閱下方的範例。

  3. 儲存檔案並開啟 Gemini。

  4. 如要開始使用 AI 規則，請採取下列任一做法：

    • 重新整理頁面，重建工作區。重建後，Gemini 會在對話中使用規則檔案。AI 規則檔案的變更應會立即生效。
    • 如果不想重建工作區，可以要求 Gemini load GEMINI.md或load airules.md。如果您在目前的工作階段中變更檔案，可能需要重新提示 Gemini，再次載入規則檔案。

  5. 詢問程式碼相關問題。Gemini 會根據您在規則檔案中提供的資訊，生成回覆。

    Gemini 會依優先順序使用 .idx/airules.md、GEMINI.md、.gemini/styleguide.md、AGENTS.md 或 cursorrules。

範例

以下是規則檔案的基本範例，可用於以 Next.js 開發的休閒遊戲：

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

排除「Gemini」中含有 .aiexclude 的檔案

您可以在專案中加入 .aiexclude 檔案，控管程式碼集中哪些檔案不應向 Gemini 顯示。這樣一來，您就能精細控管與 Gemini 共用的專案背景資訊。

.aiexclude 檔案與 .gitignore 檔案類似，會追蹤不應與 Gemini 共用的檔案，包括對話體驗，以及在編輯器中運作的 AI 功能。.aiexclude 檔案會對所在目錄或其子目錄中的檔案執行操作。

啟用程式碼集索引時，Gemini 不會為 .aiexclude 涵蓋的檔案建立索引。此外，.aiexclude 會以下列方式影響涵蓋檔案的內嵌輔助功能：

  • 即時通訊協助：Gemini 無法回答 .aiexclude 涵蓋檔案的問題，或提供相關建議。
  • 程式碼補全：編輯涵蓋的檔案時，系統不會提供建議的程式碼補全。
  • 內嵌輔助：編輯涵蓋的檔案時，您可以生成新程式碼，但無法修改現有程式碼。

Android Studio 等其他開發環境也可能遵循 .aiexclude 檔案。

如何編寫 .aiexclude 檔案

.aiexclude 檔案的語法與 .gitignore 檔案相同，但有下列差異：

  • 空白的 .aiexclude 檔案會封鎖其目錄和所有子目錄中的所有檔案。這與包含 **/* 的檔案相同。
  • .aiexclude 檔案不支援否定 (在模式前加上 !)。

範例

以下是 .aiexclude 檔案設定範例：

  • 封鎖含有 .aiexclude 檔案的目錄或其子目錄中，所有名為 apikeys.txt 的檔案：

    apikeys.txt

  • 封鎖含有 .aiexclude 檔案的目錄或其子目錄中，所有副檔名為 .key 的檔案：

    *.key

  • 僅封鎖與 .aiexclude 位於同一目錄中的 apikeys.txt 檔案，但不封鎖任何子目錄：

    /apikeys.txt

  • 封鎖 my/sensitive/dir 目錄和所有子目錄中的檔案。路徑應相對於包含 .aiexclude 檔案的目錄：

    my/sensitive/dir/

自備金鑰：在對話中使用其他 Gemini 模型

您可以設定 Gemini 對話使用的 Gemini 模型。您可以選擇內建模型、在對話視窗中設定的模型，或任何您有權存取的 Gemini 模型。

如需所有可用模型的清單，請參閱「Gemini 模型」。

如要設定金鑰並選取其他 Gemini 模型，請按照下列步驟操作：

  1. 在開啟的工作區中，按一下工作區底部的「spark」Gemini (或「Gemini」分頁)。

  2. 在 Gemini 對話視窗中，按一下 AI 設定 圖示「AI Settings」(AI 設定)。系統會顯示「User Settings」。

  3. 在「IDX > AI: Gemini Api Key」欄位中，輸入 Gemini API 金鑰。

  4. 在「IDX」>「AI: Model Provider」 下拉式選單中，選取「Gemini API」。

您現在可以在對話中選取任何預先設定的 Gemini 模型。

如要設定下拉式選單中沒有的 Gemini 模型，請按照下列步驟操作：

  1. 從 Gemini 模型清單中，找出要在對話中使用的 Gemini 模型。舉例來說，如要使用 Gemini 3 Pro Preview 預先發布版模型，請輸入 gemini-3-pro-preview。

  2. 在 Gemini 聊天視窗中，按一下模型選取器，然後選擇「Custom model ID」(自訂模型 ID)。「User Settings」(使用者設定) 隨即開啟。

  3. 將選取的模型名稱複製到「IDX > AI: Gemini 模型」欄位。

  4. 關閉對話視窗，然後點選工作區底部的「Spark」圖示 Gemini 重新開啟，即可重新整理模型清單。

後續步驟