Agent Platform Gemini API

আপনি Gemini API-তে নতুন হলে, Android ডেভেলপারদের জন্য Gemini Developer API হল সাজেস্ট করা API প্রদানকারী। তবে, আপনার যদি নির্দিষ্ট ডেটা লোকেশন সংক্রান্ত প্রয়োজনীয়তা থাকে অথবা আপনি যদি আগে থেকেই Google Cloud ইকোসিস্টেমে এম্বেড করা থাকেন, তাহলে আপনি Gemini Pro ও Flash মডেল অ্যাক্সেস করতে Firebase AI Logic-এর সাথে Agent Platform Gemini API (আগে Vertex AI নামে পরিচিত ছিল) ব্যবহার করতে পারবেন।

শুরু করা

আপনার অ্যাপ থেকে সরাসরি Agent Platform Gemini API-এর সাথে ইন্টার‍্যাক্ট করার আগে, আপনি Agent Studio-তে প্রম্পট নিয়ে পরীক্ষা-নিরীক্ষা করতে পারেন।

Firebase প্রোজেক্ট সেট-আপ করা এবং Firebase-এর সাথে আপনার অ্যাপ কানেক্ট করা

আপনার অ্যাপ থেকে API কল করার জন্য প্রস্তুত হয়ে গেলে, Firebase সেট-আপ করতে এবং প্রয়োজনীয় API ও পরিষেবা চালু করতে, Firebase AI Logic-এর শুরু করার গাইড-এর "ধাপ ১"-এ দেওয়া নির্দেশাবলী অনুসরণ করুন।

Gradle ডিপেন্ডেন্সি যোগ করুন

আপনার অ্যাপ মডিউলে নিম্নলিখিত Gradle ডিপেন্ডেন্সি যোগ করুন:

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:34.19.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")
}

dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:34.19.0"))

  // Add the dependencies for the Firebase AI Logic and App Check libraries
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-ai")
  implementation("com.google.firebase:firebase-appcheck-debug")

  // Required for one-shot operations (to use `ListenableFuture` from Guava Android)
  implementation("com.google.guava:guava:31.0.1-android")

  // Required for streaming operations (to use `Publisher` from Reactive Streams)
  implementation("org.reactivestreams:reactive-streams:1.0.4")
}

লোকাল ডেভেলপমেন্টের জন্য App Check ডিবাগ প্রদানকারী কনফিগার করা

২০২৬ সালের জুলাই মাসের শুরু থেকে, Firebase কনসোলে AI Logic-এর জন্য নির্দেশিত সেট-আপ ওয়ার্কফ্লোর অংশ হিসেবে, Gemini API-কে সুরক্ষিত রাখতে Firebase App Check অটোমেটিক প্রয়োগ করা হবে। লোকাল ডেভেলপমেন্টের জন্য, আপনাকে অ্যাপ চেক এনফোর্সমেন্ট বজায় রেখেও অ্যাটেস্টেশন বাইপাস করতে, অ্যাপ চেক ডিবাগ প্রোভাইডার কনফিগার করতে হবে।

1. আপনার ডিবাগ বিল্ডে, ডিবাগ প্রোভাইডার ফ্যাক্টরি ব্যবহার করার জন্য অ্যাপ চেক কনফিগার করুন:

   Kotlin

   Firebase.initialize(context = this)
   Firebase.appCheck.installAppCheckProviderFactory(
       DebugAppCheckProviderFactory.getInstance(),
   )
   

   জাভা

   FirebaseApp.initializeApp(/*context=*/ this);
   FirebaseAppCheck firebaseAppCheck = FirebaseAppCheck.getInstance();
   firebaseAppCheck.installAppCheckProviderFactory(
           DebugAppCheckProviderFactory.getInstance());
   

2. আপনার ডিবাগ টোকেন পান:

   1. এমুলেটরে বা আপনার টেস্ট ডিভাইসে অ্যাপ রান করান।

   2. আপনার লগে App Check ডিবাগ টোকেন খুঁজুন। যেমন:

      D DebugAppCheckProvider: Enter this debug secret into the allow list
      in the Firebase Console for your project: 123a4567-b89c-12d3-e456-789012345678
      

   3. টোকেনটি কপি করুন (যেমন, 123a4567-b89c-12d3-e456-789012345678)।

3. App Check-এর সাথে আপনার ডিবাগ টোকেন রেজিস্টার করুন:

   1. Firebase কনসোলে, নিরাপত্তা > অ্যাপ চেক > অ্যাপ ট্যাবে যান।

   2. আপনার অ্যাপ খুঁজে নিন, ওভারফ্লো মেনুতে ক্লিক করুন (more_vert) এবং তারপরে ডিবাগ টোকেন ম্যানেজ করুন বিকল্প বেছে নিন।

   3. আপনার ডিবাগ টোকেন রেজিস্টার করতে অন-স্ক্রিন নির্দেশাবলী অনুসরণ করুন।

ডিবাগ প্রদানকারী সম্পর্কে আরও জানতে (নতুন ডিবাগ টোকেন কীভাবে পাবেন তা সহ), অফিসিয়াল App Check ডকুমেন্ট দেখুন।

জেনারেটিভ মডেল চালু করা

GenerativeModel ইনস্ট্যানশিয়েট করে এবং মডেলের নাম উল্লেখ করে শুরু করুন:

val model = Firebase.ai(backend = GenerativeBackend.agentPlatform())
    .generativeModel("gemini-3.5-flash")
AgentPlatformGeminiApi.kt

GenerativeModel firebaseAI = FirebaseAI.getInstance(GenerativeBackend.agentPlatform())
        .generativeModel("gemini-3.5-flash");

GenerativeModelFutures model = GenerativeModelFutures.from(firebaseAI);
AgentPlatformGeminiApiJava.java

Firebase ডকুমেন্টেশনে, আপনি উপলভ্য Gemini মডেল সম্পর্কে আরও জানতে পারবেন। এছাড়াও, আপনি মডেল প্যারামিটার কনফিগার করা সম্পর্কে জানতে পারবেন।

টেক্সট জেনারেট করা

টেক্সট উত্তর জেনারেট করতে, আপনার প্রম্পট সহ generateContent() কল করুন।

suspend fun generateText(model: GenerativeModel) {
    // Note: generateContent() is a suspend function, which integrates well
    // with existing Kotlin code.
    val response = model.generateContent("Write a story about a magic backpack.")
    // ...
}
AgentPlatformGeminiApi.kt

Content prompt = new Content.Builder()
        .addText("Write a story about a magic backpack.")
        .build();

ListenableFuture<GenerateContentResponse> response = model.generateContent(prompt);
Futures.addCallback(response, new FutureCallback<GenerateContentResponse>() {
    @Override
    public void onSuccess(GenerateContentResponse result) {
        String resultText = result.getText();
        // ...
    }

    @Override
    public void onFailure(Throwable t) {
        t.printStackTrace();
    }
}, executor);
AgentPlatformGeminiApiJava.java

Gemini Developer API-এর মতোই, আপনিও টেক্সট প্রম্পটের সাথে ছবি, অডিও, ভিডিও এবং ফাইল পাস করতে পারবেন। বিস্তারিত জানতে, আপনার অ্যাপ থেকে Gemini Developer API-এর সাথে ইন্টার‍্যাক্ট করা দেখুন।

Firebase AI Logic SDK সম্পর্কে আরও জানতে, Firebase ডকুমেন্টেশন দেখুন।