আপনার অ্যাপে দূরবর্তীভাবে মডেলের নাম পরিবর্তন করুন

জেনারেটিভ এআই মডেলের প্রাপ্যতা ঘন ঘন পরিবর্তিত হয় — নতুন, আরও ভালো মডেল প্রকাশ করা হয় এবং পুরানো, কম সক্ষম মডেলগুলি অবসরপ্রাপ্ত হয়।

যখন আপনি Firebase AI Logic ব্যবহার করে সরাসরি কোনও মোবাইল বা ওয়েব অ্যাপ থেকে জেনারেটিভ AI মডেল অ্যাক্সেস করেন, তখন এই ঘন ঘন মডেল পরিবর্তনগুলিকে সামঞ্জস্য করার জন্য আপনার অ্যাপটি কনফিগার করা অত্যন্ত গুরুত্বপূর্ণ। আপনার সমস্ত ব্যবহারকারী আপনার প্রয়োজনীয় মডেলটি ব্যবহার শুরু করার জন্য আপনার অ্যাপের সর্বশেষ সংস্করণে আপডেট করবেন না।

Firebase Remote Config আপনাকে আপনার অ্যাপের প্যারামিটার মানগুলি (যেমন একটি মডেলের নাম) Firebase কনসোল থেকে গতিশীলভাবে এবং দূরবর্তীভাবে আপডেট করতে দেয়, আপনার অ্যাপের একটি নতুন সংস্করণ প্রকাশ করার প্রয়োজন ছাড়াই।

মনে রাখবেন যে Firebase AI Logic ব্যবহার করে Remote Config ব্যবহার করার ক্ষেত্রে মডেলের নাম পরিবর্তন করা একটি গুরুত্বপূর্ণ ব্যবহার, তবে আপনি Remote Config ব্যবহার করে আপনার অ্যাপের প্যারামিটারগুলিকে গতিশীলভাবে এবং এমনকি শর্তসাপেক্ষে নিয়ন্ত্রণ করতে পারেন, যেমন মডেল জেনারেশন কনফিগারেশন (সর্বোচ্চ টোকেন, তাপমাত্রা ইত্যাদি), নিরাপত্তা সেটিংস, সিস্টেম নির্দেশাবলী এবং প্রম্পট ডেটা।

এই নির্দেশিকাটি বর্ণনা করে কিভাবে আপনার অ্যাপে Remote Config বাস্তবায়ন করবেন, বিশেষ করে আপনার অ্যাপে ব্যবহৃত মডেল নাম নিয়ন্ত্রণ করার জন্য।

ধাপ ১ : Firebase কনসোলে প্যারামিটার মান সেট করুন

একটি Remote Config ক্লায়েন্ট টেমপ্লেট তৈরি করুন এবং একটি model_name প্যারামিটার এবং অ্যাপে আনা এবং ব্যবহারের জন্য এর মান কনফিগার করুন।

  1. Firebase কনসোলে আপনার Firebase প্রজেক্টটি খুলুন। তারপর, নেভিগেশন মেনু থেকে, Run প্রসারিত করুন এবং Remote Config নির্বাচন করুন।

  2. পৃষ্ঠার উপরে থাকা ক্লায়েন্ট/সার্ভার নির্বাচক থেকে ক্লায়েন্ট নির্বাচন করা হয়েছে কিনা তা নিশ্চিত করুন।

  3. Create Configuration (অথবা যদি আপনি পূর্বে ক্লায়েন্ট টেমপ্লেট ব্যবহার করে থাকেন, তাহলে প্যারামিটার যোগ করুন ) ক্লিক করে একটি ক্লায়েন্ট টেমপ্লেট শুরু করুন।

  4. model_name প্যারামিটারটি সংজ্ঞায়িত করুন:

    প্যারামিটারের নাম বিবরণ আদর্শ ডিফল্ট মান
    model_name মডেলের নাম। উপলব্ধ মডেলের নাম দেখুন। স্ট্রিং gemini-2.5-flash
  5. এই প্যারামিটারটি যোগ করার পর, পরিবর্তনগুলি প্রকাশ করুন এ ক্লিক করুন। যদি এটি একটি নতুন Remote Config টেমপ্লেট না হয়, তাহলে পরিবর্তনগুলি পর্যালোচনা করুন এবং আবার পরিবর্তনগুলি প্রকাশ করুন এ ক্লিক করুন।

ধাপ ২ : আপনার অ্যাপে 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 নির্বাচন করুন, তারপর Add এ ক্লিক করুন।

  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. আপনার মডিউল (অ্যাপ-লেভেল) গ্র্যাডেল ফাইলে (সাধারণত app/build.gradle.kts অথবা app/build.gradle ) Remote Config নির্ভরতা যোগ করুন:

    dependencies {
        implementation(platform("com.google.firebase:firebase-bom:34.5.0"))
        implementation("com.google.firebase:firebase-ai")
        implementation("com.google.firebase:firebase-config")
        // ... other dependencies
    }
    
  2. আপনার প্রধান অ্যাপ্লিকেশন লজিকে Remote Config যোগ করুন। এখানে, আপনি Remote Config শুরু করবেন এবং একটি ন্যূনতম ফেচ ইন্টারভাল যোগ করবেন:

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

