在工作區中設定 Gemini in Firebase

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

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

  • 透過對話取得 AI 輔助，這項功能可辨識工作區，並與程式碼完全整合。可生成、翻譯及說明程式碼。經過您的審查和核准，Firebase 中的 Gemini 就能直接與工作區互動，更新檔案、執行終端機指令、解讀指令輸出內容，以及判斷後續步驟。詳情請參閱「與 Gemini 對話」。

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

  • 內嵌程式碼輔助功能。

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

在工作區中使用 Gemini Firebase

在 Firebase 中使用 Gemini，透過聊天面板或行內程式碼輔助功能，提升程式碼編寫效率。

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

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

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

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

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

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

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

Gemini 版 Firebase 捷徑

如要快速開啟與 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 中使用 Prototyper view, click Code switch icon Switch to Code to open Code view.

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

    3. 如要關閉程式碼完成功能，請取消選取「在你輸入時啟用內嵌程式碼完成功能」選項。

調整程式碼庫索引設定

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

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

.aiexclude

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

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

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

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

      如果您在 App Prototyping agent 中使用 Prototyper view, click Code switch icon Switch to Code to open Code view.

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

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

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

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

您可以建立 AI 規則檔案 (.idx/airules.md) 來新增背景資訊和系統提示資訊。Firebase 中的 Gemini 會將您的規則視為系統指令和背景資訊，確保生成的回覆符合您的用途。

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

  • 影響 Gemini 的角色，並專精於其專業知識。
  • 套用專案層級標準，例如程式設計風格、慣例和技術偏好。
  • 提供專案的基本背景資訊，減少您需要在程式碼或即時通訊中明確分享的資訊量。

Gemini 會在即時通訊中使用您設定的規則。

建立及測試 AI 規則檔案

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

  1. 在 Firebase Studio 工作區的 .idx/airules.md 中建立新檔案 (與 dev.nix 檔案位於同一目錄)。你可以使用下列任一選項：

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

  2. 在檔案中加入內容。您可以新增有關應使用的角色資訊 (例如「您是 Next.js 專家開發人員和實用助理，對 Next.js 無所不知」)、程式碼和對話標準，以及專案背景資訊。Gemini請參閱以下範例，瞭解 AI 規則檔案範例。

  3. 儲存檔案並在 Firebase 中開啟 Gemini。

  4. 如要開始使用 AI 規則，請執行下列其中一項操作：

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

  5. 詢問程式碼相關問題。Gemini 會使用您在規則檔案中提供的資訊做為背景資訊，然後生成回覆。

範例

以下是規則檔案的基本範例，您可能會用於以 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 模型

你可以設定 Gemini 模型，供 Gemini 版 Firebase Chat 使用。您可以選擇內建模型、在對話視窗中設定的模型 (包括 Gemini 2.5 模型)，或是您有權存取的任何 Gemini 模型。

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

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

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

  2. 在 Gemini 的 Firebase 對話視窗中，按一下模型名稱下拉式選單，然後按一下「Gemini API 金鑰」連結。畫面上會顯示「使用者設定」。

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

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

如要設定下拉式選單中未列出的 Gemini 模型：

  1. 在Gemini 模型清單中，找出要在對話中使用的 Gemini 模型。舉例來說，輸入 gemini-2.0-flash-lite 即可使用最新的穩定版 Gemini 2.0 Flash‑Lite 模型。

  2. 在 Gemini 的 Firebase 聊天視窗中， 按一下模型選取器，然後選擇「自訂模型 ID」。開啟「使用者設定」。

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

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

後續步驟