模板的高级工作流


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

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

有关使用 REST API 的重要信息

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

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

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

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

(仅限 Agent Platform Gemini API (formerly Vertex AI)) 为模板设置特定位置

本部分适用于以下情况：

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

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

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

  • 使用 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 端点来提供服务器提示模板文件的内容。