範本的進階工作流程


如果是 Firebase AI Logic,Firebase 控制台會提供引導式 UI,讓您指定範本內容。不過,在某些情況下,您可能需要使用更進階的方式設定範本,包括:

本頁所述的進階工作流程會使用 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 控制台使用引導式 UI 建立範本。
  • 透過 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 端點,提供伺服器提示詞範本檔案的內容。