Starting November 2, 2026, Firebase App Check enforcement will be required to use Firebase AI Logic. Learn more.

Model updates:

The latest Gemini models, like Gemini 3.8 Flash, are available to use with Firebase AI Logic! Learn more.
Gemini 2.5 models are limited to projects that actively used them in the past. For the Agent Platform Gemini API, these models will shut down for all projects in October 2026. To avoid service disruptions, update to a newer model (like gemini-3.8-flash or gemini-3.1-flash-image). Any stable Gemini Live API 2.5 models are not impacted. Learn more.

Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

サーバープロンプトテンプレートを使ってみる

モデルへのリクエストごとに、プロンプトと、モデルのレスポンスを制御するスキーマと構成（省略可）を送信します。Firebase AI Logic を使用する場合、このすべての情報をクライアントコードから直接送信することも、サーバープロンプトテンプレートを使用してサーバーサイドで指定することもできます。

サーバーのプロンプトテンプレートを使用すると、プロンプト、スキーマ、構成をサーバーサイドに保存し、アプリのコードベースは、特定のテンプレートを参照するキー（テンプレート ID）と、そのテンプレートに必要な入力のみをクライアントからサーバーに渡します。このアプローチには次のようなメリットがあります。

クライアントサイドでプロンプトが公開されないように保護する
新しいアプリバージョンをリリースせずにプロンプトと構成を更新する

このガイドでは、サーバープロンプトテンプレートの使用を開始する方法について説明します。

概要に移動詳細な手順に移動

サポートされているモデルと機能

Firebase AI Logic がサポートするGemini モデル（Gemini Live API モデルを除く）でサーバープロンプトテンプレートを使用します。
まだサポートされていない機能の一覧を確認します。

概要

サーバープロンプトテンプレートを使用する基本的なワークフローは次のとおりです。

Firebase コンソールのガイド付き UI を使用してテンプレートを作成します。
Firebase コンソールのテスト機能を使用して、実際のリクエストでテンプレートをテストします。
templateGenerativeModel を使用して、アプリのコードからテンプレートにアクセスします。

サーバープロンプトテンプレートの基本形式

Firebase AI Logic の場合、Firebase コンソールには、テンプレートのフロントマターとコンテンツを指定するためのガイド付き UI が用意されています。

サーバーのプロンプトテンプレートは、Dotprompt ベースの構文と形式を使用します。詳細については、テンプレートの形式、構文、例をご覧ください。

次のテンプレートの例は、Gemini モデルへのリクエスト例のテンプレートの最も重要なコンポーネントを示しています。

---
model: 'gemini-3.8-flash'
---

{{role "system"}}
All output must be a clearly structured invoice document.
Use a tabular or clearly delineated list format for line items.

{{role "user"}}
Create an example customer invoice for a customer named {{customerName}}.

3 つのダッシュ内の上部セクションには、モデル名と、リクエストで送信するモデル構成、入力検証、スキーマ（省略可）が含まれます。これは Key-Value ペアとして記述され、通常は YAML frontmatter と呼ばれます。
テンプレートの本文にはプロンプトが含まれています。必要に応じて、システム指示と入力値（Handlebars 構文を使用）を含めることもできます。

コードでテンプレートを使用する

Gemini API プロバイダをクリックして、このページでプロバイダ固有のコンテンツとコードを表示します。

次のクライアントコードの例は、コードでテンプレートを使用する方法を示しています。

Swift


// ...

// Initialize the Gemini Developer API backend service.
// Create a `TemplateGenerativeModel` instance.
let model = FirebaseAI.firebaseAI(backend: .googleAI()).templateGenerativeModel()

let customerName = "Jane"

do {
    let response = try await model.generateContent(
        // Specify your template ID
        templateID: "my-first-template-v1-0-0",
        // Provide the values for any input variables required by your template.
        inputs: [
            "customerName": customerName
        ]
    )
    if let text = response.text {
        print("Response Text: \(text)")
    }
} catch {
    print("An error occurred: \(error)")
}
print("\n")

