Удаленно измените название модели в вашем приложении

Доступность моделей генеративного ИИ часто меняется — выпускаются новые, более совершенные модели, а старые, менее эффективные, отключаются.

При использовании Firebase AI Logic для прямого доступа к моделям генеративного ИИ из мобильного или веб-приложения крайне важно настроить приложение с учетом частых изменений моделей. Не все пользователи обновят приложение до последней версии, чтобы начать использовать необходимую им модель.

Firebase Remote Config позволяет динамически и удаленно обновлять значения параметров в вашем приложении (например, имя модели) из консоли Firebase , без необходимости выпуска новой версии приложения.

Обратите внимание, что изменение имени модели является критически важным сценарием использования Remote Config с Firebase AI Logic , но вы также можете использовать Remote Config для динамического и даже условного управления параметрами в вашем приложении , такими как конфигурация генерации модели (например, максимальное количество выходных токенов), параметры безопасности, системные инструкции и данные подсказок.

В этом руководстве описывается, как реализовать функцию Remote Config в вашем приложении, в частности, для управления именем модели, используемым в вашем приложении.

Шаг 1 : Установите значение параметра в консоли Firebase

Создайте шаблон клиента Remote Config и настройте параметр model_name и его значение для получения и использования в приложении.

  1. В консоли Firebase перейдите в раздел DevOps & Engagement > Remote Config .

  2. В верхней части страницы в меню выбора "Клиент/Сервер" выберите "Клиент" .

  3. Чтобы создать шаблон клиента, нажмите кнопку «Создать конфигурацию» (или «Добавить параметр», если вы уже использовали шаблоны клиентов).

  4. Определите параметр model_name :

    Имя параметра Описание Тип Значение по умолчанию
    model_name Название модели. См. доступные названия моделей . Нить gemini-3.7-flash

  5. После добавления этого параметра нажмите «Опубликовать изменения» . Если это не новый шаблон Remote Config , просмотрите изменения и снова нажмите «Опубликовать изменения» .

Шаг 2 : Добавьте и инициализируйте Remote Config в вашем приложении.

Добавьте библиотеку Remote Config и настройте Remote Config в своем приложении.

Быстрый

В рамках настройки Firebase AI Logic вы уже добавили Firebase SDK в свое приложение, но вам также потребуется добавить Remote Config .

  1. В Xcode, открыв проект, перейдите в меню File > Add Package Dependencies .

  2. Выберите firebase-ios-sdk и нажмите «Добавить пакет» .

  3. В навигаторе проекта выберите ваше приложение > Цели > ваше приложение.

  4. На вкладке «Общие» прокрутите вниз до раздела «Фреймворки, библиотеки и встроенный контент» .

  5. Нажмите кнопку «+» и выберите FirebaseRemoteConfig , затем нажмите «Добавить» .

  6. Добавьте импорт FirebaseRemoteConfig в свой код:

    import FirebaseRemoteConfig

  7. Внутри соответствующего класса вашего приложения инициализируйте Firebase и добавьте Remote Config в основную логику приложения.

    Здесь вам нужно будет импортировать Remote Config и слушатель событий реального времени Remote Config , чтобы приложение могло получать новые значения в режиме реального времени, а также добавить минимальный интервал получения данных:

    let remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings

Kotlin

  1. Добавьте зависимость Remote Config в файл Gradle вашего модуля (на уровне приложения) (обычно app/build.gradle.kts или app/build.gradle ):

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

  2. Добавьте Remote Config в основную логику вашего приложения. Здесь вы инициализируете Remote Config и зададите минимальный интервал выборки:

    val remoteConfig: FirebaseRemoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)

Java

  1. Добавьте зависимость Remote Config в файл Gradle вашего модуля (на уровне приложения) (обычно app/build.gradle.kts или app/build.gradle ):

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

  2. Добавьте Remote Config в основную логику вашего приложения. Здесь вы инициализируете Remote Config и зададите минимальный интервал выборки:

    FirebaseRemoteConfig mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
    .setMinimumFetchIntervalInSeconds(3600)
    .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);

Web

  1. Откройте свой код в текстовом редакторе и импортируйте Remote Config :

    import { getRemoteConfig } from 'firebase/remote-config';

  2. Внутри вашей основной функции, после инициализации приложения Firebase для Firebase AI Logic SDK, выполните инициализацию Remote Config :

      // Initialize Remote Config and get a reference to the service
  const remoteConfig = getRemoteConfig(app);

  3. Установите минимальный интервал получения данных:

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

