模板的高级工作流


对于 Firebase AI Logic，Firebase 控制台提供了一个引导式界面，供您 指定模板的内容。不过，在某些使用情形中，您可能需要更高级的方式来设置模板，包括：

本页面介绍的高级工作流使用 Firebase AI Logic REST API。

有关使用 REST API 的重要信息

  • 如果模板已解锁，您可以在 REST API 调用中使用相同的模板 ID 来覆盖该模板。无法覆盖锁定的模板。

  • 当您 通过 REST API 创建服务器提示模板 并且 将其位置设置为 global 时，系统会自动在 所有 位置（包括 global）预配服务器提示模板，并且该模板可与 两个 Gemini API 提供商搭配使用。但是，如果您在通过 REST API 创建模板时设置了任何 其他位置，则该模板将 仅可用于 Vertex AI Gemini API。请在本页面的下文中详细了解如何为模板设置特定位置。

    请注意，当您使用 Firebase 控制台中的引导式界面时，系统也会在 所有 位置（包括 global）自动预配模板，并且该模板可与 两个 Gemini API 提供方搭配使用。

  • 如需通过 REST API 在 templateGenerateContent 或 templateStreamGenerateContent 请求中访问服务器提示模板，您必须使用特定于 Gemini API 提供商的 端点 （Gemini Developer API | Vertex AI Gemini API）。

（仅限 Vertex AI Gemini API） 为模板设置特定位置

本部分适用于以下情况：

  • 您应用的使用情形有基于位置的要求。

  • 您应用的请求使用 Vertex AI Gemini API，并且您指定了 用于访问模型的位置。

如本页面的前文所述，如果您执行以下任一操作，系统会自动将服务器提示模板 预配到 所有 可用区域（包括 global）：Firebase AI Logic

  • 使用 Firebase 控制台中的引导式界面创建模板。
  • 通过 REST API 创建模板 并且 将其位置设置为 global。

这意味着，您可以在应用的请求中将位置设置为 Firebase AI Logic的任何可用区域，并且该模板将可用。 您无需在应用的请求中将位置设置为 global。

但是，如果您希望模板 仅在特定位置可用，则需要通过 REST API 创建 模板并显式设置该特定位置。请 勿 将位置设置为 global。

  1. 通过调用 projects.locations.templates.create 端点来创建模板。 指定模板的 location（例如 europe-west4）作为创建 PromptTemplate 的一部分。

  2. 在应用的请求中，确保您访问模型的位置 与模板的位置 (europe-west4) 一致。

请注意以下事项：

  • Firebase 控制台中的模板列表仅显示 （至少）在 global 位置预配的模板。

  • 如果您使用 REST API 在特定位置（不是 global）预配模板，则您在应用的请求中访问模型的位置 必须 与为模板设置的位置一致。 如果位置不一致，请求将失败（由于区域隔离政策）。

以文件形式提供模板

您可以通过调用 projects.locations.templates.create 端点来提供服务器提示模板文件的内容。