All Gemini 1.0 and Gemini 1.5 models are now retired.
To avoid service disruption, update to a newer model (for example, gemini-2.5-flash-lite). Learn more.

このページは Cloud Translation API によって翻訳されました。

アプリでモデル名をリモートで変更する

生成 AI モデルの可用性は頻繁に変更されます。新しい高性能モデルがリリースされ、古い低性能モデルは廃止されます。

Firebase AI Logic を使用してモバイルアプリやウェブアプリから生成 AI モデルに直接アクセスする場合は、これらの頻繁なモデルの変更に対応するようにアプリを構成することが重要です。すべてのユーザーがアプリの最新バージョンに更新して、必要なモデルを使用するわけではありません。

Firebase Remote Config を使用すると、新しいバージョンのアプリをリリースしなくても、Firebase コンソールからアプリのパラメータ値（モデル名など）を動的にリモートで更新できます。

モデル名の変更は、Firebase AI Logic で Remote Config を使用する際の重要なユースケースですが、Remote Config を使用して、モデル生成の構成（最大トークン数、温度など）、安全性設定、システム指示、プロンプトデータなどのアプリのパラメータを動的かつ条件付きで制御することもできます。

このガイドでは、アプリで Remote Config を実装する方法について説明します。特に、アプリで使用されるモデル名を制御する方法について説明します。

ステップ 1: Firebase コンソールでパラメータ値を設定する

Remote Config クライアントテンプレートを作成し、アプリでフェッチして使用する model_name パラメータとその値を構成します。

Firebase コンソールで Firebase プロジェクトを開きます。次に、ナビゲーションメニューから [実行] を開いて、Remote Config を選択します。
ページの上部にある [クライアント/サーバー] セレクタで [クライアント] が選択されていることを確認します。
[構成を作成]（または、以前にクライアントテンプレートを使用したことがある場合は [パラメータを追加]）をクリックして、クライアントテンプレートを開始します。

model_name パラメータを定義します。

パラメータ名	説明	タイプ	デフォルト値
`model_name`	モデル名。使用可能なモデル名をご確認ください。	文字列	`gemini-2.5-flash`

このパラメータを追加したら、[変更を公開] をクリックします。新しい Remote Config テンプレートでない場合は、変更内容を確認し、もう一度 [変更を公開] をクリックします。

ステップ 2: アプリに Remote Config を追加して初期化する

Remote Config ライブラリを追加し、アプリ内で Remote Config を設定します。

Swift

Firebase AI Logic の設定の一環として、Firebase SDK はすでにアプリに追加されていますが、Remote Config も追加する必要があります。

Xcode でプロジェクトを開き、[ファイル] > [パッケージの依存関係を追加] の順に移動します。
[Firebase iOS SDK] を選択し、[パッケージを追加] をクリックします。
プロジェクトナビゲータで、ご使用のアプリ > [ターゲット] > ご使用のアプリを選択します。
[全般] タブで、[フレームワーク、ライブラリ、埋め込みコンテンツ] までスクロールします。
[+] をクリックして [FirebaseRemoteConfig] を選択し、[追加] をクリックします。
コードに FirebaseRemoteConfig のインポートを追加します。
```
import FirebaseRemoteConfig
```
アプリの適切なクラスで、Firebase を初期化し、メインのアプリケーションロジックに Remote Config を追加します。

ここでは、Remote Config と Remote Config リアルタイムリスナーをインポートとして追加することで、アプリが新しい値をリアルタイムでフェッチし、フェッチの最小間隔を追加できるようにします。
```
let remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings
```
注:この例では、デフォルトのフェッチ間隔は 3,600 秒ですが、開発中はコード内の最小フェッチ間隔を比較的短い値に設定することをおすすめします。

Kotlin

モジュール（アプリレベル）の Gradle ファイル（通常は app/build.gradle.kts または app/build.gradle）に Remote Config 依存関係を追加します。

