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.

Trang này được dịch bởi Cloud Translation API.

Thay đổi từ xa tên mô hình trong ứng dụng

Các mô hình AI tạo sinh thường xuyên thay đổi – các mô hình mới, tốt hơn được phát hành và các mô hình cũ, kém hiệu quả hơn sẽ ngừng hoạt động.

Khi truy cập vào các mô hình AI tạo sinh ngay từ một ứng dụng di động hoặc ứng dụng web bằng Firebase AI Logic, bạn cần phải định cấu hình ứng dụng của mình để thích ứng với những thay đổi thường xuyên này của mô hình. Không phải tất cả người dùng của bạn sẽ cập nhật lên phiên bản mới nhất của ứng dụng để bắt đầu sử dụng mô hình mà bạn cần họ sử dụng.

Firebase Remote Config cho phép bạn cập nhật các giá trị tham số trong ứng dụng (chẳng hạn như tên mô hình) một cách linh động và từ xa thông qua bảng điều khiển Firebase mà không cần phát hành phiên bản mới của ứng dụng.

Xin lưu ý rằng việc thay đổi tên mô hình là một trường hợp sử dụng quan trọng khi dùng Remote Config với Firebase AI Logic, nhưng bạn cũng có thể dùng Remote Config để kiểm soát các tham số một cách linh hoạt và thậm chí có điều kiện trong ứng dụng của mình, chẳng hạn như cấu hình tạo mô hình (số lượng mã thông báo tối đa, nhiệt độ, v.v.), chế độ cài đặt an toàn, hướng dẫn hệ thống và dữ liệu câu lệnh.

Hướng dẫn này mô tả cách triển khai Remote Config trong ứng dụng của bạn, cụ thể là để kiểm soát tên mô hình được dùng trong ứng dụng.

Bước 1: Đặt giá trị tham số trong bảng điều khiển Firebase

Tạo một mẫu Remote Configmáy khách và định cấu hình một tham số model_name cùng giá trị của tham số đó để tìm nạp và sử dụng trong ứng dụng.

Mở dự án Firebase của bạn trong bảng điều khiển Firebase. Sau đó, trong trình đơn điều hướng, hãy mở rộng mục Chạy rồi chọn Remote Config.
Đảm bảo rằng bạn đã chọn Client (Máy khách) trong bộ chọn Client/Server (Máy khách/Máy chủ) ở đầu trang.
Bắt đầu một mẫu khách hàng bằng cách nhấp vào Tạo cấu hình (hoặc Thêm thông số nếu trước đây bạn đã sử dụng mẫu khách hàng).

Xác định tham số model_name:

Tên thông số	Mô tả	Loại	Giá trị mặc định
`model_name`	Tên mẫu thiết bị. Xem tên mẫu có sẵn.	Chuỗi	`gemini-2.5-flash`

Sau khi thêm thông số này, hãy nhấp vào Xuất bản thay đổi. Nếu đây không phải là mẫu Remote Config mới, hãy xem xét các thay đổi rồi nhấp lại vào Xuất bản thay đổi.

Bước 2: Thêm và khởi tạo Remote Config trong ứng dụng của bạn

Thêm thư viện Remote Config và thiết lập Remote Config trong ứng dụng của bạn.

Swift

Trong quá trình thiết lập Firebase AI Logic, bạn đã thêm SDK Firebase vào ứng dụng của mình, nhưng cũng cần thêm Remote Config.

Trong Xcode, khi dự án đang mở, hãy chuyển đến File > Add Package Dependencies (Tệp > Thêm phần phụ thuộc của gói).
Chọn firebase-ios-sdk rồi nhấp vào Add package (Thêm gói).
Trong Project navigator (Trình điều hướng dự án), hãy chọn ứng dụng của bạn > Targets (Mục tiêu) > ứng dụng của bạn.
Trong thẻ Chung, hãy di chuyển đến phần Framework, Thư viện và Nội dung được nhúng.
Nhấp vào + rồi chọn FirebaseRemoteConfig, sau đó nhấp vào Add (Thêm).
Thêm lệnh nhập FirebaseRemoteConfig vào mã của bạn:
```
import FirebaseRemoteConfig
```
Trong lớp thích hợp cho ứng dụng của bạn, hãy khởi động Firebase và thêm Remote Config vào logic ứng dụng chính.

