Firebase Studio 提供下列 AI 輔助程式碼功能，協助您簡化開發工作流程：
在您輸入程式碼時提供建議的程式碼完成功能。
透過即時通訊提供 AI 輔助功能，這項功能可偵測工作區，並與您的程式碼完全整合。可產生、翻譯及說明程式碼。經過您的審查和核准後，Firebase 中的 Gemini 就能直接與工作區互動，更新檔案、執行終端機指令、解讀指令輸出內容，並決定後續步驟。如要進一步瞭解，請參閱「試試與 Gemini 進行即時通訊」一文。
您可對所選程式碼片段採取的內嵌動作。例如，您可以要求 Gemini 讓所選程式碼更易讀。
內嵌程式碼輔助功能。
您可以調整設定並新增 AI 規則檔案，自訂 Firebase 中的 Gemini 協助功能：
- 調整程式碼完成設定。
- 調整程式碼庫索引設定。
- 使用 AI 規則檔案自訂 Gemini 的操作說明。
- 使用
.aiexclude檔案排除 Gemini 中的檔案。 - 自備金鑰：在聊天中使用其他 Gemini 模型
在 Workspace 中使用 Firebase 中的 Gemini
在 Firebase 中使用 Gemini，透過對話方塊或內嵌程式碼輔助功能，提升程式碼編寫效率。
在工作區中使用即時通訊或內嵌程式碼輔助功能：
如何使用聊天功能：在已開啟的工作區中，按一下工作區底部的「火花」圖示 Gemini。
如要使用內嵌程式碼輔助功能：開始輸入程式碼，然後按下
Tab接受建議。
請注意，下列兩個選項預設為啟用：
- 輸入時顯示建議，提供內嵌程式碼完成功能。
- 程式碼庫索引：提供更完善的自訂選項和更實用的回覆。
如要日後變更工作區設定的這些選項，請按照下列步驟操作：
您也可以將特定檔案和目錄排除在 AI 索引之外。請參閱使用
.aiexclude檔案排除 Gemini 中的檔案。
Gemini 版 Firebase 捷徑
如要快速開啟與 Gemini 的即時通訊：按下 Ctrl+Shift+Space (或在 macOS 上按下 Cmd+Shift+Space)。
如要透過指令面板查看 Gemini 指令，請按照下列步驟操作：
按下
Ctrl+Shift+P(在 macOS 上為Cmd+Shift+P) 開啟指令面板。搜尋 Gemini。
畫面上會顯示 Gemini 指令清單。
調整程式碼補全設定
為了協助您編寫程式碼，Firebase Studio 提供 AI 程式碼補全功能，只要您開始輸入內容，系統就會預測並自動填入任何開啟檔案中的程式碼。
請注意，程式碼完成功能預設為開啟。
如要開啟或關閉程式碼完成功能，請使用下列任一方法調整程式碼完成設定：
如果您使用
settings.json檔案，請將"IDX.aI.enableInlineCompletion"設為true或false。如要更新 Firebase Studio 工作區中的設定，請按照下列步驟操作：
按一下
「管理」 (位於工作區左下方)，然後選擇「設定」，或按下 Ctrl+,鍵 (Mac 為Cmd+,)。如果您在 Prototyper view, click
Switch to Code to open Code view. 中使用 App Prototyping agent選取「Workspace」分頁，然後搜尋「Firebase Studio」>「AI」>「啟用內嵌完成功能」設定。
如要關閉程式碼完成功能，請取消選取「在您輸入時啟用內嵌程式碼完成功能」選項。
調整程式碼庫索引設定
您可以控制 Gemini 是否為程式碼建立索引。為程式碼建立索引後，使用即時通訊或內嵌 AI 協助功能時，系統就能提供更實用的結果。
請注意，程式碼庫索引功能預設為開啟。
如要開啟或關閉程式碼索引，請使用下列任一方法調整程式碼庫索引設定：
如果您使用
settings.json檔案，請將"IDX.aI.enableCodebaseIndexing"設為true或false。如要更新 Firebase Studio 工作區中的設定，請按照下列步驟操作：
按一下
「管理」 (位於工作區左下方)，然後選擇「設定」，或按下 Ctrl+,(Mac 為Cmd+,)。如果您在 Prototyper view, click
Switch to Code to open Code view. 中使用 App Prototyping agent選取「Workspace」分頁標籤，然後搜尋「Firebase Studio」>「AI」>「啟用內嵌完成」設定。
依序選取 Firebase Studio >「AI：啟用 Codebase 索引」。
如要關閉程式碼索引功能，請取消選取「AI：啟用程式碼集索引」。您必須為每個工作區更新程式碼索引設定。
使用 AI 規則檔案，在 Firebase 中為 Gemini 自訂指示
您可以建立 AI 規則檔案 (.idx/airules.md)，加入脈絡和系統提示資訊。Firebase 中的 Gemini 會將您的規則用作系統指示和脈絡，確保回覆能根據您的用途進行自訂。
您可以使用 AI 規則檔案，與 Gemini 分享專案的自訂提示、最佳做法，甚至是重要背景資訊，以達成下列目標：
- 影響 Gemini 的角色，並專注於其專業知識。
- 套用專案層級標準，例如程式設計風格、慣例和技術偏好設定。
- 提供專案的必要背景資訊，減少您需要在程式碼或即時通訊中明確分享的資訊量。
您設定的規則會在 Chat 中由 Gemini 使用。
建立及測試 AI 規則檔案
如要建立及測試 AI 規則檔案，請按照下列步驟操作：
在 Firebase Studio 工作區的
.idx/airules.md中建立新檔案 (位於dev.nix檔案所在的目錄)。您可以使用下列任一選項：- 在「Explorer」 (
Ctrl+Shift+E) 中，按一下 .idx 並選取「New file」。將檔案命名為airules.md，然後按下 Enter 鍵。 - 在終端機中，使用您偏好的文字編輯器開啟
.idx/airules.md。
- 在「Explorer」 (
在檔案中加入內容。您可以新增關於 Gemini 應使用的人物角色資訊 (例如「您是專業開發人員，也是一位瞭解 Next.js 一切的實用助理」)、程式碼和對話標準，以及專案的背景資訊。如需 AI 規則檔案範例，請參閱以下範例。
儲存檔案，然後在 Firebase 中開啟 Gemini。
如要開始使用 AI 規則，請執行下列任一操作：
- 重新整理頁面即可重建工作區。重新建構後，Firebase 中的 Gemini 就會使用聊天室中的規則檔案。AI 規則檔案的變更應立即反映在即時通訊中。
- 如果您不想重建工作區，可以使用聊天功能向 Gemini 提出要求，
load airules.md。如果您在目前工作階段中變更檔案，可能需要重新提示 Gemini 來再次載入規則檔案。
詢問程式碼相關問題。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.
使用 .aiexclude 檔案排除 Gemini 中的檔案
您可以在專案中加入 .aiexclude 檔案，藉此控管程式碼庫中應隱藏哪些檔案，以免讓 Gemini 存取。這樣一來，您就能精細控制與 Gemini 共用的專案內容。
.aiexclude 檔案與 .gitignore 檔案非常相似，可追蹤不應與 Gemini 共用的檔案，包括聊天體驗以及在編輯器中運作的 AI 功能。.aiexclude 檔案會對包含該檔案的目錄或目錄以下的檔案運作。
啟用Codebase Indexing 後，.aiexclude 所涵蓋的檔案不會由 Gemini 建立索引。此外，.aiexclude 會以以下方式影響涵蓋檔案的內嵌協助功能：
- 即時通訊協助：Gemini 無法回答有關
.aiexclude檔案的問題，也無法提供相關建議。 - 程式碼完成功能：編輯已涵蓋的檔案時，系統不會提供程式碼完成建議。
- 內嵌輔助功能：您可以在編輯涵蓋的檔案時產生新程式碼，但無法修改現有程式碼。
其他開發環境 (例如 Android Studio) 也可能會使用 .aiexclude 檔案。
如何編寫 .aiexclude 檔案
.aiexclude 檔案所遵循的語法與 .gitignore 檔案相同，但有以下差異：
- 空白的
.aiexclude檔案會封鎖目錄和所有子目錄中的所有檔案。這與含有**/*的檔案相同。 .aiexclude檔案不支援否定 (以!為前置詞的模式)。
範例
以下是 .aiexclude 檔案設定的範例：
在含有
.aiexclude檔案的目錄或以下，封鎖所有名為apikeys.txt的檔案：apikeys.txt封鎖含有
.key副檔名的所有檔案，這些檔案必須位於含有.aiexclude檔案的目錄或目錄以下：*.key只封鎖
.aiexclude所在目錄中的apikeys.txt檔案，而非任何子目錄：/apikeys.txt封鎖目錄
my/sensitive/dir和所有子目錄中的所有檔案。路徑應相對於包含.aiexclude檔案的目錄：my/sensitive/dir/
自備金鑰：在聊天中使用其他 Gemini 模型
您可以設定 Firebase 即時通訊中 Gemini 使用的 Gemini 模型。您可以選擇內建模型、在聊天視窗中設定的模型 (包括 Gemini 2.5 模型)，或是您有權存取的任何 Gemini 模型。
如需所有可用模型的清單，請參閱 Gemini 模型。
如要設定鍵並選取其他 Gemini 模型：
在已開啟的工作區中，按一下工作區底部的「火花」圖示 Gemini (或「火花」Gemini 分頁)。
在 Firebase 的 Gemini 對話方塊中，按一下模型名稱下拉式選單，然後點選 Gemini API 鍵 連結。畫面上會顯示「使用者設定」。
在「IDX > AI: Gemini Api Key」欄位中，輸入 Gemini API 金鑰。
您現在可以在即時通訊中選取任何預先設定的 Gemini 模型。
如要設定下拉式選單中未列出的 Gemini 模型：
從Gemini 模型清單中找出要在即時通訊中使用的 Gemini 模型。例如，您可以輸入
gemini-2.0-flash-lite在 Firebase 聊天視窗中的 Gemini 中，按一下模型選擇器，然後選擇「自訂模型 ID」。使用者設定隨即開啟。
將所選模型名稱複製到 IDX > AI: Gemini Model 欄位。
關閉聊天視窗，然後點選工作區底部的「火花」圖示 Gemini 重新開啟聊天視窗，即可重新整理模型清單。