強制執行僅限範本模式


您可以為 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 (即「計算權杖」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」(AI 邏輯) >「Settings」(設定) 分頁標籤。

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

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

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

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

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

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

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

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

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