Remote Config kullanarak şablonları sürüm oluşturma

Swift

Firebase AI LogicKurulum işleminin bir parçası olarak Firebase SDK'sını uygulamanıza eklediniz ancak Remote Config da eklemeniz gerekir.

1. Xcode'da, proje açıkken File > Add Package Dependencies'a (Dosya > Paket Bağımlılıkları Ekle) gidin.

2. firebase-ios-sdk'yı seçin ve Paket ekle'yi tıklayın.

3. Proje Gezgini'nde uygulamanız > Targets (Hedefler) > uygulamanızı seçin.

4. Genel sekmesinde Framework'ler, Kitaplıklar ve Yerleştirilmiş İçerik bölümüne gidin.

5. + simgesini tıklayın, FirebaseRemoteConfig'i seçin ve Ekle'yi tıklayın.

6. Kodunuza FirebaseRemoteConfig içe aktarma ifadesini ekleyin:

   import FirebaseRemoteConfig
   

7. Uygulamanız için uygun sınıfın içinde Firebase'i başlatın ve ana uygulama mantığınıza Remote Config ekleyin.

   Burada, uygulamanın yeni değerleri gerçek zamanlı olarak getirebilmesi için Remote Config ve Remote Config gerçek zamanlı dinleyiciyi içe aktarma olarak ekleyip minimum getirme aralığı ekleyeceksiniz:

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

Kotlin

1. Remote Config bağımlılığını modülünüzün (uygulama düzeyinde) Gradle dosyasına (genellikle app/build.gradle.kts veya app/build.gradle) ekleyin:

   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
   }
   

2. Ana uygulama mantığınıza Remote Config ekleyin. Burada Remote Config öğesini başlatacak ve minimum getirme aralığı ekleyeceksiniz:

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

Java

1. Remote Config bağımlılığını modülünüzün (uygulama düzeyinde) Gradle dosyasına (genellikle app/build.gradle.kts veya app/build.gradle) ekleyin:

   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
   }
   

2. Ana uygulama mantığınıza Remote Config ekleyin. Burada Remote Config öğesini başlatacak ve minimum getirme aralığı ekleyeceksiniz:

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

Web

1. Kodunuzu bir metin düzenleyicide açın ve Remote Config öğesini içe aktarın:

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

2. Birincil işlevinizin içinde ve Firebase uygulaması Firebase AI Logic SDK'sı için başlatıldıktan sonra Remote Config SDK'sını başlatın:

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

3. Minimum getirme aralığı ayarlayın:

   remoteConfig.settings.minimumFetchIntervalMillis = 3600000;
   

Swift

1. Firebase konsolunda Remote Config öğesini açın.

2. Parametreler sekmesinde Menü'yü açın ve Varsayılan değerleri indir'i seçin.

3. İstendiğinde .plist for iOS'i etkinleştirin, ardından Dosyayı indir'i tıklayın.

4. Dosyayı uygulama dizininize kaydedin.

5. Xcode'da uygulamanızı sağ tıklayın ve Add Files'ı (Dosya Ekle) seçin.

6. remote_config_defaults.plist'i seçin ve Ekle'yi tıklayın.

7. Uygulama kodunuzu, defaults dosyasına referans verecek şekilde güncelleyin:

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

Kotlin

1. Firebase konsolundan Remote Config hizmetini açın.

2. Parametreler sekmesinde Menü'yü açın ve Varsayılan değerleri indir'i seçin.

3. İstendiğinde Android için.xml'i etkinleştirin ve Dosyayı indir'i tıklayın.

4. Dosyayı uygulamanızın XML kaynakları dizinine kaydedin.

5. Daha önce eklediğiniz configSettings sonrasına varsayılanları eklemek için ana etkinlik dosyanızı güncelleyin:

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

Java

1. Firebase konsolunda Remote Config öğesini açın.

2. Parametreler sekmesinde Menü'yü açın ve Varsayılan değerleri indir'i seçin.

3. İstendiğinde Android için.xml'i etkinleştirin ve Dosyayı indir'i tıklayın.

4. Dosyayı uygulamanızın XML kaynakları dizinine kaydedin.

5. Daha önce eklediğiniz configSettings sonrasına varsayılanları eklemek için ana etkinlik dosyanızı güncelleyin:

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

Web

Model adının varsayılan değerini doğrudan kodunuzda ayarlayabilirsiniz:

// Set default values for Remote Config parameters.
remoteConfig.defaultConfig = {
  template_id: 'my-first-template-v1-0-0',
};

Swift

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

Bu, yeni bir Remote Config şablonu yayınlandığında Remote Config nesnesini güncellemelidir.

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. İçe aktarma işlemlerinize getValue ve fetchAndActivate ekleyin:

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

2. Model adı için varsayılan değeri belirttiğiniz kodu bulun. Bu kod bloğunun hemen ardından, yapılandırmayı getirip etkinleştirmek ve getirilen değeri templateID sabitine atamak için aşağıdaki kodu ekleyin.

   // 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 templateID = getValue(remoteConfig, 'template_id').asString();
   

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

İsteğe bağlı olarak, addOnCompleteListener etkinleştirme içinde bir işlem de yapılandırabilirsiniz:

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

İsteğe bağlı olarak, addOnCompleteListener etkinleştirme içinde bir işlem de yapılandırabilirsiniz:

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

Web uygulamalarında anlık Remote Config dinleyici özelliği desteklenmez.

Swift

import FirebaseAI

let templateID = remoteConfig.configValue(forKey: "template_id").stringValue
let model = FirebaseAI.firebaseAI(backend: .googleAI()).templateGenerativeModel()
let customerName = "Jane"

// When making the `generateContent` call, source the template ID value from Remote Config
let response = try await model.generateContent(
  templateID: templateID,
  // Provide the values for any input variables required by your template.
  inputs: [
    "customerName": customerName
  ]
)

// ...

Kotlin

// ...

val model = Firebase.ai().templateGenerativeModel()
val customerName = "Jane"

// When making the `generateContent` call, source the template ID value from Remote Config
val response = model.generateContent(
  remoteConfig.getString("template_id"),
  // Provide the values for any input variables required by your template.
  mapOf(
    "customerName" to customerName
  )
)

val text = response.text
println(text)

Java

// ...

TemplateGenerativeModel ai = FirebaseAI.getInstance()
    .templateGenerativeModel(null /* Request Options */);

TemplateGenerativeModelFutures model = TemplateGenerativeModelFutures.from(ai);
String customerName = "Jane";

// When making the `generateContent` call, source the template ID value from Remote Config
Future<GenerateContentResponse> response = model.generateContent(
    remoteConfig.getString("template_id"),
    // Provide the values for any input variables required by your template.
    mapOf("customerName", customerName)

);
addCallback(response,
      new FutureCallback<GenerateContentResponse>() {
          public void onSuccess(GenerateContentResponse result) {
            System.out.println(result.getText());
          }
          public void onFailure(Throwable t) {
            reportError(t);
          }
    }
executor);

// ...

Web

// ...

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

const model = getTemplateGenerativeModel(ai);
const templateID = getValue(remoteConfig, 'template_id').asString();
const customerName = 'Jane';

// When making the `generateContent` call, source the template ID value from Remote Config
const result = await model.generateContent(
  templateID,
  // Provide the values for any input variables required by your template
  {
    customerName: customerName,
  }
);

// ...