Dart

  1. В каталоге вашего проекта Flutter установите и добавьте Remote Config , используя следующую команду: 

    flutter pub add firebase_remote_config

  2. Откройте файл ./lib/main.dart и добавьте импорт после других импортов, которые вы добавили для поддержки Firebase AI Logic : 

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

  3. Добавьте переменную _modelName в ваше приложение, чтобы вы могли использовать её позже: 

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

  4. Получите экземпляр объекта Remote Config и установите минимальный интервал выборки, чтобы обеспечить частое обновление. Обязательно добавьте это после инициализации Firebase. 

      final remoteConfig = FirebaseRemoteConfig.instance;
  await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(seconds: 3600),
    minimumFetchInterval: const Duration(seconds: 3600),
  ));

Единство

  1. Добавьте Remote Config в свой проект Unity, следуя этим инструкциям .

  2. Получите экземпляр объекта Remote Config и установите минимальный интервал выборки, чтобы обеспечить частое обновление. Обязательно добавьте это после инициализации Firebase. 

    var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
const int MillisecondsPerSecond = 1000;
await remoteConfig.SetConfigSettingsAsync(new ConfigSettings() {
  FetchTimeoutInMilliseconds = 3600 * MillisecondsPerSecond,
  MinimumFetchIntervalInMilliseconds = 3600 * MillisecondsPerSecond
});

Шаг 3 : Установите значение параметра в приложении.

В объекте Remote Config следует задать значения параметров по умолчанию для всего приложения. Это гарантирует корректную работу приложения, даже если оно не сможет получить значения из службы Remote Config .

Быстрый

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку файлов .plist для iOS , затем нажмите «Загрузить файл» .

  4. Сохраните файл в каталоге вашего приложения.

  5. В Xcode щелкните правой кнопкой мыши по своему приложению и выберите «Добавить файлы».

  6. Выберите файл remote_config_defaults.plist , затем нажмите «Добавить» .

  7. Обновите код вашего приложения, чтобы он ссылался на файл настроек по умолчанию: 

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

Kotlin

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку .xml для Android , затем нажмите «Скачать файл» .

  4. Сохраните файл в каталоге XML-ресурсов вашего приложения.

  5. Обновите основной файл активности, добавив значения по умолчанию после ранее добавленных configSettings : 

    // Set default values for Remote Config parameters.
remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)

Java

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку .xml для Android , затем нажмите «Скачать файл» .

  4. Сохраните файл в каталоге XML-ресурсов вашего приложения.

  5. Обновите основной файл активности, добавив значения по умолчанию после ранее добавленных 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-3.7-flash',
};

Dart

Вы можете задать значение по умолчанию для имени модели непосредственно в своем коде: 

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

Единство

Вы можете задать значение по умолчанию для имени модели непосредственно в своем коде: 

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

Шаг 4 : Получите и активируйте значение.

После установки значения по умолчанию для имени модели добавьте следующее, чтобы получить и активировать значения.

Быстрый 

// 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

  1. Добавьте getValue и fetchAndActivate в список импортируемых переменных: 

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

  2. Найдите фрагмент кода, где указывается значение по умолчанию для имени модели. Сразу после этого блока кода добавьте следующий код для получения и активации конфигурации и присвоения полученного значения константе 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");

Единство 

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

Шаг 5 : Добавьте прослушиватель Remote Config в реальном времени.

Добавьте в приложение обработчик Remote Config в реальном времени, чтобы гарантировать, что изменения, внесенные в шаблон Remote Config будут передаваться клиенту сразу после их обновления.

Приведенный ниже код обновляет объект Remote Config всякий раз, когда изменяется значение параметра.

Быстрый 

// 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 

 // Add a real-time Remote Config listener
 onConfigUpdate(remoteConfig, {
   next: (configUpdate) => {
      console.log("Updated keys:", configUpdate.getUpdatedKeys());
      if (configUpdate.getUpdatedKeys().has("welcome_message")) {
         activate(remoteConfig).then(() => {
         showWelcomeMessage();
         });
      }
   },
   error: (error) => {
      console.log("Config update error:", error);
   },
   complete: () => {
      console.log("Listening stopped.");
   }
});

Dart 

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

Единство 

// 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 : Обновите запросы к API Gemini , чтобы использовать значение из параметра Remote Config

Чтобы просмотреть контент и код, относящиеся к вашему поставщику API Gemini , нажмите на него.

Agent

Теперь, когда Remote Config полностью настроен, обновите свой код, заменив жестко заданные значения значениями, полученными из Remote Config .

Быстрый 

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,
);

// ...

Единство 

// ...

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 : Запустите приложение

Соберите и запустите приложение и убедитесь, что оно работает. Внесите изменения в конфигурацию на странице Remote Config в консоли Firebase , опубликуйте изменения и проверьте результат.