Kotlin


// ...

// Initialize the Gemini Developer API backend service.
// Create a `TemplateGenerativeModel` instance.
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).templateGenerativeModel()

val customerName = "Jane"

val response = model.generateContent(
    // Specify your template ID.
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf(
        "customerName" to customerName
    )
)

val text = response.text
println(text)

Java


// ...

// Initialize the Gemini Developer API backend service.
// Create a `TemplateGenerativeModel` instance.
TemplateGenerativeModel generativeModel = FirebaseAI.getInstance().templateGenerativeModel();

TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(generativeModel);

String customerName = "Jane";

Future response = model.generateContent(
    // Specify your template ID
    "my-first-template-v1-0-0",
    // Provide the values for any input variables required by your template.
    mapOf("customerName", customerName)
);
addCallback(response,
       new FutureCallback() {
           public void onSuccess(GenerateContentResponse result) {
             System.out.println(result.getText());
           }
           public void onFailure(Throwable t) {
             reportError(t);
           }
    }
executor);

Web


// ...

// Initialize the Gemini Developer API backend service.
const ai = getAI(app, { backend: new GoogleAIBackend() });

// Create a `TemplateGenerativeModel` instance.
const model = getTemplateGenerativeModel(ai);

const customerName = 'Jane';

const result = await model.generateContent(
  // Specify your template ID.
  'my-first-template-v1-0-0',
  // Provide the values for any input variables required by your template.
  {
    customerName: customerName,
  }
);

const response = result.response;
const text = response.text();

Dart


// ...

// Initialize the Gemini Developer API backend service.
// Create a `TemplateGenerativeModel` instance.
var _model = FirebaseAI.googleAI().templateGenerativeModel()

var customerName = 'Jane';

var response = await _model.generateContent(
        // Specify your template ID
        'my-first-template-v1-0-0',
        // Provide the values for any input variables required by your template.
        inputs: {
           'customerName': customerName,
        },
      );

var text = response?.text;
print(text);

Unity


// ...

// Initialize the Gemini Developer API backend service.
var firebaseAI = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// Create a `TemplateGenerativeModel` instance.
var model = firebaseAI.GetTemplateGenerativeModel();

var customerName = "Jane";

try
{
   var response = await model.GenerateContentAsync(
      // Specify your template ID.
      "my-first-template-v1-0-0",
      // Provide the values for any input variables required by your template.
      new Dictionary<string, object> {
         { "customerName", customerName },
      }
   );
   Debug.Log($"Response Text: {response.Text}");
}
catch (Exception e) {
  Debug.LogError($"An error occurred: {e.Message}");
}

詳しい手順

このセクションでは、サーバープロンプトテンプレートの作成、テスト、使用に関する詳細な手順について説明します。

始める前に

まだ行っていない場合は、スタートガイドに沿って、記載されている手順（Firebase プロジェクトの設定、アプリと Firebase の連携、SDK の追加、選択した Gemini API プロバイダのバックエンドサービスの初期化、GenerativeModel インスタンスの作成）を完了します。
サーバープロンプトテンプレートの作成と管理に必要な権限があることを確認します。デフォルトでは、これらの権限はすべてオーナーロールに含まれています。
必要な権限を表示
- firebasevertexai.googleapis.com/promptTemplates.create
- firebasevertexai.googleapis.com/promptTemplates.get
- firebasevertexai.googleapis.com/promptTemplates.update
- firebasevertexai.googleapis.com/promptTemplates.delete
- firebasevertexai.googleapis.com/promptTemplates.list
- firebasevertexai.googleapis.com/promptTemplates.updateLock
Agent Platform Gemini API (formerly Vertex AI) を使用し、ユースケースでロケーションベースの制限が必要な場合は、テンプレートの高度なワークフローがサポートされます。

