Firebase में Vertex AI के GA वर्शन का इस्तेमाल करने के लिए माइग्रेट करना


Vertex AI in Firebase को 21 अक्टूबर, 2024 को सभी के लिए लॉन्च किया गया था.

अगर आपने Vertex AI in Firebase लाइब्रेरी (firebase-vertexai:16.0.0-betaXX) के बीटा वर्शन का इस्तेमाल किया है, तो लाइब्रेरी के GA वर्शन (firebase-vertexai:16.0.0 या उसके बाद के वर्शन) का इस्तेमाल करने के लिए, आपको ये बदलाव करने होंगे.

माइग्रेट करने के लिए ज़रूरी बदलावों की हाइलाइट की सूची यहां दी गई है:

अपने Firebase प्रोजेक्ट में ज़रूरी नया एपीआई चालू करें (सभी के लिए ज़रूरी है)

आपको अपने Firebase प्रोजेक्ट में Vertex AI in Firebase एपीआई को चालू करना होगा और उसे अपनी Firebase एपीआई पासकोड की अनुमति वाली सूची में जोड़ना होगा. यह एक नया एपीआई है. Vertex AI in Firebase के GA वर्शन का इस्तेमाल करने के लिए, यह एपीआई ज़रूरी है.

  1. Firebase console में, Gemini का इस्तेमाल करके ऐप्लिकेशन बनाएं पेज पर जाएं.

  2. Vertex AI in Firebase कार्ड में, शुरू करें पर क्लिक करके, एक वर्कफ़्लो लॉन्च करें. इससे, इस एपीआई को चालू करने और उसे अपनी Firebase API पासकोड की अनुमति वाली सूची में जोड़ने में मदद मिलेगी.

  3. आपके पास कंसोल में बाकी वर्कफ़्लो को छोड़ने का विकल्प है.

लाइब्रेरी के GA वर्शन पर अपडेट करें (सभी के लिए ज़रूरी है)

Firebase Android BoM के नए वर्शन का इस्तेमाल करने के लिए, अपनी डिपेंडेंसी अपडेट करने के लिए इन निर्देशों का पालन करें. BoM का इस्तेमाल करना ज़रूरी नहीं है. हालांकि, हमारा सुझाव है कि आप इसका इस्तेमाल करें, क्योंकि इससे यह पक्का करने में मदद मिलती है कि आपका ऐप्लिकेशन, हर Firebase लाइब्रेरी के साथ काम करने वाले वर्शन का इस्तेमाल कर रहा है.

  1. अपनी मॉड्यूल (ऐप्लिकेशन-लेवल) Gradle फ़ाइल (आम तौर पर <project>/<app-module>/build.gradle.kts या <project>/<app-module>/build.gradle)) में, Vertex AI in Firebase के लिए डिपेंडेंसी को इनके साथ बदलें:

    // BEFORE
dependencies {
  implementation("com.google.firebase:firebase-vertexai:16.0.0-betaXX")
}

// AFTER
dependencies {
  // Import the BoM for the Firebase platform
  implementation(platform("com.google.firebase:firebase-bom:33.10.0"))

  // Add the dependency for the Vertex AI in Firebase library
  // When using the BoM, you don't specify versions in Firebase library dependencies
  implementation("com.google.firebase:firebase-vertexai")
}

  2. अपने Android प्रोजेक्ट को Gradle फ़ाइलों के साथ सिंक करें.

ध्यान दें कि अगर आपको Firebase BoM का इस्तेमाल नहीं करना है, तो Android Studio के सुझाए गए firebase-vertexai के नए वर्शन को स्वीकार करें.

अन्य बदलाव (आपने जिन सुविधाओं का इस्तेमाल किया है उनके हिसाब से ज़रूरी है)

