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.

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

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

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

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

Обратите внимание, что изменение имени модели является критически важным вариантом использования Remote Config с Firebase AI Logic , но вы также можете использовать 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 в своем приложении.

Быстрый

В рамках настройки 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
```
Примечание: в этом примере интервал выборки по умолчанию составляет 3600 секунд, но мы рекомендуем вам установить относительно низкий минимальный интервал выборки в вашем коде во время разработки.

Kotlin

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

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)
```
Примечание: в этом примере интервал выборки по умолчанию составляет 3600 секунд, но мы рекомендуем вам установить относительно низкий минимальный интервал выборки в вашем коде во время разработки.

Java

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);
```
Примечание: в этом примере интервал выборки по умолчанию составляет 3600 секунд, но мы рекомендуем вам установить относительно низкий минимальный интервал выборки в вашем коде во время разработки.

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;
```
Примечание: в этом примере интервал выборки по умолчанию составляет 3600 секунд, но мы рекомендуем вам установить относительно низкий минимальный интервал выборки в вашем коде во время разработки.

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),
  ));
```
Примечание: в этом примере интервал выборки по умолчанию составляет 3600 секунд, но мы рекомендуем вам установить относительно низкий минимальный интервал выборки в вашем коде во время разработки.

Единство

Добавьте Remote Config в свой проект Unity, следуя этим инструкциям .
Получите экземпляр объекта Remote Config и установите минимальный интервал выборки, чтобы обеспечить частое обновление. Добавьте это после инициализации Firebase.
```
var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
const int MillisecondsPerSecond = 1000;
await remoteConfig.SetConfigSettingsAsync(new ConfigSettings() {
  FetchTimeoutInMilliseconds = 3600 * MillisecondsPerSecond,
  MinimumFetchIntervalInMilliseconds = 3600 * MillisecondsPerSecond
});
```
Примечание: в этом примере интервал выборки по умолчанию составляет 3600 секунд, но мы рекомендуем вам установить относительно низкий минимальный интервал выборки в вашем коде во время разработки.

Шаг 3 : Задайте значение параметра в приложении

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

Быстрый

В консоли 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"
});

Единство

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

// Set default values for Remote Config parameters.
await remoteConfig.SetDefaultsAsync(
  new System.Collections.Generic.Dictionary<string, object>() {
    { "model_name", "gemini-2.5-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

Добавьте 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");

Единство

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

Прослушиватели Remote Config в реальном времени не поддерживаются для веб-приложений.

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 , чтобы просмотреть специфичный для этого поставщика контент и код на этой странице.

Теперь, когда 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 , опубликуйте изменения и проверьте результат.

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

Узнайте больше о реализации других вариантов использования Remote Config и Firebase AI Logic .
Для мобильных приложений и игр:
- Протестируйте различные настройки модели с помощью Remote Config и A/B Testing .
- Постепенно выпускайте изменения параметров модели с помощью развертываний Remote Config (только для iOS+ и Android).
- Используйте персонализацию Remote Config , чтобы использовать машинное обучение для определения оптимальных настроек для отдельных пользователей (только iOS+, Android и Unity).

Удаленно измените название модели в вашем приложении Оптимизируйте свои подборки Сохраняйте и классифицируйте контент в соответствии со своими настройками.

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

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

Быстрый

Kotlin

Java

Web

Dart

Единство

Шаг 3 : Задайте значение параметра в приложении

Быстрый

Kotlin

Java

Web

Dart

Единство

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

Быстрый

Kotlin

Java

Web

Dart

Единство

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

Быстрый

Kotlin

Java

Web

Dart

Единство

Шаг 6 : Обновите запросы API Gemini , чтобы использовать значение Remote Config

Быстрый

Kotlin

Java

Web

Dart

Единство

Шаг 7 : Запустите приложение.

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

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