ステップ 1: サーバープロンプトテンプレートを作成する

ほとんどのユースケースでは、Firebase コンソールでサーバープロンプトテンプレートを作成して管理します。

Firebase コンソールで、[AI サービス] > [AI ロジック] > [プロンプトテンプレート] タブに移動します。
[新しいテンプレートを作成] をクリックし、スターターテンプレートオプションを選択します。
- これらのスターターテンプレートは、一般的なユースケースの形式と構文を提供します。どのオプションを選択しても、ニーズに合わせてテンプレートを完全に変更できます。
- このスタートガイドは、Input + System Instructions オプションを選択していることを前提としています。
テンプレートの識別子を入力します。
- テンプレート名: テンプレートの表示名（例: My First Template）。Firebase コンソールなどの Firebase インターフェース内でのみ表示されます。
- テンプレート ID: Firebase プロジェクト内のテンプレートで一意の ID を指定してください（例: my-first-template-v1-0-0）。この ID は、アプリからのリクエストで参照されます。
  - テンプレート ID にはバージョン管理システムを使用することをおすすめします。
  - テンプレート ID は最大 63 文字で、英小文字、数字、ハイフンを使用できます。
必要に応じて、テンプレートの構成（フロントマター）セクションを変更します。
- このセクションには、少なくとも次のようなモデル名を含める必要があります。
```
---
model: 'gemini-3.8-flash'
---
```
- 必要に応じて、モデルの構成、入出力制御などを指定することもできます。詳細とオプションについては、テンプレートの形式、構文、例をご覧ください。
必要に応じて、テンプレートの [プロンプトと（該当する場合）システム指示] セクションを変更します。
- このセクションには、モデルに送信するテキストプロンプトを少なくとも含める必要があります。
```
Write a story about a magic backpack.
```
- 次のような複雑なプロンプトを作成することもできます。詳細とオプションについては、テンプレートの形式、構文、例をご覧ください。
  - （必要に応じて）{{role "system"}} 構文を使用してシステム指示を指定し、{{role "user"}} 構文を使用してテキストプロンプトを指定します。
  - （省略可）Handlebars 構文（{{customerName}} など）を使用して入力変数を指定します。テンプレートでデフォルト値を指定できますが、通常、この入力変数の値はリクエストで渡されます。
```
{{role "system"}}
All output must be a clearly structured invoice document.
Use a tabular or clearly delineated list format for line items.

{{role "user"}}
Create an example customer invoice for a customer named {{customerName}}.
```

ステップ 2: Firebase コンソールでテンプレートをテストする

Firebase コンソールでは、テンプレートのテストエクスペリエンスが提供されます。このエクスペリエンスでは、テンプレートが使用されたときに何が起こるかを確認できます。リクエストの形式と実際のリクエストの出力の両方を確認できます。

[テンプレートを保存] をクリックして、テンプレートをテストできるようにします。

テンプレートは後でいつでも編集または削除できます。後で変更できない値はテンプレート ID のみです。
プロンプトで入力変数を使用する場合は、[テスト入力] フィールドにテスト値を含めます。この例では、
```
  {
    "customerName": "Jane"
  }
```
Firebase プロジェクトで複数の Gemini API プロバイダが有効になっている場合は、テストリクエストに使用するプロバイダを選択できます。このオプションがコンソールに表示されたら、Gemini Developer API または Agent Platform Gemini API（以前の Vertex AI）のいずれかを選択します。

この選択は、Firebase コンソールのテストエクスペリエンスを通じて送信されたリクエストにのみ適用されます。アプリからの実際のリクエストでは、他のリクエストと同様に、選択した Gemini API プロバイダを指定します。

[フォーマットされたテストリクエストを作成] ボタンをクリックします。

画面の右側に表示された形式設定済みのテストリクエストを確認し、テンプレートのフィールドを必要に応じて変更します。

