使用 Firebase AI Logic 的製作檢查清單

當您準備好推出應用程式，並讓實際使用者與應用程式的 AI 功能互動時，請務必查看這份最佳做法和重要考量事項檢查清單。

一般

查看一般推出檢查清單

在將任何 Firebase 應用程式發布至正式環境前，請先詳閱 Firebase 發布檢查清單，瞭解重要的最佳做法。

遵循 Firebase 專案的最佳做法

開發、測試和正式環境應使用不同的 Firebase 專案。請參閱管理專案的最佳做法。

存取權和安全性

查看安全性檢查清單

請參閱 Firebase 安全性檢查清單和專屬的 Firebase AI Logic 安全性檢查清單，瞭解存取權和安全性的重要最佳做法。

強制執行 Firebase App Check

強制執行 Firebase App Check，有助於保護直接從應用程式呼叫的 Gemini API，避免遭到濫用。強制執行 App Check 後，系統會驗證傳入的要求是否來自您的正版應用程式和/或未經竄改的裝置。

App Check 支援 Apple 平台 (DeviceCheck、App Attest 或 reCAPTCHA Enterprise)、Android (Play Integrity 或 reCAPTCHA Enterprise) 和 Web (reCAPTCHA Enterprise) 的認證供應商。Flutter 和 Unity 應用程式也支援所有這些供應商。

此外，建議您強制執行重放攻擊防護機制，也就是權杖只能使用一次。這個選項提供比基準防護更強大的強化防護，可讓您根據應用程式和用途設定適當的防護等級。

設定 Firebase API 金鑰限制

Firebase API 金鑰會在提出要求時，識別您的 Firebase 專案和應用程式。 為避免 API 金鑰遭未經授權使用，請採取下列做法：

  • 在 Google Cloud 控制台中設定「應用程式限制」，限制金鑰只能用於來自應用程式特定軟體包 ID (Apple)、套件名稱和 SHA-1 指紋 (Android) 或 HTTP 參照網址 (網頁) 的要求。

  • 查看每個金鑰的「API 限制」許可清單：

    • 確認 Firebase AI Logic API (firebasevertexai.googleapis.com) 已加入許可清單。
    • 請確認許可清單中只有應用程式所需的特定 Firebase 服務 API。請參閱受限 Firebase 金鑰所需的 API 清單。

請注意，Firebase 相關 API 只會使用 API 金鑰識別 Firebase 專案或應用程式，不會用於授權呼叫 API。

限制只有經過驗證的使用者才能提出要求

建議強制啟用「僅限通過驗證的使用者」模式，這樣一來，所有透過 Firebase AI Logic 提出的要求都必須包含 Firebase Authentication 的有效憑證。如果要求來自未經驗證的使用者，系統會拒絕要求並傳回 401: unauthenticated 錯誤。

監控、限制和計費

在 Firebase 控制台設定 AI 監控

在 Firebase 控制台設定 AI 監控 ，掌握要求數量、延遲時間、 詞元用量和錯誤率等重要成效指標。您也可以在 Google Cloud 控制台中檢查個別追蹤記錄。

設定頻率限制及管理配額

保護專案，避免用量突然暴增和錢包阻斷攻擊：

設定快訊和支出上限，避免帳單費用超乎預期

如果 Firebase 專案採用即付即用 Blaze 定價方案：

管理設定

在正式版應用程式中使用穩定版模型

在正式版應用程式中，請務必使用穩定模型版本 (例如 gemini-3.8-flash)，不要使用預先發布版或實驗版本，也不要使用 -latest 別名。

使用 Firebase Remote Config 或伺服器提示詞範本

使用 Remote Config 或伺服器提示詞範本時，您可以在雲端 (伺服器端) 控制應用程式 AI 功能的重要設定，而不必在程式碼中硬式編碼值。這表示您可以更新設定，不必發布新版應用程式。

  • (強烈建議) 隨著新模型發布或舊模型停用，視需要變更 AI 功能使用的模型名稱。請參閱使用 Remote Config 或伺服器提示詞範本的詳細資料。

  • (選用) 動態控制 AI 功能的其他參數，甚至可設定條件，例如模型設定 (如輸出詞元數量上限)、安全設定、系統指令和提示資料。請參閱使用 Remote Config 或伺服器提示詞範本的詳細資料。

  • (選用) 在 Remote Config 中設定 minimum_version 參數，比較應用程式目前版本與 Remote Config 定義的最新版本，向使用者顯示升級 通知或強制使用者升級。

設定模型存取位置

僅限使用 Agent Platform Gemini API (formerly Vertex AI) 做為 API 供應商時。

設定存取模型的位置，盡可能提高配額，並避免使用者遇到延遲。

如未指定位置，系統會預設為 global (使用新的「Agent Platform」初始化語法時)。您可以在初始化期間設定這個位置，也可以使用 Firebase Remote Config，根據每位使用者的位置動態變更位置。