强制执行“仅模板”模式


您可以为 Firebase 项目强制执行 仅限模板模式 ,以便通过 Firebase AI Logic 发起的所有 Gemini API 请求都必须使用 服务器提示模板。

如果请求被阻止,响应将是 403: unauthorized 错误。

重要注意事项

请注意以下有关仅限模板模式的重要注意事项。

强制执行仅限模板模式时

强制执行仅限模板模式时,请注意以下事项:

  • 此设置是 项目级 设置,适用于 Firebase AI Logic

    • 它适用于在项目中注册的所有应用。
    • 它仅适用于强制执行该设置的项目。
  • 此设置适用于通过 Firebase AI Logic 发起的所有请求,包括 Gemini Developer APIAgent Platform Gemini API (formerly Vertex AI)

  • 此设置会 阻止 通过 Firebase AI Logic 发起的所有未使用服务器提示模板的请求。这包括阻止您的 应用中未使用 服务器提示模板尚不支持的功能的请求。

  • 此设置不会阻止 Gemini API请求,这些请求 在您的项目中不是通过Firebase AI Logic进行的。

  • 如果您使用的是 Firebase AI Logic REST API

    • 此设置 不会阻止 推理 请求 使用服务器提示模板(例如使用 templateGenerateContenttemplateStreamGenerateContent)。
    • 此设置 不会阻止 控制平面 请求 (例如用于管理模板和配置的请求)。
  • 此设置 不会阻止countTokens( Count Tokens API)的请求。

强制执行仅限模板模式之前

在强制执行仅限模板模式之前,请注意以下事项:

  • 如果您的任何现有应用版本未使用服务器提示模板:

    • 此设置将 阻止 通过 Firebase AI Logic 发起且来自这些现有应用版本的请求。
    • 在强制执行仅限模板模式之前,请确保所有活跃客户端都已更新为使用服务器提示模板。
  • 如果您的应用使用了 服务器提示模板尚不支持的功能

    • 此设置将 阻止 通过 Firebase AI Logic 发起且针对 这些尚不支持的功能的请求,因为这些功能未使用(且无法使用) 服务器提示模板。
    • 在强制执行仅限模板模式之前,请确保您的应用(包括任何过往版本)不会主动使用任何此类尚不支持的功能。

管理仅限模板模式设置

您可以在 Firebase 控制台中管理仅限模板模式的设置。

所需的 IAM 权限和角色

管理仅限模板模式设置需要 firebasevertexai.configs.update 权限,该权限默认包含在以下 IAM 角色中:所有者、编辑者、Firebase 管理员和 Firebase AI Logic 管理员。

强制执行仅限模板模式

如需为 Firebase 项目强制执行仅限模板模式,请执行以下操作:

  1. 如果您尚未查看,请先查看本指南前面部分中有关仅限模板模式的 重要注意事项

  2. Firebase 控制台中,依次前往 AI 服务 > AI Logic > 设置 标签页

  3. 模板模式下,将强制执行仅限模板模式 的切换开关滑动到已强制执行

  4. 查看确认对话框,然后点击确认

停止强制执行仅限模板模式

如果您停止强制执行仅限模板模式,请注意以下事项:

  • 系统将允许通过 Firebase AI Logic 发起且未使用服务器提示模板 的请求。
  • 这是 项目级设置,适用于 Firebase AI Logic

如需停止为 Firebase 项目强制执行仅限模板模式,请执行以下操作:

  1. Firebase 控制台中,依次前往 AI 服务 > AI Logic > 设置 标签页

  2. 模板模式下,关闭强制执行仅限模板模式

  3. 查看确认对话框,然后点击确认