Следующие шаги

,

Доступность моделей генеративного ИИ часто меняется — выпускаются новые, более совершенные модели, а старые, менее эффективные, отключаются.

При использовании Firebase AI Logic для прямого доступа к моделям генеративного ИИ из мобильного или веб-приложения крайне важно настроить приложение с учетом частых изменений моделей. Не все пользователи обновят приложение до последней версии, чтобы начать использовать необходимую им модель.

Firebase Remote Config позволяет динамически и удаленно обновлять значения параметров в вашем приложении (например, имя модели) из консоли Firebase , без необходимости выпуска новой версии приложения.

Обратите внимание, что изменение имени модели является критически важным сценарием использования Remote Config с Firebase AI Logic , но вы также можете использовать Remote Config для динамического и даже условного управления параметрами в вашем приложении , такими как конфигурация генерации модели (например, максимальное количество выходных токенов), параметры безопасности, системные инструкции и данные подсказок.

В этом руководстве описывается, как реализовать функцию Remote Config в вашем приложении, в частности, для управления именем модели, используемым в вашем приложении.

Шаг 1 : Установите значение параметра в консоли Firebase

Создайте шаблон клиента Remote Config и настройте параметр model_name и его значение для получения и использования в приложении.

  1. В консоли Firebase перейдите в раздел DevOps & Engagement > Remote Config .

  2. В верхней части страницы в меню выбора "Клиент/Сервер" выберите "Клиент" .

  3. Чтобы создать шаблон клиента, нажмите кнопку «Создать конфигурацию» (или «Добавить параметр», если вы уже использовали шаблоны клиентов).

  4. Определите параметр model_name :

    Имя параметра Описание Тип Значение по умолчанию
    model_name Название модели. См. доступные названия моделей . Нить gemini-3.7-flash

  5. После добавления этого параметра нажмите «Опубликовать изменения» . Если это не новый шаблон Remote Config , просмотрите изменения и снова нажмите «Опубликовать изменения» .

Шаг 2 : Добавьте и инициализируйте Remote Config в вашем приложении.

Добавьте библиотеку Remote Config и настройте Remote Config в своем приложении.

Быстрый

В рамках настройки Firebase AI Logic вы уже добавили Firebase SDK в свое приложение, но вам также потребуется добавить Remote Config .

  1. В Xcode, открыв проект, перейдите в меню File > Add Package Dependencies .

  2. Выберите firebase-ios-sdk и нажмите «Добавить пакет» .

  3. В навигаторе проекта выберите ваше приложение > Цели > ваше приложение.

  4. На вкладке «Общие» прокрутите вниз до раздела «Фреймворки, библиотеки и встроенный контент» .

  5. Нажмите кнопку «+» и выберите FirebaseRemoteConfig , затем нажмите «Добавить» .

  6. Добавьте импорт FirebaseRemoteConfig в свой код:

    import FirebaseRemoteConfig

  7. Внутри соответствующего класса вашего приложения инициализируйте Firebase и добавьте Remote Config в основную логику приложения.

    Здесь вам нужно будет импортировать Remote Config и слушатель событий реального времени Remote Config , чтобы приложение могло получать новые значения в режиме реального времени, а также добавить минимальный интервал получения данных:

    let remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings

Kotlin

  1. Добавьте зависимость Remote Config в файл Gradle вашего модуля (на уровне приложения) (обычно app/build.gradle.kts или app/build.gradle ):

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

  2. Добавьте Remote Config в основную логику вашего приложения. Здесь вы инициализируете Remote Config и зададите минимальный интервал выборки:

    val remoteConfig: FirebaseRemoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)

Java

  1. Добавьте зависимость Remote Config в файл Gradle вашего модуля (на уровне приложения) (обычно app/build.gradle.kts или app/build.gradle ):

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

  2. Добавьте Remote Config в основную логику вашего приложения. Здесь вы инициализируете Remote Config и зададите минимальный интервал выборки:

    FirebaseRemoteConfig mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
    .setMinimumFetchIntervalInSeconds(3600)
    .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);

Web

  1. Откройте свой код в текстовом редакторе и импортируйте Remote Config :

    import { getRemoteConfig } from 'firebase/remote-config';

  2. Внутри вашей основной функции, после инициализации приложения Firebase для Firebase AI Logic SDK, выполните инициализацию Remote Config :

      // Initialize Remote Config and get a reference to the service
  const remoteConfig = getRemoteConfig(app);

  3. Установите минимальный интервал получения данных:

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

