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