dependencies {
    implementation(platform("com.google.firebase:firebase-bom:34.5.0"))
    implementation("com.google.firebase:firebase-ai")
    implementation("com.google.firebase:firebase-config")
    // ... other dependencies
}

Remote Config をメインのアプリケーションロジックに追加します。ここでは、Remote Config を初期化し、最小フェッチ間隔を追加します。
```
val remoteConfig: FirebaseRemoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)
```
注:この例では、デフォルトのフェッチ間隔は 3,600 秒ですが、開発中はコード内の最小フェッチ間隔を比較的短い値に設定することをおすすめします。

Java

モジュール（アプリレベル）の Gradle ファイル（通常は app/build.gradle.kts または app/build.gradle）に Remote Config 依存関係を追加します。

dependencies {
    implementation(platform("com.google.firebase:firebase-bom:34.5.0"))
    implementation("com.google.firebase:firebase-ai")
    implementation("com.google.firebase:firebase-config")
    // ... other dependencies
}

Remote Config をメインのアプリケーションロジックに追加します。ここでは、Remote Config を初期化し、最小フェッチ間隔を追加します。
```
FirebaseRemoteConfig mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
    .setMinimumFetchIntervalInSeconds(3600)
    .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);
```
注:この例では、デフォルトのフェッチ間隔は 3,600 秒ですが、開発中はコード内の最小フェッチ間隔を比較的短い値に設定することをおすすめします。

Web

テキストエディタでコードを開き、Remote Config をインポートします。
```
import { getRemoteConfig } from 'firebase/remote-config';
```
Firebase アプリが Firebase AI Logic SDK 用に初期化されたら、プライマリ関数内で Remote Config を初期化します。
```
  // Initialize Remote Config and get a reference to the service
  const remoteConfig = getRemoteConfig(app);
```
最小フェッチ間隔を設定します。
```
remoteConfig.settings.minimumFetchIntervalMillis = 3600000;
```
注:この例では、デフォルトのフェッチ間隔は 3,600 秒ですが、開発中はコード内の最小フェッチ間隔を比較的短い値に設定することをおすすめします。

Dart

Flutter プロジェクトディレクトリで、次のコマンドを使用して Remote Config をインストールして追加します。
```
flutter pub add firebase_remote_config
```

./lib/main.dart を開き、Firebase AI Logic をサポートするために追加した他のインポートの後にこのインポートを追加します。

import 'package:firebase_vertexai/firebase_ai.dart';
import 'package:firebase_core/firebase_core.dart';
import 'package:firebase_remote_config/firebase_remote_config.dart';

後で使用できるように、_modelName 変数をアプリに追加します。

late final String _modelName;
late final String _systemInstructions;
late final String _prompt;

Remote Config オブジェクトインスタンスを取得し、最小フェッチ間隔を設定して頻繁に更新できるようにします。必ず Firebase の初期化後にこれを追加してください。
```
  final remoteConfig = FirebaseRemoteConfig.instance;
  await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(seconds: 3600),
    minimumFetchInterval: const Duration(seconds: 3600),
  ));
```
注:この例では、デフォルトのフェッチ間隔は 3,600 秒ですが、開発中はコード内の最小フェッチ間隔を比較的短い値に設定することをおすすめします。

Unity

手順に沿って、Unity プロジェクトに Remote Config を追加します。
Remote Config オブジェクトインスタンスを取得し、最小フェッチ間隔を設定して頻繁に更新できるようにします。必ず Firebase の初期化後にこれを追加してください。
```
var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
const int MillisecondsPerSecond = 1000;
await remoteConfig.SetConfigSettingsAsync(new ConfigSettings() {
  FetchTimeoutInMilliseconds = 3600 * MillisecondsPerSecond,
  MinimumFetchIntervalInMilliseconds = 3600 * MillisecondsPerSecond
});
```
注:この例では、デフォルトのフェッチ間隔は 3,600 秒ですが、開発中はコード内の最小フェッチ間隔を比較的短い値に設定することをおすすめします。