Java

  1. আপনার মডিউল (অ্যাপ-লেভেল) গ্র্যাডেল ফাইলে (সাধারণত app/build.gradle.kts অথবা app/build.gradle ) Remote Config নির্ভরতা যোগ করুন:

    dependencies {
        implementation(platform("com.google.firebase:firebase-bom:34.5.0"))
        implementation("com.google.firebase:firebase-ai")
        implementation("com.google.firebase:firebase-config")
        // ... other dependencies
    }
    
  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 AI Logic SDK-এর জন্য Firebase অ্যাপটি চালু করার পরে, 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_vertexai/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 অবজেক্ট ইনস্ট্যান্সটি পান এবং ঘন ঘন রিফ্রেশ করার জন্য ন্যূনতম ফেচ ইন্টারভাল সেট করুন। ফায়ারবেস শুরু হওয়ার পরে এটি যোগ করতে ভুলবেন না।

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

ঐক্য

  1. এই নির্দেশাবলী অনুসরণ করে আপনার ইউনিটি প্রজেক্টে Remote Config যোগ করুন।

  2. Remote Config অবজেক্ট ইনস্ট্যান্সটি পান এবং ঘন ঘন রিফ্রেশ করার জন্য ন্যূনতম ফেচ ইন্টারভাল সেট করুন। ফায়ারবেস শুরু হওয়ার পরে এটি যোগ করতে ভুলবেন না।

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

ধাপ ৩ : অ্যাপ-মধ্যস্থ প্যারামিটারের মান সেট করুন

আপনার Remote Config অবজেক্টে ইন-অ্যাপ ডিফল্ট প্যারামিটার মান সেট করা উচিত। এটি নিশ্চিত করে যে আপনার অ্যাপটি Remote Config পরিষেবা থেকে মান আনতে না পারলেও প্রত্যাশা অনুযায়ী আচরণ করবে।

সুইফট

  1. Firebase কনসোলে, Remote Config খুলুন।

  2. প্যারামিটার ট্যাবে, মেনু খুলুন এবং ডিফল্ট মান ডাউনলোড করুন নির্বাচন করুন।

  3. অনুরোধ করা হলে, iOS এর জন্য .plist সক্ষম করুন, তারপর ফাইল ডাউনলোড করুন এ ক্লিক করুন।

  4. আপনার অ্যাপ্লিকেশন ডিরেক্টরিতে ফাইলটি সংরক্ষণ করুন।

  5. এক্সকোডে, আপনার অ্যাপে ডান-ক্লিক করুন এবং ফাইল যোগ করুন নির্বাচন করুন

  6. নির্বাচন করুন, তারপর Add এ ক্লিক করুন।

  7. ডিফল্ট ফাইলটি উল্লেখ করতে আপনার অ্যাপ কোড আপডেট করুন:

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

Kotlin

  1. Firebase কনসোল থেকে, Remote Config খুলুন।

  2. প্যারামিটার ট্যাবে, মেনু খুলুন এবং ডিফল্ট মান ডাউনলোড করুন নির্বাচন করুন।

  3. অনুরোধ করা হলে, Android এর জন্য .xml সক্ষম করুন, তারপর ফাইল ডাউনলোড করুন এ ক্লিক করুন।

  4. আপনার অ্যাপের XML রিসোর্স ডিরেক্টরিতে ফাইলটি সংরক্ষণ করুন।

  5. আপনার পূর্বে যোগ করা configSettings পরে ডিফল্টগুলি যোগ করতে আপনার প্রধান কার্যকলাপ ফাইলটি আপডেট করুন:

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

Java

  1. Firebase কনসোলে, Remote Config খুলুন।

  2. প্যারামিটার ট্যাবে, মেনু খুলুন এবং ডিফল্ট মান ডাউনলোড করুন নির্বাচন করুন।

  3. অনুরোধ করা হলে, Android এর জন্য .xml সক্ষম করুন, তারপর ফাইল ডাউনলোড করুন এ ক্লিক করুন।

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

ধাপ ৪ : মানটি আনুন এবং সক্রিয় করুন

মডেল নামের জন্য ডিফল্ট মান সেট করার পরে, মানগুলি আনতে এবং সক্রিয় করতে নিম্নলিখিতটি যোগ করুন।

সুইফট

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

ধাপ ৫ : একটি রিয়েল-টাইম 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();
};

ধাপ ৬ : Remote Config মান ব্যবহার করার জন্য জেমিনি এপিআই অনুরোধগুলি আপডেট করুন

এই পৃষ্ঠায় প্রোভাইডার-নির্দিষ্ট কন্টেন্ট এবং কোড দেখতে আপনার জেমিনি API প্রোভাইডারে ক্লিক করুন।

এখন যেহেতু 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
);

// ...

ধাপ ৭ : অ্যাপটি চালান

অ্যাপটি তৈরি করুন এবং চালান এবং এটি কাজ করছে কিনা তা যাচাই করুন। Firebase কনসোলের Remote Config পৃষ্ঠা থেকে আপনার কনফিগারেশনে পরিবর্তন করুন, পরিবর্তনগুলি প্রকাশ করুন এবং ফলাফল যাচাই করুন।

পরবর্তী পদক্ষেপ