Dart

  1. В каталоге вашего проекта Flutter установите и добавьте Remote Config , используя следующую команду: 

    flutter pub add firebase_remote_config

  2. Откройте файл ./lib/main.dart и добавьте импорт после других импортов, которые вы добавили для поддержки Firebase AI Logic : 

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

  3. Добавьте переменную _modelName в ваше приложение, чтобы вы могли использовать её позже: 

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

  4. Получите экземпляр объекта Remote Config и установите минимальный интервал выборки, чтобы обеспечить частое обновление. Обязательно добавьте это после инициализации Firebase. 

      final remoteConfig = FirebaseRemoteConfig.instance;
  await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(seconds: 3600),
    minimumFetchInterval: const Duration(seconds: 3600),
  ));

Единство

  1. Добавьте Remote Config в свой проект Unity, следуя этим инструкциям .

  2. Получите экземпляр объекта Remote Config и установите минимальный интервал выборки, чтобы обеспечить частое обновление. Обязательно добавьте это после инициализации Firebase. 

    var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
const int MillisecondsPerSecond = 1000;
await remoteConfig.SetConfigSettingsAsync(new ConfigSettings() {
  FetchTimeoutInMilliseconds = 3600 * MillisecondsPerSecond,
  MinimumFetchIntervalInMilliseconds = 3600 * MillisecondsPerSecond
});

Шаг 3 : Установите значение параметра в приложении.

В объекте Remote Config следует задать значения параметров по умолчанию для всего приложения. Это гарантирует корректную работу приложения, даже если оно не сможет получить значения из службы Remote Config .

Быстрый

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку файлов .plist для iOS , затем нажмите «Загрузить файл» .

  4. Сохраните файл в каталоге вашего приложения.

  5. В Xcode щелкните правой кнопкой мыши по своему приложению и выберите «Добавить файлы».

  6. Выберите файл remote_config_defaults.plist , затем нажмите «Добавить» .

  7. Обновите код вашего приложения, чтобы он ссылался на файл настроек по умолчанию: 

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

Kotlin

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку .xml для Android , затем нажмите «Скачать файл» .

  4. Сохраните файл в каталоге XML-ресурсов вашего приложения.

  5. Обновите основной файл активности, добавив значения по умолчанию после ранее добавленных configSettings : 

    // Set default values for Remote Config parameters.
remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)

Java

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку .xml для Android , затем нажмите «Скачать файл» .

  4. Сохраните файл в каталоге XML-ресурсов вашего приложения.

  5. Обновите основной файл активности, добавив значения по умолчанию после ранее добавленных 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-3.7-flash',
};

Dart

Вы можете задать значение по умолчанию для имени модели непосредственно в своем коде: 

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

Единство

Вы можете задать значение по умолчанию для имени модели непосредственно в своем коде: 

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

Шаг 4 : Получите и активируйте значение.

После установки значения по умолчанию для имени модели добавьте следующее, чтобы получить и активировать значения.

Быстрый 

// 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

  1. Добавьте getValue и fetchAndActivate в список импортируемых переменных: 

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

  2. Найдите фрагмент кода, где указывается значение по умолчанию для имени модели. Сразу после этого блока кода добавьте следующий код для получения и активации конфигурации и присвоения полученного значения константе 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");

Единство 

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

Шаг 5 : Добавьте прослушиватель Remote Config в реальном времени.

Добавьте в приложение обработчик Remote Config в реальном времени, чтобы гарантировать, что изменения, внесенные в шаблон Remote Config будут передаваться клиенту сразу после их обновления.

Приведенный ниже код обновляет объект Remote Config всякий раз, когда изменяется значение параметра.

Быстрый 

// 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 

 // Add a real-time Remote Config listener
 onConfigUpdate(remoteConfig, {
   next: (configUpdate) => {
      console.log("Updated keys:", configUpdate.getUpdatedKeys());
      if (configUpdate.getUpdatedKeys().has("welcome_message")) {
         activate(remoteConfig).then(() => {
         showWelcomeMessage();
         });
      }
   },
   error: (error) => {
      console.log("Config update error:", error);
   },
   complete: () => {
      console.log("Listening stopped.");
   }
});

Dart 

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

Единство 

// 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 : Обновите запросы к API Gemini , чтобы использовать значение из параметра Remote Config

Чтобы просмотреть контент и код, относящиеся к вашему поставщику API Gemini , нажмите на него.

Agent

Теперь, когда Remote Config полностью настроен, обновите свой код, заменив жестко заданные значения значениями, полученными из Remote Config .

Быстрый 

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,
);

// ...

Единство 

// ...

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 : Запустите приложение

