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


Firebase プロジェクトに テンプレート専用モード を適用すると、 Gemini API を介したすべての Firebase AI Logic リクエストで サーバー プロンプト テンプレートを使用する必要があります。

リクエストがブロックされると、レスポンスは 403: unauthorized エラーになります。

重要な考慮事項

テンプレート専用モードに関する次の重要な考慮事項に注意してください。

テンプレート専用モードが適用されている場合

テンプレート専用モードが適用されている場合は、次の点に注意してください。

  • この設定は、プロジェクト全体の設定です。Firebase AI Logic

    • プロジェクトに登録されているすべてのアプリに適用されます。
    • 適用されているプロジェクトにのみ適用されます。

  • この設定は、Firebase AI Logic を介した すべて のリクエストに、 Gemini Developer API と Vertex AI Gemini API の両方に対して適用されます。

  • この設定は、サーバー プロンプト テンプレートを使用 しない Firebase AI Logic を介したリクエストをすべて ブロック します。これには、サーバー プロンプト テンプレートでまだサポートされていない機能を使用する アプリからのリクエストのブロックも含まれます 。

  • この設定は、プロジェクト内の Gemini API リクエストを ブロックしません 介さない Firebase AI Logic 。

  • 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 Logic] > [設定] タブに移動します。

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

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

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

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

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

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

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

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

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