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


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 権限が必要です。この権限は、オーナー、編集者、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. 確認ダイアログを確認し、[確認] をクリックします。