Tại đây, bạn sẽ thêm Remote Config và trình nghe theo thời gian thực Remote Config làm các mục nhập để ứng dụng có thể tìm nạp các giá trị mới theo thời gian thực và thêm khoảng thời gian tìm nạp tối thiểu:
```
let remoteConfig = RemoteConfig.remoteConfig()
let settings = RemoteConfigSettings()
settings.minimumFetchInterval = 3600
remoteConfig.configSettings = settings
```
Lưu ý: Trong ví dụ này, khoảng thời gian tìm nạp mặc định là 3600 giây, nhưng bạn nên đặt khoảng thời gian tìm nạp tối thiểu tương đối thấp trong mã của mình trong quá trình phát triển.

Kotlin

Thêm phần phụ thuộc Remote Config vào tệp Gradle (cấp ứng dụng) của mô-đun (thường là app/build.gradle.kts hoặc 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
}

Thêm Remote Config vào logic ứng dụng chính của bạn. Tại đây, bạn sẽ khởi động Remote Config và thêm khoảng thời gian tìm nạp tối thiểu:
```
val remoteConfig: FirebaseRemoteConfig = Firebase.remoteConfig
val configSettings = remoteConfigSettings {
minimumFetchIntervalInSeconds = 3600
}
remoteConfig.setConfigSettingsAsync(configSettings)
```
Lưu ý: Trong ví dụ này, khoảng thời gian tìm nạp mặc định là 3600 giây, nhưng bạn nên đặt khoảng thời gian tìm nạp tối thiểu tương đối thấp trong mã của mình trong quá trình phát triển.

Java

Thêm phần phụ thuộc Remote Config vào tệp Gradle (cấp ứng dụng) của mô-đun (thường là app/build.gradle.kts hoặc 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
}

Thêm Remote Config vào logic ứng dụng chính của bạn. Tại đây, bạn sẽ khởi động Remote Config và thêm khoảng thời gian tìm nạp tối thiểu:
```
FirebaseRemoteConfig mFirebaseRemoteConfig = FirebaseRemoteConfig.getInstance();
FirebaseRemoteConfigSettings configSettings = new FirebaseRemoteConfigSettings.Builder()
    .setMinimumFetchIntervalInSeconds(3600)
    .build();
mFirebaseRemoteConfig.setConfigSettingsAsync(configSettings);
```
Lưu ý: Trong ví dụ này, khoảng thời gian tìm nạp mặc định là 3600 giây, nhưng bạn nên đặt khoảng thời gian tìm nạp tối thiểu tương đối thấp trong mã của mình trong quá trình phát triển.

Web

Mở mã của bạn trong một trình chỉnh sửa văn bản và nhập Remote Config:
```
import { getRemoteConfig } from 'firebase/remote-config';
```
Trong hàm chính và sau khi ứng dụng Firebase được khởi chạy cho SDK Firebase AI Logic, hãy khởi chạy Remote Config:
```
  // Initialize Remote Config and get a reference to the service
  const remoteConfig = getRemoteConfig(app);
```
Đặt khoảng thời gian tìm nạp tối thiểu:
```
remoteConfig.settings.minimumFetchIntervalMillis = 3600000;
```
Lưu ý: Trong ví dụ này, khoảng thời gian tìm nạp mặc định là 3600 giây, nhưng bạn nên đặt khoảng thời gian tìm nạp tối thiểu tương đối thấp trong mã của mình trong quá trình phát triển.

Dart

Trong thư mục dự án Flutter, hãy cài đặt và thêm Remote Config bằng lệnh sau:
```
flutter pub add firebase_remote_config
```

Mở ./lib/main.dart rồi thêm nội dung nhập sau các nội dung nhập khác mà bạn đã thêm để hỗ trợ 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';

Thêm biến _modelName vào ứng dụng để bạn có thể sử dụng biến này sau:

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