ステップ 3: アプリ内のパラメータ値を設定する

アプリ内のデフォルトパラメータ値は Remote Config オブジェクトに設定する必要があります。これにより、Remote Config サービスから値をフェッチできない場合でも、アプリが想定どおりに動作します。

Swift

Firebase コンソールで Remote Config を開きます。
[パラメータ] タブで [メニュー] を開き、[デフォルト値をダウンロード] を選択します。
メッセージが表示されたら、[.plist（iOS 用）] を有効にして、[ファイルをダウンロード] をクリックします。
ファイルをアプリケーションディレクトリに保存します。
Xcode でアプリを右クリックし、[ファイルを追加] を選択します。
[remote_config_defaults.plist] を選択し、[追加] をクリックします。

デフォルトファイルを参照するようにアプリコードを更新します。

// Set default values for Remote Config parameters.
remoteConfig.setDefaults(fromPlist: "remote_config_defaults")

Kotlin

Firebase コンソールで Remote Config を開きます。
[パラメータ] タブで [メニュー] を開き、[デフォルト値をダウンロード] を選択します。
プロンプトが表示されたら、[.xml（Android 用）] を有効にして、[ファイルをダウンロード] をクリックします。
ファイルをアプリの XML リソースディレクトリに保存します。
メインアクティビティファイルを更新して、前に追加した configSettings の後にデフォルトを追加します。
```
// Set default values for Remote Config parameters.
remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)
```

Java

Firebase コンソールで Remote Config を開きます。
[パラメータ] タブで [メニュー] を開き、[デフォルト値をダウンロード] を選択します。
プロンプトが表示されたら、[.xml（Android 用）] を有効にして、[ファイルをダウンロード] をクリックします。
ファイルをアプリの XML リソースディレクトリに保存します。
メインアクティビティファイルを更新して、前に追加した configSettings の後にデフォルトを追加します。
```
// Set default values for Remote Config parameters.
mFirebaseRemoteConfig.setDefaultsAsync(R.xml.remote_config_defaults);
```

Web

モデル名のデフォルト値は、コード内で直接設定できます。

// Set default values for Remote Config parameters.
remoteConfig.defaultConfig = {
  model_name: 'gemini-2.5-flash',
};

Dart

モデル名のデフォルト値は、コード内で直接設定できます。

// Set default values for Remote Config parameters.
remoteConfig.setDefaults(const {
  "model_name": "gemini-2.5-flash"
});

Unity

モデル名のデフォルト値は、コード内で直接設定できます。

// Set default values for Remote Config parameters.
await remoteConfig.SetDefaultsAsync(
  new System.Collections.Generic.Dictionary<string, object>() {
    { "model_name", "gemini-2.5-flash" }
  }
);

ステップ 4: 値をフェッチして有効にする

モデル名のデフォルト値を設定したら、以下を追加し、値をフェッチして有効にします。

Swift

// Fetch and activate Remote Config values
remoteConfig.fetchAndActivate { status, error in
  if let error = error {
    print("Error fetching Remote Config: \(error.localizedDescription)")
  }
}

これにより、新しい Remote Config テンプレートが公開されるたびに Remote Config オブジェクトが更新されます。

Kotlin

// Fetch and activate Remote Config values
remoteConfig.fetchAndActivate()
      .addOnCompleteListener(this) { task ->
          if (task.isSuccessful) {
              val updated = task.result
              Log.d(TAG, "Remote Config values fetched and activated: $updated")
          } else {
              Log.e(TAG, "Error fetching Remote Config", task.exception)
          }
      }

