テンプレート専用モードを適用する


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 コンソールで管理します。

必要な IAM 権限とロール

テンプレート専用モードの設定を管理するには、firebasevertexai.configs.update 権限が必要です。この権限は、オーナー、編集者、Firebase 管理者、Firebase AI Logic 管理者の IAM ロールにデフォルトで含まれています。

テンプレート専用モードを適用する

Firebase プロジェクトでテンプレート専用モードを適用する方法は次のとおりです。

  1. まだ確認していない場合は、このガイドの前半にあるテンプレート専用モードの重要な考慮事項を確認してください。

  2. Firebase コンソールで、[AI サービス] > [AI ロジック] > [設定] タブに移動します。

  3. [テンプレート モード] で、[テンプレート専用モードを適用する] の切り替えを [適用] にスライドします。

  4. 確認ダイアログを確認し、[確認] をクリックします。

テンプレート専用モードの適用を停止する

テンプレート専用モードの適用を停止する場合は、次の点にご注意ください。

  • Firebase AI Logic を介した、サーバー プロンプト テンプレートを使用しないリクエストは許可されます。
  • これは、Firebase AI Logic のプロジェクト全体の設定です。

Firebase プロジェクトでテンプレート専用モードの適用を停止する方法は次のとおりです。

  1. Firebase コンソールで、[AI サービス] > [AI ロジック] > [設定] タブに移動します。

  2. [テンプレート モード] で、[テンプレート専用モードを適用する] をオフにします。

  3. 確認ダイアログを確認し、[確認] をクリックします。