强制执行“仅模板”模式


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

当请求被屏蔽时,响应将为 403: unauthorized 错误。

重要注意事项

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

强制执行仅限模板模式时

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

  • 此设置是 Firebase AI Logic项目级设置。

    • 它适用于项目中注册的所有应用。
    • 它仅适用于强制执行该政策的项目。
  • 此设置适用于通过 Firebase AI LogicGemini Developer APIVertex AI Gemini API 发出的所有请求。

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

  • 此设置不会阻止项目中通过 Firebase AI Logic 发出的 Gemini API 请求。

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

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

在强制执行“仅限模板”模式之前

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

  • 如果您的任何现有应用版本未使用服务器提示模板,请执行以下操作:

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

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

管理仅限模板模式设置

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

所需的 IAM 权限和角色

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

强制执行“仅模板”模式

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

  1. 如果您尚未这样做,请查看本指南前面介绍的仅限模板模式的重要注意事项

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

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

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

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

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

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

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

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

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

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