範本的進階工作流程


如果是 Firebase AI LogicFirebase 控制台會提供導覽式 UI,引導您指定範本內容。不過,在下列幾種情況下,您可能需要更進階的範本設定方式:

本頁說明的進階工作流程會使用 Firebase AI Logic REST API

使用 REST API 的重要資訊

  • 如果範本已解鎖,您可以在 REST API 呼叫中使用相同的範本 ID,覆寫範本。鎖定的範本無法覆寫。

  • 如果您透過 REST API 建立伺服器提示詞範本 將其位置設為 global,系統就會在所有位置 (包括 global) 自動佈建伺服器提示詞範本,且兩種 Gemini API 提供者都能使用。不過,如果您透過 REST API 建立範本時設定了其他位置,則範本只能Vertex AI Gemini API 中使用。如要進一步瞭解如何為範本設定特定位置,請參閱本頁的後續內容

    請注意,在 Firebase 控制台使用引導式 UI 時,系統也會在所有位置 (包括 global) 自動佈建範本,並可供Gemini API provider 使用。

  • 如要透過 REST API 在 templateGenerateContenttemplateStreamGenerateContent 要求中存取伺服器提示範本,必須使用特定於 Gemini API 供應商的端點 (Gemini Developer API | Vertex AI Gemini API)。

(僅限 Vertex AI Gemini API) 設定範本的特定位置

本節適用於下列情況:

  • 應用程式用途有位置資訊相關規定。

  • 應用程式的要求會使用 Vertex AI Gemini API,且您會指定存取模型的位置

如本頁面稍早所述,如果您執行下列任一操作,系統會自動在所有Firebase AI Logic可用區域 (包括 global) 中,佈建伺服器提示範本:

  • 使用 Firebase 控制台中的引導式 UI 建立範本。
  • 透過 REST API 建立範本 and,並將其位置設為 global

也就是說,您可以在應用程式的要求中,將位置設為 Firebase AI Logic 的任何可用區域,範本就會顯示。您不需要在應用程式對 global 的要求中設定位置資訊。

不過,如要只在特定位置提供範本,則需要透過 REST API 建立範本,並明確設定該特定位置。請勿將位置設為 global

  1. 呼叫 projects.locations.templates.create 端點,建立範本。在建立 PromptTemplate 時,指定範本的 location (例如 europe-west4)。

  2. 在應用程式的要求中,請確認存取模型的位置與範本位置 (europe-west4) 相符。

請留意下列事項:

  • Firebase 控制台中的範本清單只會顯示在 global 位置 (至少) 佈建的範本。

  • 如果您使用 REST API 在特定位置 (不是 global) 佈建範本,則在應用程式要求中存取模型的位置「必須」與範本設定的位置相符。如果位置不相符,要求就會失敗 (因為區域隔離政策)。

以檔案形式提供範本

您可以呼叫 projects.locations.templates.create 端點,提供伺服器提示詞範本檔案的內容。