Соберите и запустите приложение и убедитесь, что оно работает. Внесите изменения в конфигурацию на странице Remote Config в консоли Firebase , опубликуйте изменения и проверьте результат.

Следующие шаги

,

Доступность моделей генеративного ИИ часто меняется — выпускаются новые, более совершенные модели, а старые, менее эффективные, отключаются.

При использовании Firebase AI Logic для прямого доступа к моделям генеративного ИИ из мобильного или веб-приложения крайне важно настроить приложение с учетом частых изменений моделей. Не все пользователи обновят приложение до последней версии, чтобы начать использовать необходимую им модель.

Firebase Remote Config позволяет динамически и удаленно обновлять значения параметров в вашем приложении (например, имя модели) из консоли Firebase , без необходимости выпуска новой версии приложения.

Обратите внимание, что изменение имени модели является критически важным сценарием использования Remote Config с Firebase AI Logic , но вы также можете использовать Remote Config для динамического и даже условного управления параметрами в вашем приложении , такими как конфигурация генерации модели (например, максимальное количество выходных токенов), параметры безопасности, системные инструкции и данные подсказок.

В этом руководстве описывается, как реализовать функцию Remote Config в вашем приложении, в частности, для управления именем модели, используемым в вашем приложении.

Шаг 1 : Установите значение параметра в консоли Firebase

Создайте шаблон клиента Remote Config и настройте параметр model_name и его значение для получения и использования в приложении.

  1. В консоли Firebase перейдите в раздел DevOps & Engagement > Remote Config .

  2. В верхней части страницы в меню выбора "Клиент/Сервер" выберите "Клиент" .

  3. Чтобы создать шаблон клиента, нажмите кнопку «Создать конфигурацию» (или «Добавить параметр», если вы уже использовали шаблоны клиентов).

  4. Определите параметр model_name :

    Имя параметра Описание Тип Значение по умолчанию
    model_name Название модели. См. доступные названия моделей . Нить gemini-3.7-flash

  5. После добавления этого параметра нажмите «Опубликовать изменения» . Если это не новый шаблон Remote Config , просмотрите изменения и снова нажмите «Опубликовать изменения» .

Шаг 2 : Добавьте и инициализируйте Remote Config в вашем приложении.

Добавьте библиотеку Remote Config и настройте Remote Config в своем приложении.

Быстрый

В рамках настройки Firebase AI Logic вы уже добавили Firebase SDK в свое приложение, но вам также потребуется добавить Remote Config .

  1. В Xcode, открыв проект, перейдите в меню File > Add Package Dependencies .

  2. Выберите firebase-ios-sdk и нажмите «Добавить пакет» .

  3. В навигаторе проекта выберите ваше приложение > Цели > ваше приложение.

  4. На вкладке «Общие» прокрутите вниз до раздела «Фреймворки, библиотеки и встроенный контент» .

  5. Нажмите кнопку «+» и выберите FirebaseRemoteConfig , затем нажмите «Добавить» .

  6. Добавьте импорт FirebaseRemoteConfig в свой код:

    import FirebaseRemoteConfig

  7. Внутри соответствующего класса вашего приложения инициализируйте Firebase и добавьте Remote Config в основную логику приложения.

    Здесь вам нужно будет импортировать Remote Config и слушатель событий реального времени Remote Config , чтобы приложение могло получать новые значения в режиме реального времени, а также добавить минимальный интервал получения данных:

    let remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings

Kotlin

  1. Добавьте зависимость Remote Config в файл Gradle вашего модуля (на уровне приложения) (обычно app/build.gradle.kts или app/build.gradle ):

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

  2. Добавьте Remote Config в основную логику вашего приложения. Здесь вы инициализируете Remote Config и зададите минимальный интервал выборки:

    val remoteConfig: FirebaseRemoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)

Java

  1. Добавьте зависимость Remote Config в файл Gradle вашего модуля (на уровне приложения) (обычно app/build.gradle.kts или app/build.gradle ):

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

  2. Добавьте Remote Config в основную логику вашего приложения. Здесь вы инициализируете Remote Config и зададите минимальный интервал выборки:

    FirebaseRemoteConfig mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
    .setMinimumFetchIntervalInSeconds(3600)
    .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);

Web

  1. Откройте свой код в текстовом редакторе и импортируйте Remote Config :

    import { getRemoteConfig } from 'firebase/remote-config';

  2. Внутри вашей основной функции, после инициализации приложения Firebase для Firebase AI Logic SDK, выполните инициализацию Remote Config :

      // Initialize Remote Config and get a reference to the service
  const remoteConfig = getRemoteConfig(app);

  3. Установите минимальный интервал получения данных:

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

