您可以为 Firebase 项目强制执行 仅限模板模式 ,以便通过 Firebase AI Logic 发起的所有 Gemini API 请求都必须使用 服务器提示模板。
如果请求被阻止,响应将是 403: unauthorized 错误。
重要注意事项
请注意以下有关仅限模板模式的重要注意事项。
强制执行仅限模板模式时
强制执行仅限模板模式时,请注意以下事项:
此设置是 项目级 设置,适用于 Firebase AI Logic。
- 它适用于在项目中注册的所有应用。
- 它仅适用于强制执行该设置的项目。
此设置适用于通过 Firebase AI Logic 发起的所有请求,包括 Gemini Developer API 和 Agent Platform Gemini API (formerly Vertex AI)。
此设置会 阻止 通过 Firebase AI Logic 发起的所有未使用服务器提示模板的请求。这包括阻止您的 应用中未使用 服务器提示模板尚不支持的功能的请求。
此设置不会阻止 Gemini API请求,这些请求 在您的项目中不是通过Firebase AI Logic进行的。
如果您使用的是 Firebase AI Logic REST API:
- 此设置 不会阻止 推理 请求
使用服务器提示模板(例如使用
templateGenerateContent或templateStreamGenerateContent)。 - 此设置 不会阻止 控制平面 请求 (例如用于管理模板和配置的请求)。
- 此设置 不会阻止 推理 请求
使用服务器提示模板(例如使用
此设置 不会阻止 对
countTokens( Count Tokens API)的请求。
强制执行仅限模板模式之前
在强制执行仅限模板模式之前,请注意以下事项:
如果您的任何现有应用版本未使用服务器提示模板:
- 此设置将 阻止 通过 Firebase AI Logic 发起且来自这些现有应用版本的请求。
- 在强制执行仅限模板模式之前,请确保所有活跃客户端都已更新为使用服务器提示模板。
如果您的应用使用了 服务器提示模板尚不支持的功能:
- 此设置将 阻止 通过 Firebase AI Logic 发起且针对 这些尚不支持的功能的请求,因为这些功能未使用(且无法使用) 服务器提示模板。
- 在强制执行仅限模板模式之前,请确保您的应用(包括任何过往版本)不会主动使用任何此类尚不支持的功能。
管理仅限模板模式设置
您可以在 Firebase 控制台中管理仅限模板模式的设置。
所需的 IAM 权限和角色
管理仅限模板模式设置需要 firebasevertexai.configs.update 权限,该权限默认包含在以下 IAM 角色中:所有者、编辑者、Firebase 管理员和 Firebase AI Logic 管理员。
强制执行仅限模板模式
如需为 Firebase 项目强制执行仅限模板模式,请执行以下操作:
如果您尚未查看,请先查看本指南前面部分中有关仅限模板模式的 重要注意事项 。
在 Firebase 控制台中,依次前往 AI 服务 > AI Logic > 设置 标签页。
在模板模式下,将强制执行仅限模板模式 的切换开关滑动到已强制执行。
查看确认对话框,然后点击确认 。
停止强制执行仅限模板模式
如果您停止强制执行仅限模板模式,请注意以下事项:
- 系统将允许通过 Firebase AI Logic 发起且未使用服务器提示模板 的请求。
- 这是 项目级设置,适用于 Firebase AI Logic。
如需停止为 Firebase 项目强制执行仅限模板模式,请执行以下操作:
在 Firebase 控制台中,依次前往 AI 服务 > AI Logic > 设置 标签页。
在模板模式下,关闭强制执行仅限模板模式。
查看确认对话框,然后点击确认 。