Agent Platform Gemini API

अगर आपने Gemini API का इस्तेमाल पहले कभी नहीं किया है, तो Android डेवलपर के लिए Gemini Developer API को एपीआई प्रोवाइडर के तौर पर इस्तेमाल करने का सुझाव दिया जाता है. हालांकि, अगर आपको डेटा की जगह की जानकारी से जुड़ी ज़रूरी शर्तें पूरी करनी हैं या आपने पहले से ही Google Cloud के नेटवर्क का इस्तेमाल किया है, तो Gemini Pro और Flash मॉडल को ऐक्सेस करने के लिए, Firebase AI Logic के साथ Agent Platform Gemini API (पहले इसका नाम Vertex AI था) का इस्तेमाल किया जा सकता है.

शुरू करना

अपने ऐप्लिकेशन से सीधे Agent Platform Gemini API के साथ इंटरैक्ट करने से पहले, Agent Studio में प्रॉम्प्ट के साथ एक्सपेरिमेंट किया जा सकता है.

Firebase प्रोजेक्ट सेट अप करना और अपने ऐप्लिकेशन को Firebase से कनेक्ट करना

जब आप अपने ऐप्लिकेशन से एपीआई को कॉल करने के लिए तैयार हों, तो Firebase को सेट अप करने और ज़रूरी एपीआई और सेवाओं को चालू करने के लिए, Firebase AI Logic के शुरुआती निर्देश के "पहले चरण" में दिए गए निर्देशों का पालन करें.

Gradle डिपेंडेंसी जोड़ना

अपने ऐप्लिकेशन मॉड्यूल में ये Gradle डिपेंडेंसी जोड़ें:

dependencies {
  // ... other androidx dependencies

  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:35.1.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:firebase-bom:35.1.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 के डीबग प्रोवाइडर को कॉन्फ़िगर करना

जुलाई 2026 की शुरुआत से, Firebase कंसोल में एआई लॉजिक के लिए सेटअप वर्कफ़्लो के तहत, Gemini API को सुरक्षित रखने के लिए Firebase App Check अपने-आप लागू हो जाएगा. लोकल डेवलपमेंट के लिए, आपको App Check के डीबग प्रोवाइडर को कॉन्फ़िगर करना होगा. इससे, App Check को लागू करने के साथ-साथ, पुष्टि करने की प्रोसेस को बायपास किया जा सकता है.

1. डीबग के लिए बिल्ड में, App Check को कॉन्फ़िगर करें, ताकि डीबग प्रोवाइडर फ़ैक्ट्री का इस्तेमाल किया जा सके:

   Kotlin

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

   Java

   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 कंसोल में, सुरक्षा > App Check > ऐप्लिकेशन टैब पर जाएं.

   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 का दस्तावेज़ देखें.