Dart

  1. В каталоге вашего проекта Flutter установите и добавьте Remote Config , используя следующую команду: 

    flutter pub add firebase_remote_config

  2. Откройте файл ./lib/main.dart и добавьте импорт после других импортов, которые вы добавили для поддержки Firebase AI Logic : 

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

  3. Добавьте переменную _modelName в ваше приложение, чтобы вы могли использовать её позже: 

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

  4. Получите экземпляр объекта Remote Config и установите минимальный интервал выборки, чтобы обеспечить частое обновление. Обязательно добавьте это после инициализации Firebase. 

      final remoteConfig = FirebaseRemoteConfig.instance;
  await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(seconds: 3600),
    minimumFetchInterval: const Duration(seconds: 3600),
  ));

Единство

  1. Добавьте Remote Config в свой проект Unity, следуя этим инструкциям .

  2. Получите экземпляр объекта Remote Config и установите минимальный интервал выборки, чтобы обеспечить частое обновление. Обязательно добавьте это после инициализации Firebase. 

    var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
const int MillisecondsPerSecond = 1000;
await remoteConfig.SetConfigSettingsAsync(new ConfigSettings() {
  FetchTimeoutInMilliseconds = 3600 * MillisecondsPerSecond,
  MinimumFetchIntervalInMilliseconds = 3600 * MillisecondsPerSecond
});

Шаг 3 : Установите значение параметра в приложении.

В объекте Remote Config следует задать значения параметров по умолчанию для всего приложения. Это гарантирует корректную работу приложения, даже если оно не сможет получить значения из службы Remote Config .

Быстрый

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку файлов .plist для iOS , затем нажмите «Загрузить файл» .

  4. Сохраните файл в каталоге вашего приложения.

  5. В Xcode щелкните правой кнопкой мыши по своему приложению и выберите «Добавить файлы».

  6. Выберите файл remote_config_defaults.plist , затем нажмите «Добавить» .

  7. Обновите код вашего приложения, чтобы он ссылался на файл настроек по умолчанию: 

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

Kotlin

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку .xml для Android , затем нажмите «Скачать файл» .

  4. Сохраните файл в каталоге XML-ресурсов вашего приложения.

  5. Обновите основной файл активности, добавив значения по умолчанию после ранее добавленных configSettings : 

    // Set default values for Remote Config parameters.
remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)

Java

  1. В консоли Firebase перейдите на страницу DevOps & Engagement > Remote Config > Parameters .

  2. Откройте В меню выберите пункт «Загрузить значения по умолчанию» .

  3. При появлении запроса включите поддержку .xml для Android , затем нажмите «Скачать файл» .

  4. Сохраните файл в каталоге XML-ресурсов вашего приложения.

  5. Обновите основной файл активности, добавив значения по умолчанию после ранее добавленных 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-3.7-flash',
};

Dart

Вы можете задать значение по умолчанию для имени модели непосредственно в своем коде: 

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

Единство

Вы можете задать значение по умолчанию для имени модели непосредственно в своем коде: 

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

Шаг 4 : Получите и активируйте значение.

После установки значения по умолчанию для имени модели добавьте следующее, чтобы получить и активировать значения.

Быстрый 

// 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

  1. Добавьте getValue и fetchAndActivate в список импортируемых переменных: 

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

  2. Найдите фрагмент кода, где указывается значение по умолчанию для имени модели. Сразу после этого блока кода добавьте следующий код для получения и активации конфигурации и присвоения полученного значения константе 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");

Единство 

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

Шаг 5 : Добавьте прослушиватель Remote Config в реальном времени.

Добавьте в приложение обработчик Remote Config в реальном времени, чтобы гарантировать, что изменения, внесенные в шаблон Remote Config будут передаваться клиенту сразу после их обновления.

Приведенный ниже код обновляет объект Remote Config всякий раз, когда изменяется значение параметра.

Быстрый 

// 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 

 // Add a real-time Remote Config listener
 onConfigUpdate(remoteConfig, {
   next: (configUpdate) => {
      console.log("Updated keys:", configUpdate.getUpdatedKeys());
      if (configUpdate.getUpdatedKeys().has("welcome_message")) {
         activate(remoteConfig).then(() => {
         showWelcomeMessage();
         });
      }
   },
   error: (error) => {
      console.log("Config update error:", error);
   },
   complete: () => {
      console.log("Listening stopped.");
   }
});

Dart 

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

Единство 

// 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 : Обновите запросы к API Gemini , чтобы использовать значение из параметра Remote Config

Чтобы просмотреть контент и код, относящиеся к вашему поставщику API Gemini , нажмите на него.

Agent