開いて、フォーマットされたテストリクエストの例を表示する

{
  "model": "projects/YOUR_PROJECT_ID/models/gemini-3.8-flash",
  "contents": [{
    "parts": [{
      "text": "Create an example customer invoice for a customer named Jane"
    }],
    "role": "user"
  }],
  "systemInstruction": {
    "parts": [{
      "text": "All output must be a clearly structured invoice document.\nUse a tabular or clearly delineated list format for line items."
    }]
  }
}

フォーマットされたテストリクエストに問題がなければ、[プロンプトテストを実行] ボタンをクリックします。

画面の右側に表示された テストレスポンスを確認し、テンプレートのフィールドを必要に応じて変更します。

開いてテストの回答例を表示する

{
  "candidates": [{
    "content": {
      "parts": [{
        "text": "```\n--------------------------------------------------------------------------------\n                         **INVOICE**\n--------------------------------------------------------------------------------\n\n**Creative Solutions Inc.**\n123 Business Lane, Suite 100\nAnytown, USA 12345\nPhone: (555) 123-4567\nEmail: info@creativesolutions.com\n\n**INVOICE NO:** INV-2023-001\n**INVOICE DATE:** October 26, 2023\n**DUE DATE:** November 25, 2023\n\n**BILL TO:**\nJane\n456 Client Street, Apt 2B\nAnytown, USA 12346\nPhone: (555) 987-6543\nEmail: jane@example.com\n\n--------------------------------------------------------------------------------\n**ITEM DESCRIPTION**               **QTY**   **UNIT PRICE**   **AMOUNT**\n--------------------------------------------------------------------------------\nWebsite Design Services            1         $800.00          $800.00\nContent Creation (Blog Posts)      4         $120.00          $480.00\nMonthly Hosting \u0026 Maintenance      1         $50.00           $50.00\nConsultation Fee                   2         $75.00           $150.00\n--------------------------------------------------------------------------------\n\n**SUMMARY:**\nSubtotal:                                                     $1,480.00\nSales Tax (8%):                                               $118.40\n--------------------------------------------------------------------------------\n**TOTAL DUE:**                                                **$1,598.40**\n--------------------------------------------------------------------------------\n\n**PAYMENT TERMS:**\nPayment is due within 30 days of the invoice date. Please make checks payable to Creative Solutions Inc. For electronic payments, please contact us for details.\n\nThank you for your business!\n```"
      }],
      "role": "model"
    },
    "finishReason": "STOP",
    "index": 0
  }],
  "usageMetadata": {
    "promptTokenCount": 34,
    "candidatesTokenCount": 418,
    "totalTokenCount": 890,
    "promptTokensDetails": [{
      "modality": "TEXT",
      "tokenCount": 34
    }],
    "thoughtsTokenCount": 438
  },
  "modelVersion": "gemini-3.8-flash",
  "responseId": "3w4Vad6yF-y1vdIP_q_zgAw",
  "turnToken": "v1:ChczdzRWYWQ2eUYteTF2ZElQX3FfemdBdxIXM3c0VmFkNnlGLXkxdmRJUF9xX3pnQXc"
}

アプリのコードからテンプレートにアクセスする準備ができたら、テンプレートの右上にあるロックアイコンをクリックして、テンプレートをロックします。
[閉じる] をクリックして編集画面を終了します。

ステップ 3: コードからテンプレートにアクセスする

Gemini API プロバイダをクリックして、このページでプロバイダ固有のコンテンツとコードを表示します。

サーバープロンプトテンプレートを使用するリクエストは、他のリクエストと似ていますが、次の点が異なります。

templateGenerativeModel を使用します。
テンプレート ID を指定します。
テンプレートに必要な変数入力の値を指定します。

テンプレートを作成または更新した後、コードからアクセスする前に、テンプレートが Firebase サーバー全体に反映されるまで数分待つ必要がある場合があります。