如果是 Firebase AI Logic,Firebase 控制台會提供導覽式 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 在
templateGenerateContent或templateStreamGenerateContent要求中存取伺服器提示範本,必須使用特定於 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。
呼叫
projects.locations.templates.create端點,建立範本。在建立PromptTemplate時,指定範本的location(例如europe-west4)。在應用程式的要求中,請確認存取模型的位置與範本位置 (
europe-west4) 相符。
請留意下列事項:
Firebase 控制台中的範本清單只會顯示在
global位置 (至少) 佈建的範本。如果您使用 REST API 在特定位置 (不是
global) 佈建範本,則在應用程式要求中存取模型的位置「必須」與範本設定的位置相符。如果位置不相符,要求就會失敗 (因為區域隔離政策)。
以檔案形式提供範本
您可以呼叫 projects.locations.templates.create 端點,提供伺服器提示詞範本檔案的內容。