Теперь, когда Remote Config полностью настроен, обновите свой код, заменив жестко заданные значения значениями, полученными из Remote Config .

Быстрый 

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,
);

// ...

Единство 

// ...

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 : Запустите приложение

Соберите и запустите приложение и убедитесь, что оно работает. Внесите изменения в конфигурацию на странице Remote Config в консоли Firebase , опубликуйте изменения и проверьте результат.

Следующие шаги

,

Доступность моделей генеративного ИИ часто меняется — выпускаются новые, более совершенные модели, а старые, менее эффективные, отключаются.

При использовании Firebase AI Logic для прямого доступа к моделям генеративного ИИ из мобильного или веб-приложения крайне важно настроить приложение с учетом частых изменений моделей. Не все пользователи обновят приложение до последней версии, чтобы начать использовать необходимую им модель.

Firebase Remote Config позволяет динамически и удаленно обновлять значения параметров в вашем приложении (например, имя модели) из консоли Firebase , без необходимости выпуска новой версии приложения.

Обратите внимание, что изменение имени модели является критически важным сценарием использования Remote Config с Firebase AI Logic , но вы также можете использовать Remote Config для динамического и даже условного управления параметрами в вашем приложении , такими как конфигурация генерации модели (например, максимальное количество выходных токенов), параметры безопасности, системные инструкции и данные подсказок.

В этом руководстве описывается, как реализовать функцию Remote Config в вашем приложении, в частности, для управления именем модели, используемым в вашем приложении.

Шаг 1 : Установите значение параметра в консоли Firebase

Создайте шаблон клиента Remote Config и настройте параметр model_name и его значение для получения и использования в приложении.

  1. В консоли Firebase перейдите в раздел DevOps & Engagement > Remote Config .

  2. В верхней части страницы в меню выбора "Клиент/Сервер" выберите "Клиент" .

  3. Чтобы создать шаблон клиента, нажмите кнопку «Создать конфигурацию» (или «Добавить параметр», если вы уже использовали шаблоны клиентов).

  4. Определите параметр model_name :

    Имя параметра Описание Тип Значение по умолчанию
    model_name Название модели. См. доступные названия моделей . Нить gemini-3.7-flash

  5. После добавления этого параметра нажмите «Опубликовать изменения» . Если это не новый шаблон Remote Config , просмотрите изменения и снова нажмите «Опубликовать изменения» .

Шаг 2 : Добавьте и инициализируйте Remote Config в вашем приложении.

Добавьте библиотеку Remote Config и настройте Remote Config в своем приложении.

Быстрый

В рамках настройки Firebase AI Logic вы уже добавили Firebase SDK в свое приложение, но вам также потребуется добавить Remote Config .

  1. В Xcode, открыв проект, перейдите в меню File > Add Package Dependencies .

  2. Выберите firebase-ios-sdk и нажмите «Добавить пакет» .

  3. В навигаторе проекта выберите ваше приложение > Цели > ваше приложение.

  4. На вкладке «Общие» прокрутите вниз до раздела «Фреймворки, библиотеки и встроенный контент» .

  5. Click + and choose FirebaseRemoteConfig , then click Add .

  6. Add the FirebaseRemoteConfig import to your code:

    import FirebaseRemoteConfig

  7. Inside the appropriate class for your app, initialize Firebase and add Remote Config to your main application logic.

    Here, you'll include Remote Config and the Remote Config real-time listener as imports so that the app can fetch new values in real-time, and add a minimum fetch interval:

    let remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings

Kotlin

  1. Add the Remote Config dependency to your module (app-level) Gradle file (usually app/build.gradle.kts or app/build.gradle ):

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

  2. Add Remote Config to your main application logic. Here, you'll initialize Remote Config and add a minimum fetch interval:

    val remoteConfig: FirebaseRemoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)

Java

  1. Add the Remote Config dependency to your module (app-level) Gradle file (usually app/build.gradle.kts or app/build.gradle ):

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

  2. Add Remote Config to your main application logic. Here, you'll initialize Remote Config and add a minimum fetch interval:

    FirebaseRemoteConfig mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
    .setMinimumFetchIntervalInSeconds(3600)
    .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);

Web

  1. Open your code in a text editor and import Remote Config :

    import { getRemoteConfig } from 'firebase/remote-config';

  2. Inside your primary function and after the Firebase app is initialized for Firebase AI Logic SDK, initialize Remote Config :

      // Initialize Remote Config and get a reference to the service
  const remoteConfig = getRemoteConfig(app);

  3. Set a minimum fetch interval:

    remoteConfig.settings.minimumFetchIntervalMillis = 3600000;

