强制执行“仅模板”模式


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

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

重要注意事项

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

强制执行仅限模板模式时

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

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

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

  • 此设置会 阻止 通过 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. 查看确认对话框,然后点击确认