Java

  // Fetch and activate Remote Config values
  mFirebaseRemoteConfig.fetchAndActivate()
    .addOnCompleteListener(this, new OnCompleteListener<Boolean>() {
        @Override
        public void onComplete(@NonNull Task<Boolean> task) {
            if (task.isSuccessful()) {
                boolean updated = task.getResult();
                Log.d(TAG, "Config params updated: " + updated);
            } else {
                Log.e(TAG, "Error fetching Remote Config", task.exception)
            }
          }
    });

Web

インポートに getValue と fetchAndActivate を追加します。

import { getValue, fetchAndActivate } from 'firebase/remote-config';

モデル名のデフォルト値を指定するコードを見つけます。そのコードブロックの直後に、次のコードを追加して、構成をフェッチして有効にし、フェッチした値を modelName 定数に割り当てます。

// Fetch and activate Remote Config.
try {
  await fetchAndActivate(remoteConfig);
} catch(err) {
  console.error('Remote Config fetch failed', err);
}

console.log('Remote Config fetched.');

// Assign Remote Config values.
const modelName = getValue(remoteConfig, 'model_name').asString();

Dart

// Fetch and activate Remote Config.
remoteConfig.fetchAndActivate();

// Assign Remote Config values.
String? _modelName = remoteConfig.getString("model_name");

Unity

// Fetch and activate Remote Config values.
await remoteConfig.FetchAndActivateAsync();

ステップ 5: リアルタイム Remote Config リスナーを追加する

リアルタイム Remote Config リスナーをアプリに追加して、Remote Config テンプレートに加えた変更内容が、更新後すぐにクライアントに伝搬されるようにします。

次のコードは、パラメータ値が変更されるたびに Remote Config オブジェクトを更新します。

Swift

// Add real-time Remote Config
remoteConfig.addOnConfigUpdateListener { configUpdate, error in
  guard let configUpdate = configUpdate, error == nil else {
    print("Error listening for config updates: \(error?.localizedDescription ?? "No error available")")
    return
  }

  print("Updated keys: \(configUpdate.updatedKeys)")
  remoteConfig.activate { changed, error in
    guard error == nil else {
      print("Error activating config: \(error?.localizedDescription ?? "No error available")")
      return
    }
    print("Activated config successfully")
  }
}

Kotlin