Dart

  1. From your Flutter project directory, install and add Remote Config using the following command: 

    flutter pub add firebase_remote_config

  2. Open ./lib/main.dart and add the import after the other imports you added to support Firebase AI Logic : 

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

  3. Add the _modelName variable to your app so that you can use it later: 

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

  4. Get the Remote Config object instance and set the minimum fetch interval to allow for frequent refreshes. Make sure to add this after Firebase is initialized. 

      final remoteConfig = FirebaseRemoteConfig.instance;
  await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(seconds: 3600),
    minimumFetchInterval: const Duration(seconds: 3600),
  ));

Единство

  1. Add Remote Config to your Unity project, following these instructions .

  2. Get the Remote Config object instance and set the minimum fetch interval to allow for frequent refreshes. Make sure to add this after Firebase is initialized. 

    var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
const int MillisecondsPerSecond = 1000;
await remoteConfig.SetConfigSettingsAsync(new ConfigSettings() {
  FetchTimeoutInMilliseconds = 3600 * MillisecondsPerSecond,
  MinimumFetchIntervalInMilliseconds = 3600 * MillisecondsPerSecond
});

Step 3 : Set the in-app parameter value

You should set in-app default parameter values in the Remote Config object. This ensures that your app behaves as expected even if it cannot fetch values from the Remote Config service.

Быстрый

  1. In the Firebase console, go to the DevOps & Engagement > Remote Config > Parameters page .

  2. Open the Menu , and select Download default values .

  3. When prompted, enable .plist for iOS , then click Download file .

  4. Save the file in the your application directory.

  5. In Xcode, right-click on your app and select Add Files

  6. Select remote_config_defaults.plist , then click Add .

  7. Update your app code to reference the defaults file: 

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

Kotlin

  1. In the Firebase console, go to the DevOps & Engagement > Remote Config > Parameters page .

  2. Open the Menu , and select Download default values .

  3. When prompted, enable .xml for Android , then click Download file .

  4. Save the file in your app's XML resources directory.

  5. Update your main activity file to add the defaults after the configSettings you added previously: 

    // Set default values for Remote Config parameters.
remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)

Java

  1. In the Firebase console, go to the DevOps & Engagement > Remote Config > Parameters page .

  2. Open the Menu , and select Download default values .

  3. When prompted, enable .xml for Android , then click Download file .

  4. Save the file in your app's XML resources directory.

  5. Update your main activity file to add the defaults after the configSettings you added previously: 

    // Set default values for Remote Config parameters.
mFirebaseRemoteConfig.setDefaultsAsync(R.xml.remote_config_defaults);

Web

You can set the default value for the model name directly in your code: 

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

Dart

You can set the default value for the model name directly in your code: 

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

Единство

You can set the default value for the model name directly in your code: 

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

Step 4 : Fetch and activate the value

After setting the default value for the model name, add the following to fetch and activate values.

Быстрый 

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

This should update the Remote Config object whenever a new Remote Config template is published.

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

  1. Add getValue and fetchAndActivate to your imports: 

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

  2. Locate the code where you specify the default value for the model name. Directly after that code block, add the following code to fetch and activate the config and assign the fetched value to the modelName constant. 

    // 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");

Единство 

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

Step 5 : Add a real-time Remote Config listener

Add a real-time Remote Config listener to your app to ensure that changes you make to the Remote Config template are propagated to the client as soon as they're updated.

The following code updates the Remote Config object whenever a parameter value changes.

Быстрый 

// 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

Optionally, you can also configure an action inside the addOnCompleteListener activation: 

      // 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

Optionally, you can also configure an action inside the addOnCompleteListener activation: 

  // 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 

 // Add a real-time Remote Config listener
 onConfigUpdate(remoteConfig, {
   next: (configUpdate) => {
      console.log("Updated keys:", configUpdate.getUpdatedKeys());
      if (configUpdate.getUpdatedKeys().has("welcome_message")) {
         activate(remoteConfig).then(() => {
         showWelcomeMessage();
         });
      }
   },
   error: (error) => {
      console.log("Config update error:", error);
   },
   complete: () => {
      console.log("Listening stopped.");
   }
});

Dart 

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

Единство 

// 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();
};

Step 6 : Update the Gemini API requests to use the Remote Config value

Click your Gemini API provider to view provider-specific content and code on this page.

Now that Remote Config is fully configured, update your code to replace hard-coded values with values sourced from Remote Config .

Быстрый 

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,
);

// ...

Единство 

// ...

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
);

// ...

Step 7 : Run the app

Build and run the app and verify that it works. Make changes to your configuration from the Remote Config page in the Firebase console, publish the changes, and verify the result.

Следующие шаги