強制執行僅限範本模式


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

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

重要事項

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

強制執行僅限範本模式時

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

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

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

  • 這項設定適用於透過 Firebase AI Logic 傳送至 Gemini Developer API 和 Agent Platform Gemini API (formerly Vertex AI) 的「所有」要求。

  • 這項設定會封鎖任何未使用伺服器提示詞範本的 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 控制台管理僅限範本模式的設定。

必要的 IAM 權限和角色

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

強制執行僅限範本模式

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

  1. 如果您尚未閱讀本指南前文，請先參閱僅限範本模式的重要注意事項。

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

  3. 在「Template mode」(範本模式) 下方，將「Enforce template-only mode」(強制執行僅限範本模式) 切換鈕滑動至「Enforced」(強制執行)。

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

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

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

  • 透過 Firebase AI Logic 提出的要求，即使未使用伺服器提示詞範本，也會允許。
  • 這項 Firebase AI Logic 設定會套用至整項專案。

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

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

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

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