強制執行僅限範本模式


您可以為 Firebase 專案強制執行僅限範本模式，這樣透過 Firebase AI Logic 發出的所有 Gemini API 要求都必須使用伺服器提示詞範本。

如果要求遭到封鎖，回應會是 403: unauthorized 錯誤。

重要事項

請注意僅限範本模式的下列重要事項。

強制執行僅限範本模式

強制執行僅限範本模式時，請注意下列事項：

  • 這項設定是 Firebase AI Logic 的專案層級設定。

    • 這項配額適用於專案中註冊的所有應用程式。
    • 這項設定只會套用至強制執行的專案。

  • 這項設定適用於透過 Firebase AI Logic 向 Gemini Developer API 和 Vertex AI Gemini API 提出的所有要求。

  • 這項設定會封鎖透過 Firebase AI Logic 發出的所有要求，不允許使用伺服器提示詞範本。包括封鎖應用程式發出的要求，因為這些要求使用伺服器提示詞範本尚未支援的功能。

  • 這項設定不會封鎖專案中並非透過 Firebase AI Logic 提出的 Gemini API 要求。

  • 如果您使用 Firebase AI Logic REST API：

    • 這項設定不會封鎖使用伺服器提示範本的推論要求 (例如使用 templateGenerateContent 或 templateStreamGenerateContent)。
    • 這項設定不會封鎖 控制平面要求 (例如管理範本和設定的要求)。

  • 這項設定「不會」封鎖對 countTokens (即 Count Tokens API) 的要求。

強制執行僅限範本模式前的準備作業

強制執行僅限範本模式前，請注意下列事項：

  • 如果現有的應用程式版本「未」採用伺服器提示詞範本：

    • 這項設定會封鎖透過 Firebase AI Logic 來自現有應用程式版本的請求。
    • 強制執行僅限範本模式前，請確保所有運作中的用戶端都已更新，改用伺服器提示範本。

  • 如果應用程式使用伺服器提示詞範本尚未支援的功能：

    • 這項設定會封鎖透過 Firebase AI Logic 對這些尚未支援的功能提出的要求，因為這些功能不會 (也無法) 使用伺服器提示範本。
    • 請務必在強制執行僅限範本模式「之前」，確認應用程式 (包括任何舊版) 不會主動使用任何尚未支援的功能。
。

管理僅限範本模式設定

您可以在 Firebase 控制台中管理僅限範本模式的設定。

所需的身分與存取權管理權限和角色

如要管理僅限範本模式設定，您必須具備 firebasevertexai.configs.update 權限。下列 IAM 角色預設具備這項權限：擁有者、編輯者、Firebase 管理員和 Firebase AI Logic 管理員。

強制執行僅限範本模式

如要為 Firebase 專案強制執行僅限範本模式，請按照下列步驟操作：

  1. 如尚未閱讀，請先詳閱本指南稍早的重要注意事項，瞭解僅限範本模式。

  2. 在 Firebase 控制台中，依序前往「AI Services」(AI 服務) >「AI Logic」(AI 邏輯) >「Settings」(設定) 分頁標籤。

  3. 在「範本模式」下方，將「強制執行僅限範本模式」的切換鈕滑動至「強制執行」。

  4. 查看確認對話方塊，然後按一下「確認」。

停止強制執行僅限範本模式

停止強制執行僅限範本模式時，請注意下列事項：

  • 未採用伺服器提示詞範本的 Firebase AI Logic 要求不會遭到封鎖。
  • 這項設定會套用至整項專案的 Firebase AI Logic。

如要停止對 Firebase 專案強制執行僅限範本模式，請按照下列步驟操作：

  1. 在 Firebase 控制台中，依序前往「AI Services」(AI 服務) >「AI Logic」(AI 邏輯) >「Settings」(設定) 分頁標籤。

  2. 在「範本模式」下方，關閉「強制執行僅限範本模式」。

  3. 查看確認對話方塊，然後按一下「確認」。