您可以为 Firebase 项目强制执行 仅限模板模式 ,以便通过 Firebase AI Logic 发起的所有 Gemini API 请求都必须使用 服务器提示模板。
如果请求被阻止,响应将是 403: unauthorized 错误。
重要注意事项
请注意以下有关仅限模板模式的重要注意事项。
强制执行仅限模板模式时
强制执行仅限模板模式时,请注意以下事项:
此设置是 项目级 设置,适用于 Firebase AI Logic。
- 它适用于在项目中注册的所有应用。
- 它仅适用于强制执行该设置的项目。
此设置适用于通过 Firebase AI Logic 发送给 Gemini Developer API 和 Vertex AI Gemini API 的 所有 请求。
此设置会 阻止 通过 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 > 设置 标签页。
在模板模式下,关闭强制执行仅限模板模式。
查看确认对话框,然后点击确认 。