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


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

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

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

अपने 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 वर्शन पर अपडेट करें (सभी के लिए ज़रूरी है)

लाइब्रेरी के GA वर्शन का इस्तेमाल करने के लिए, अपने ऐप्लिकेशन के कोडबेस को अपडेट करने के लिए इन निर्देशों का पालन करें:

  1. npm का इस्तेमाल करके, वेब के लिए Firebase JS SDK टूल का नया वर्शन पाएं:

    npm i firebase@latest

    या

    yarn add firebase@latest

  2. लाइब्रेरी को जहां भी इंपोर्ट किया गया है वहां, firebase/vertexai का इस्तेमाल करने के लिए अपने इंपोर्ट स्टेटमेंट अपडेट करें:

    // BEFORE
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai-preview";

// AFTER
import { initializeApp } from "firebase/app";
import { getVertexAI, getGenerativeModel } from "firebase/vertexai";

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

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

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

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

  • टाइम आउट

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

  • एनोमेरेशन

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

  • ब्लॉक करने की वजह

    • PromptFeedback में blockReason को वैकल्पिक के तौर पर सेट किया गया.

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

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 कंसोल में, एपीआई और सेवाएं > क्रेडेंशियल पैनल में जाकर, अपनी सभी एपीआई कुंजियां देखी जा सकती हैं.