在工作區中設定 Gemini

Firebase Studio 提供下列 AI 輔助程式碼功能，協助您完成開發工作流程：

  • 在您輸入時建議程式碼完成。

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

  • 可對所選程式碼片段執行的內嵌動作。舉例來說，你可以要求 Gemini 讓所選程式碼更容易閱讀。

  • 內嵌程式碼輔助功能。

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

在工作區中使用 Gemini

透過聊天面板、終端機或行內程式碼輔助功能，使用 Gemini 提升程式碼編寫效率。

程式碼切換圖示

  1. 在工作區中使用即時通訊或內嵌程式碼輔助功能：

    • 如要使用即時通訊：在開啟的工作區中，按一下工作區底部的「火花」圖示 Gemini。

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

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

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

    如要在日後變更工作區設定的這些選項，請按照下列步驟操作：

    您也可以排除特定檔案和目錄，不讓 AI 建立索引。請參閱「排除 Gemini 中的 .aiexclude 檔案」。

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. 按一下「管理」齒輪圖示 (位於工作區左下方)，然後選擇「設定」，或按下 Ctrl+, 鍵 (Mac 上的 Cmd+, 鍵)。

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

    2. 選取「Workspace」分頁標籤，然後依序搜尋「Firebase Studio」>「AI」>「啟用行內完成」設定。

    3. 如要關閉程式碼補全功能，請取消選取「在輸入時啟用行內程式碼補全功能」選項。

調整程式碼庫索引設定

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

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

.aiexclude

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

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

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

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

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

    2. 選取「Workspace」分頁標籤，然後依序搜尋 Firebase Studio >「AI」>「啟用行內完成」設定。

    3. 依序選取 Firebase Studio >「AI: Enable Codebase Indexing」。

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

使用 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) 建立新檔案。你可以使用下列任一選項：

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

  2. 在檔案中新增內容。您可以新增有關角色應使用的資訊 (例如「您是 Next.js 專家，也是無所不知的實用助理」)、程式碼和對話標準，以及專案的背景資訊。Gemini請參閱以下「範例」，瞭解 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 分享的專案內容。

與 .gitignore 檔案類似，.aiexclude 檔案會追蹤不應與 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 模型

您可以設定 GeminiGemini 模型，供即時通訊使用。您可以選擇內建模型、在即時通訊視窗中設定的模型，或是您有權存取的任何 Gemini 模型。

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

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

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

  2. 在 Gemini 聊天視窗中，按一下「AI 設定」AI 設定 圖示。畫面會顯示「使用者設定」。

  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 聊天視窗中，點選模型選取器，然後選擇「自訂模型 ID」。「使用者設定」隨即開啟。

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

  4. 關閉即時通訊視窗，然後按一下工作區底部的 spark Gemini 重新開啟，即可重新整理模型清單。

後續步驟