必要に応じて、addOnCompleteListener の有効化内でアクションを構成することもできます。

      // Add a real-time Remote Config listener
      remoteConfig.addOnConfigUpdateListener(object : ConfigUpdateListener {
          override fun onUpdate(configUpdate : ConfigUpdate) {
              Log.d(ContentValues.TAG, "Updated keys: " + configUpdate.updatedKeys);
              remoteConfig.activate().addOnCompleteListener {
                  // Optionally, add an action to perform on update here.
              }
          }

          override fun onError(error : FirebaseRemoteConfigException) {
              Log.w(ContentValues.TAG, "Config update error with code: " + error.code, error)
          }
      }

Java

必要に応じて、addOnCompleteListener の有効化内でアクションを構成することもできます。

  // Add a real-time Remote Config listener
  remoteConfig.addOnConfigUpdateListener(new ConfigUpdateListener() {
      @Override
      public void onUpdate(ConfigUpdate configUpdate) {
          Log.d(ContentValues.TAG, "Updated keys: " + configUpdate.getUpdatedKeys());
                remoteConfig.activate().addOnCompleteListener(new OnCompleteListener<Boolean>() {
                  @Override
                  public void onComplete(@NonNull Task<Boolean> task) {
                      // Optionally, add an action to perform on update here.
                  }
              });
          }

      @Override
      public void onError(FirebaseRemoteConfigException error) {
          Log.w(ContentValues.TAG, "Config update error with code: " + error.getCode(), error);
      }
  });

Web

ウェブアプリでは、リアルタイム Remote Config リスナーはサポートされていません。

Dart

// Add a real-time Remote Config listener
remoteConfig.onConfigUpdated.listen((event) async {
  await remoteConfig.activate();
});

Unity

// Add a real-time Remote Config listener to automatically update whenever
// a new template is published.
// Note: the parameters can be anonymous as they are unused.

remoteConfig.OnConfigUpdateListener += (_, _) => {
  remoteConfig.ActivateAsync();
};

ステップ 6: Remote Config 値を使用するように Gemini API リクエストを更新する

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

Remote Config が完全に構成されたので、コードを更新して、ハードコードされた値を Remote Config から取得した値に置き換えます。

Swift

import FirebaseAI

// When creating a `GenerativeModel` instance, source the model name value from Remote Config
let modelName = remoteConfig.configValue(forKey: "model_name").stringValue
let model = FirebaseAI.firebaseAI(backend: .googleAI()).generativeModel(
  modelName: modelName
)

// ...

Kotlin

// When creating a `GenerativeModel` instance, source the model name value from Remote Config
val model = Firebase.ai(backend = GenerativeBackend.googleAI()).generativeModel(
  modelName = remoteConfig.getString("model_name")
)

// ...

Java

// When creating a `GenerativeModel` instance, source the model name value from Remote Config
GenerativeModel ai = FirebaseAI.getInstance(GenerativeBackend.googleAI())
    .generativeModel(
      /* modelName */ remoteConfig.getString("model_name"),
      /* generationConfig (optional) */ null,
      /* safetySettings (optional) */ null,
      /* requestOptions (optional) */ new RequestOptions(),
      /* tools (optional) */ null,
      /* toolsConfig (optional) */ null,
      /* systemInstruction (optional) */ null,
    );

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

Web

// ...

const ai = getAI(firebaseApp, { backend: new GoogleAIBackend() });

// When creating a `GenerativeModel` instance, source the model name value from Remote Config
const model = getGenerativeModel(ai, {
  model: modelName
});

// ...

Dart

// ...

// When creating a `GenerativeModel` instance, source the model name value from Remote Config
final model = FirebaseAI.googleAI().generativeModel(
  model: _modelName,
);

// ...

Unity

// ...

var ai = FirebaseAI.GetInstance(FirebaseAI.Backend.GoogleAI());

// When creating a `GenerativeModel` instance, source the model name value from Remote Config
var modelName = remoteConfig.GetValue("model_name").StringValue;
var model = ai.GetGenerativeModel(
  modelName: modelName
);

// ...

ステップ 7: アプリを実行する

アプリをビルドして実行し、動作することを確認します。Firebase コンソールの Remote Config ページで構成を変更し、変更をパブリッシュして結果を確認します。

次のステップ

Remote Config と Firebase AI Logic の他のユースケースの実装について学習する。
モバイルアプリやゲームの場合:
- Remote Config と A/B Testing を使用して、さまざまなモデル設定をテストする。
- Remote Config ロールアウトを使用して、モデルパラメータの変更を段階的にリリースする（iOS + と Android のみ）。
- Remote Config のパーソナライズを使用して、機械学習で個々のユーザーに最適な設定を決定する（iOS+、Android、Unity のみ）。

アプリでモデル名をリモートで変更する コレクションでコンテンツを整理 必要に応じて、コンテンツの保存と分類を行います。

ステップ 1: Firebase コンソールでパラメータ値を設定する

ステップ 2: アプリに Remote Config を追加して初期化する

Swift

Kotlin

Java

Web

Dart

Unity

ステップ 3: アプリ内のパラメータ値を設定する

Swift

Kotlin

Java

Web

Dart

Unity

ステップ 4: 値をフェッチして有効にする

Swift

Kotlin

Java

Web

Dart

Unity

ステップ 5: リアルタイム Remote Config リスナーを追加する

Swift

Kotlin

Java

Web

Dart

Unity

ステップ 6: Remote Config 値を使用するように Gemini API リクエストを更新する

Swift

Kotlin

Java

Web

Dart

Unity

ステップ 7: アプリを実行する

次のステップ

アプリでモデル名をリモートで変更する