SDK टूल के GA वर्शन के लिए कई बदलाव किए गए हैं. अपने ऐप्लिकेशन में SDK टूल के GA वर्शन का इस्तेमाल करने के लिए, आपको अपने कोड में कुछ बदलाव करने पड़ सकते हैं. इन बदलावों के बारे में जानने के लिए, यहां दी गई सूचियां देखें.

  • फ़ंक्शन कॉलिंग
    अगर आपने GA से पहले इस सुविधा को लागू किया है, तो आपको अपने स्कीमा को तय करने के तरीके में अपडेट करने होंगे. हमारा सुझाव है कि फ़ंक्शन के एलान लिखने का तरीका जानने के लिए, अपडेट की गई फ़ंक्शन कॉल करने की गाइड देखें.

  • responseSchema का इस्तेमाल करके स्ट्रक्चर्ड आउटपुट (जैसे, JSON) जनरेट करना
    अगर आपने GA से पहले इस सुविधा को लागू किया है, तो आपको अपने स्कीमा को तय करने के तरीके में अपडेट करने होंगे. हमारा सुझाव है कि JSON स्कीमा लिखने का तरीका जानने के लिए, स्ट्रक्चर्ड आउटपुट की नई गाइड पढ़ें.

  • टाइम आउट

    • अनुरोधों के लिए डिफ़ॉल्ट टाइम आउट को 180 सेकंड पर सेट किया गया.

  • एनोमेरेशन

    • enum क्लास और sealed क्लास को रेगुलर क्लास से बदल दिया गया. इस बदलाव से, एपीआई को पुराने सिस्टम के साथ काम करने वाले तरीके में बेहतर बनाने में मदद मिलती है.

    • BlockThreshold एनोटेशन का नाम बदलकर HarmBlockThreshold किया गया.

    • इन इन्यूमरेशन से वैल्यू हटा दी गई हैं: HarmBlockThreshold, HarmProbability, HarmSeverity, BlockReason, और FinishReason.

  • ब्लॉक के तरीके

    • जिन तरीकों के नाम में Blob शामिल था उनके नाम बदल दिए गए हैं, ताकि InlineData का इस्तेमाल किया जा सके.

  • सुरक्षा सेटिंग

    • फ़ील्ड method को वैल्यू के बिना छोड़ने की अनुमति दी गई है.

  • अवधि की कैटगरी

    • Kotlin की Duration क्लास के सभी इस्तेमाल हटा दिए गए हैं और इसे long से बदल दिया गया है. इस बदलाव से, Java के साथ बेहतर तरीके से इंटरऑपरेट किया जा सकता है.

  • साइटेशन का मेटाडेटा

    • CitationMetadata में पहले से एलान किए गए सभी फ़ील्ड को Citation नाम की नई क्लास में रैप किया गया. CitationMetadata में citations नाम की सूची में, आपको उद्धरणों की जानकारी मिल सकती है. इस बदलाव से, सभी प्लैटफ़ॉर्म पर टाइप को बेहतर तरीके से अलाइन किया जा सकता है.

  • टोकन की संख्या

    • फ़ील्ड totalBillableCharacters को वैल्यू के बिना छोड़ने की अनुमति दी गई है.

  • बिल किए जा सकने वाले कुल वर्ण

    • CountTokensResponse में totalBillableCharacters प्रॉपर्टी को वैकल्पिक के तौर पर बदला गया है, ताकि उन स्थितियों को दिखाया जा सके जहां कोई वर्ण नहीं भेजा जाता.

  • मॉडल को इंस्टैंशिएट करना

    • अन्य प्लैटफ़ॉर्म के साथ अलाइन करने के लिए, requestOptions पैरामीटर को पैरामीटर सूची के आखिर में ले जाया गया.

माइग्रेट करने से जुड़ी संभावित गड़बड़ियां

Vertex AI in Firebase के GA वर्शन का इस्तेमाल करने के लिए माइग्रेट करने पर, आपको गड़बड़ियां दिख सकती हैं. ऐसा तब होगा, जब आपने माइग्रेशन की इस गाइड में बताए गए सभी ज़रूरी बदलाव न किए हों.

403 गड़बड़ी: Requests to this API firebasevertexai.googleapis.com ... are blocked.

अगर आपको 403 कोड वाली गड़बड़ी का मैसेज मिलता है, जिसमें Requests to this API firebasevertexai.googleapis.com ... are blocked. लिखा है, तो आम तौर पर इसका मतलब है कि आपकी Firebase कॉन्फ़िगरेशन फ़ाइल/ऑब्जेक्ट में मौजूद एपीआई पासकोड की अनुमति वाली सूची में, उस प्रॉडक्ट के लिए ज़रूरी एपीआई मौजूद नहीं है जिसका इस्तेमाल किया जा रहा है.

पक्का करें कि आपके ऐप्लिकेशन में इस्तेमाल की गई एपीआई पासकोड में, ऐसे सभी ज़रूरी एपीआई शामिल हों जो पासकोड की "एपीआई से जुड़ी पाबंदियों" की अनुमति वाली सूची में शामिल हैं. Vertex AI in Firebase के लिए, आपकी एपीआई पासकोड की अनुमति वाली सूची में कम से कम Vertex AI in Firebase एपीआई होना चाहिए. Firebase कंसोल की मदद से नए एपीआई को चालू करने पर, यह एपीआई आपकी एपीआई कुंजी की अनुमति वाली सूची में अपने-आप जुड़ जाना चाहिए.

Google Cloud कंसोल में, एपीआई और सेवाएं > क्रेडेंशियल पैनल में जाकर, अपनी सभी एपीआई कुंजियां देखी जा सकती हैं.