Lấy phiên bản đối tượng Remote Config và đặt khoảng thời gian tìm nạp tối thiểu để cho phép làm mới thường xuyên. Hãy nhớ thêm mã này sau khi Firebase được khởi chạy.
```
  final remoteConfig = FirebaseRemoteConfig.instance;
  await remoteConfig.setConfigSettings(RemoteConfigSettings(
    fetchTimeout: const Duration(seconds: 3600),
    minimumFetchInterval: const Duration(seconds: 3600),
  ));
```
Lưu ý: Trong ví dụ này, khoảng thời gian tìm nạp mặc định là 3600 giây, nhưng bạn nên đặt khoảng thời gian tìm nạp tối thiểu tương đối thấp trong mã của mình trong quá trình phát triển.

Unity

Thêm Remote Config vào dự án Unity của bạn theo hướng dẫn này.
Lấy phiên bản đối tượng Remote Config và đặt khoảng thời gian tìm nạp tối thiểu để cho phép làm mới thường xuyên. Hãy nhớ thêm mã này sau khi Firebase được khởi chạy.
```
var remoteConfig = FirebaseRemoteConfig.DefaultInstance;
const int MillisecondsPerSecond = 1000;
await remoteConfig.SetConfigSettingsAsync(new ConfigSettings() {
  FetchTimeoutInMilliseconds = 3600 * MillisecondsPerSecond,
  MinimumFetchIntervalInMilliseconds = 3600 * MillisecondsPerSecond
});
```
Lưu ý: Trong ví dụ này, khoảng thời gian tìm nạp mặc định là 3600 giây, nhưng bạn nên đặt khoảng thời gian tìm nạp tối thiểu tương đối thấp trong mã của mình trong quá trình phát triển.

Bước 3: Đặt giá trị tham số trong ứng dụng

Bạn nên đặt các giá trị tham số mặc định trong ứng dụng trong đối tượng Remote Config. Điều này đảm bảo ứng dụng của bạn hoạt động như mong đợi ngay cả khi không thể tìm nạp các giá trị từ dịch vụ Remote Config.

Swift

Trong bảng điều khiển Firebase, hãy mở Remote Config.
Trong thẻ Parameters (Tham số), hãy mở Menu (Trình đơn) rồi chọn Download default values (Tải giá trị mặc định xuống).
Khi được nhắc, hãy bật .plist cho iOS, rồi nhấp vào Tải tệp xuống.
Lưu tệp trong thư mục ứng dụng của bạn.
Trong Xcode, hãy nhấp chuột phải vào ứng dụng của bạn rồi chọn Add Files (Thêm tệp)
Chọn remote_config_defaults.plist, rồi nhấp vào Thêm.

Cập nhật mã ứng dụng để tham chiếu đến tệp mặc định:

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

Kotlin

Trên bảng điều khiển Firebase, hãy mở Remote Config.
Trong thẻ Parameters (Tham số), hãy mở Menu (Trình đơn) rồi chọn Download default values (Tải giá trị mặc định xuống).
Khi được nhắc, hãy bật .xml cho Android, rồi nhấp vào Tải tệp xuống.
Lưu tệp này trong thư mục tài nguyên XML của ứng dụng.
Cập nhật tệp hoạt động chính để thêm các giá trị mặc định sau configSettings mà bạn đã thêm trước đó:
```
// Set default values for Remote Config parameters.
remoteConfig.setDefaultsAsync(R.xml.remote_config_defaults)
```

Java

Trong bảng điều khiển Firebase, hãy mở Remote Config.
Trong thẻ Parameters (Tham số), hãy mở Menu (Trình đơn) rồi chọn Download default values (Tải giá trị mặc định xuống).
Khi được nhắc, hãy bật .xml cho Android, rồi nhấp vào Tải tệp xuống.
Lưu tệp này trong thư mục tài nguyên XML của ứng dụng.
Cập nhật tệp hoạt động chính để thêm các giá trị mặc định sau configSettings mà bạn đã thêm trước đó:
```
// Set default values for Remote Config parameters.
mFirebaseRemoteConfig.setDefaultsAsync(R.xml.remote_config_defaults);
```

Web

Bạn có thể đặt giá trị mặc định cho tên mô hình ngay trong mã của mình:

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

Dart

Bạn có thể đặt giá trị mặc định cho tên mô hình ngay trong mã của mình:

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

Unity

Bạn có thể đặt giá trị mặc định cho tên mô hình ngay trong mã của mình:

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

Bước 4: Tìm nạp và kích hoạt giá trị

Sau khi đặt giá trị mặc định cho tên mô hình, hãy thêm nội dung sau để tìm nạp và kích hoạt các giá trị.

