使用 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 引荐来源网址（Web）的请求。

  • 查看每个密钥的“API 限制”许可清单：

    • 确保 Firebase AI Logic API (firebasevertexai.googleapis.com) 在许可清单中。
    • 确保许可名单中唯一的其他 API 是您的应用所需的特定 Firebase 服务。请参阅受限 Firebase 密钥所需的 API 列表。

请注意，Firebase 相关 API 仅使用 API 密钥来标识 Firebase 项目或应用，不用于授权调用 API。

仅限经过身份验证的用户发出请求

考虑强制执行“已通过身份验证的用户”模式，以便通过 Firebase AI Logic 发出的所有请求都必须包含来自 Firebase Authentication 的有效凭据。如果请求来自未经身份验证的最终用户，则请求会被拒绝并显示 401: unauthenticated 错误。

监控、限制和结算

在 Firebase 控制台中设置 AI 监控

在 Firebase 控制台中设置 AI 监控，以便了解请求数量、延迟时间、token 使用情况和错误率等关键效果指标。您还可以在 Google Cloud 控制台中检查各个跟踪记录。

设置速率限制和管理配额

保护您的项目免受意外用量激增和钱包拒绝攻击：

通过提醒和支出上限避免出现意外费用

如果您的 Firebase 项目采用的是随用随付 Blaze 定价方案：

配置管理

在正式版应用中使用稳定的模型版本

在正式版应用中，请仅使用稳定模型版本（例如 gemini-3.8-flash）。请勿使用预览或实验版本，也不要使用 -latest 别名。

使用 Firebase Remote Config 或服务器提示模板

使用 Remote Config 或服务器提示模板时，您可以在云端（服务器端）控制应用 AI 功能的重要配置，而无需在代码中硬编码值。这意味着您无需发布新版应用即可更新配置。

  • （强烈建议）随着新模型的发布或旧模型的停用，按需更改 AI 功能所使用的模型名称。查看有关使用 Remote Config 或服务器提示模板的详细信息。

  • （可选）动态甚至有条件地控制 AI 功能的其他参数，例如模型配置（如最大输出 token 数量）、安全设置、系统指令和提示数据。查看有关使用 Remote Config 或服务器提示模板的详细信息。

  • （可选） 在 Remote Config 中设置 minimum_version 参数，以将应用的当前版本与 Remote Config 定义的最新版本进行比较，从而向用户显示升级通知或强制用户升级。

设置访问模型的位置

仅在使用 Agent Platform Gemini API (formerly Vertex AI) 作为 API 提供方时可用。

设置访问模型的位置，以帮助优化配额并防止用户遇到延迟。

如果您未指定位置，则默认位置为 global（使用新的“智能体平台”初始化语法时）。您可以在初始化期间设置此位置，也可以选择使用 Firebase Remote Config 根据每个用户的位置动态更改位置。