範本的進階工作流程


對於 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 控制台使用引導式 UI 時,系統也會在所有位置 (包括 global) 自動佈建範本,並可供兩個 Gemini API 供應商使用。

  • 如要透過 REST API 在 templateGenerateContent 或 templateStreamGenerateContent 要求中存取伺服器提示詞範本,必須使用特定於 Gemini API provider 的端點 (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 端點,即可提供伺服器提示詞範本檔案的內容。