Swift

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

Thao tác này sẽ cập nhật đối tượng Remote Config bất cứ khi nào một mẫu Remote Config mới được xuất bản.

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

Thêm getValue và fetchAndActivate vào các lệnh nhập của bạn:

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

Xác định vị trí của mã mà bạn chỉ định giá trị mặc định cho tên mô hình. Ngay sau khối mã đó, hãy thêm mã sau để tìm nạp và kích hoạt cấu hình, đồng thời chỉ định giá trị đã tìm nạp cho hằng số modelName.

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

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

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

Dart

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

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

Unity

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

Bước 5: Thêm trình nghe Remote Config theo thời gian thực

Thêm một trình nghe Remote Config theo thời gian thực vào ứng dụng của bạn để đảm bảo rằng những thay đổi mà bạn thực hiện đối với mẫu Remote Config sẽ được truyền đến ứng dụng khách ngay khi được cập nhật.

Đoạn mã sau đây cập nhật đối tượng Remote Config bất cứ khi nào giá trị tham số thay đổi.

Swift

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

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

Kotlin

Bạn cũng có thể định cấu hình một thao tác trong quá trình kích hoạt addOnCompleteListener (không bắt buộc):

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

Bạn cũng có thể định cấu hình một thao tác trong quá trình kích hoạt addOnCompleteListener (không bắt buộc):

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

Số lượng người nghe Remote Config theo thời gian thực không được hỗ trợ cho ứng dụng Web.

Dart

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

Unity

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

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

Bước 6: Cập nhật các yêu cầu Gemini API để sử dụng giá trị Remote Config

Nhấp vào nhà cung cấp Gemini API để xem nội dung và mã dành riêng cho nhà cung cấp trên trang này.

Giờ đây, khi Remote Config đã được định cấu hình đầy đủ, hãy cập nhật mã của bạn để thay thế các giá trị được mã hoá cứng bằng các giá trị lấy từ Remote Config.

Swift

import FirebaseAI

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

// ...

Kotlin

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

// ...

Java

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

GenerativeModelFutures model = GenerativeModelFutures.from(ai);

// ...

Web

// ...

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

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

// ...

Dart

// ...

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

// ...

Unity

// ...

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

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

// ...

Bước 7: Chạy ứng dụng

Tạo bản dựng và chạy ứng dụng, đồng thời xác minh rằng ứng dụng hoạt động. Thay đổi cấu hình của bạn trên trang Remote Config trong bảng điều khiển Firebase, xuất bản các thay đổi và xác minh kết quả.

Các bước tiếp theo

Tìm hiểu thêm về cách triển khai các trường hợp sử dụng khác cho Remote Config và Firebase AI Logic.
Đối với ứng dụng và trò chơi di động:
- Thử nghiệm các chế độ cài đặt mô hình khác nhau bằng Remote Config và A/B Testing.
- Dần dần phát hành các thay đổi về tham số mô hình bằng cách sử dụng Remote Config triển khai (chỉ dành cho iOS+ và Android).
- Sử dụng tính năng Remote Configcá nhân hoá để dùng công nghệ học máy nhằm xác định chế độ cài đặt phù hợp nhất cho từng người dùng (chỉ dành cho iOS+, Android và Unity).

Thay đổi từ xa tên mô hình trong ứng dụng Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.

Bước 1: Đặt giá trị tham số trong bảng điều khiển Firebase

Bước 2: Thêm và khởi tạo Remote Config trong ứng dụng của bạn

Swift

Kotlin

Java

Web

Dart

Unity

Bước 3: Đặt giá trị tham số trong ứng dụng

Swift

Kotlin

Java

Web

Dart

Unity

Bước 4: Tìm nạp và kích hoạt giá trị

Swift

Kotlin

Java

Web

Dart

Unity

Bước 5: Thêm trình nghe Remote Config theo thời gian thực

Swift

Kotlin

Java

Web

Dart

Unity

Bước 6: Cập nhật các yêu cầu Gemini API để sử dụng giá trị Remote Config

Swift

Kotlin

Java

Web

Dart

Unity

Bước 7: Chạy ứng dụng

Các bước tiếp theo

Thay đổi từ xa tên mô hình trong ứng dụng