模板的高级工作流


对于 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 端点来创建模板。 在创建 PromptTemplate 时,指定模板的 location(例如 europe-west4)。

  2. 在应用的请求中,确保访问模型的位置与模板的位置 (eu) 一致。

请注意以下事项:

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

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

以文件形式提供模板

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