Firebase-এ Vertex AI-এর GA সংস্করণ ব্যবহার করতে মাইগ্রেট করুন, Firebase-এ Vertex AI-এর GA সংস্করণ ব্যবহার করতে মাইগ্রেট করুন


Firebase-এ Vertex AI 21 অক্টোবর, 2024-এ সাধারণ উপলভ্যতা (GA)-তে চালু হয়েছে।

আপনি যদি Firebase লাইব্রেরিতে Vertex AI- এর পূর্বরূপ সংস্করণ ব্যবহার করেন ( FirebaseVertexAI-Preview ), তাহলে লাইব্রেরির GA সংস্করণ ( FirebaseVertexAI ) ব্যবহার করতে আপগ্রেড করতে আপনাকে নিম্নলিখিত পরিবর্তনগুলি করতে হবে৷

মাইগ্রেট করার জন্য প্রয়োজনীয় পরিবর্তনগুলির একটি উচ্চ-স্তরের তালিকা এখানে রয়েছে:

আপনার Firebase প্রকল্পে নতুন প্রয়োজনীয় API সক্ষম করুন (সবার জন্য প্রয়োজনীয়)

আপনার Firebase প্রোজেক্টে Firebase API-এ Vertex AI সক্ষম করতে হবে এবং আপনার Firebase API কী-এর অনুমোদিত তালিকায় যোগ করতে হবে। এটি একটি নতুন API যা Firebase-এ Vertex AI- এর GA সংস্করণ ব্যবহার করতে হবে।

  1. Firebase কনসোলে, Build with Gemini পৃষ্ঠাতে যান।

  2. Firebase কার্ডে Vertex AI- তে, একটি ওয়ার্কফ্লো চালু করতে শুরু করুন ক্লিক করুন যা আপনাকে এই API সক্ষম করতে এবং এটিকে আপনার Firebase API কী-এর অনুমোদিত তালিকায় যোগ করতে সাহায্য করে।

  3. আপনি কনসোলে বাকি ওয়ার্কফ্লো এড়িয়ে যেতে পারেন।

লাইব্রেরির GA সংস্করণে আপডেট করুন (সকলের জন্য প্রয়োজনীয়)

লাইব্রেরির GA সংস্করণ ব্যবহার করতে আপনার অ্যাপের কোডবেস আপডেট করতে এই নির্দেশাবলী অনুসরণ করুন:

  1. Xcode-এ, আপনার অ্যাপ প্রোজেক্ট খোলার সাথে, নিম্নলিখিত বিকল্পগুলির মধ্যে একটি ব্যবহার করে আপনার Firebase প্যাকেজ 11.4.0 বা পরবর্তী সংস্করণে আপডেট করুন:

    • বিকল্প 1 : সমস্ত প্যাকেজ আপডেট করুন: ফাইল > প্যাকেজ > সর্বশেষ প্যাকেজ সংস্করণে আপডেট করুন ।

    • বিকল্প 2 : ফায়ারবেসকে পৃথকভাবে আপডেট করুন: প্যাকেজ নির্ভরতা নামক বিভাগে ফায়ারবেস প্যাকেজে নেভিগেট করুন। ফায়ারবেস প্যাকেজে ডান-ক্লিক করুন, এবং তারপর আপডেট প্যাকেজ নির্বাচন করুন।

  2. নিশ্চিত করুন যে Firebase প্যাকেজ এখন 11.4.0 বা পরবর্তী সংস্করণ দেখায়। যদি তা না হয়, তাহলে যাচাই করুন যে আপনার নির্দিষ্ট প্যাকেজ প্রয়োজনীয়তা 11.8.0 বা পরবর্তী সংস্করণে আপডেট করার অনুমতি দেয়।

  3. প্রজেক্ট এডিটরে আপনার অ্যাপের টার্গেট নির্বাচন করুন এবং তারপরে ফ্রেমওয়ার্ক, লাইব্রেরি এবং এমবেডেড কন্টেন্ট বিভাগে নেভিগেট করুন।

  4. + বোতামটি নির্বাচন করুন, এবং তারপর Firebase প্যাকেজ থেকে FirebaseVertexAI যোগ করুন।

  5. FirebaseVertexAI-প্রিভিউ নির্বাচন করুন এবং তারপর — বোতাম টিপুন।

অতিরিক্ত পরিবর্তন (আপনার ব্যবহার করা বৈশিষ্ট্যগুলির উপর নির্ভর করে প্রয়োজনীয়)

SDK-এর GA সংস্করণের জন্য বেশ কিছু পরিবর্তন প্রয়োগ করা হয়েছে। আপনার অ্যাপে SDK-এর GA-সংস্করণ গ্রহণ করার জন্য আপনাকে আপনার কোডে যে কোনো পরিবর্তন করতে হতে পারে তার জন্য নিম্নলিখিত তালিকাগুলি পর্যালোচনা করুন৷

  • ফাংশন কলিং
    আপনি যদি GA এর আগে এই বৈশিষ্ট্যটি প্রয়োগ করেন, তাহলে আপনি কীভাবে আপনার স্কিমা সংজ্ঞায়িত করবেন সে সম্পর্কে আপনাকে আপডেট করতে হবে। কিভাবে আপনার ফাংশন ঘোষণা লিখতে হয় তা শিখতে আমরা আপডেট ফাংশন কলিং গাইড পর্যালোচনা করার পরামর্শ দিই।

  • responseSchema ব্যবহার করে স্ট্রাকচার্ড আউটপুট (যেমন JSON) তৈরি করা হচ্ছে
    আপনি যদি GA এর আগে এই বৈশিষ্ট্যটি প্রয়োগ করেন, তাহলে আপনি কীভাবে আপনার স্কিমা সংজ্ঞায়িত করবেন সে সম্পর্কে আপনাকে আপডেট করতে হবে। কীভাবে JSON স্কিমা লিখতে হয় তা শিখতে আমরা নতুন কাঠামোগত আউটপুট গাইড পর্যালোচনা করার পরামর্শ দিই।

  • টাইমআউট

    • অনুরোধের ডিফল্ট সময়সীমা 180 সেকেন্ডে পরিবর্তন করা হয়েছে।

  • গণনা

    • স্ট্যাটিক ভেরিয়েবলের সাথে struct s দিয়ে বেশিরভাগ enum প্রকার প্রতিস্থাপন করা হয়েছে। এই পরিবর্তনটি পিছিয়ে-সামঞ্জস্যপূর্ণ উপায়ে API-কে বিকশিত করার জন্য আরও নমনীয়তার অনুমতি দেয়। switch স্টেটমেন্ট ব্যবহার করার সময়, আপনাকে এখন একটি default: অজানা বা আন-হ্যান্ডেল করা মানগুলিকে কভার করতে, ভবিষ্যতে SDK-তে যুক্ত করা নতুন মানগুলি সহ।

    • BlockThreshold গণনার নাম পরিবর্তন করে HarmBlockThreshold রাখা হয়েছে; এই ধরনের এখন একটি struct ।

    • নিম্নলিখিত গণনাগুলি থেকে unknown এবং unspecified কেসগুলি সরানো হয়েছে (এখন struct ): HarmCategory , HarmBlockThreshold , HarmProbability , BlockReason , এবং FinishReason ৷

    • পশ্চাদগামী-সামঞ্জস্যপূর্ণ উপায়ে নতুন প্রকারগুলি যোগ করার অনুমতি দেওয়ার জন্য Part নামের একটি প্রোটোকল দিয়ে গণনা ModelContent.Part প্রতিস্থাপন করা হয়েছে৷ এই পরিবর্তনটি বিষয়বস্তুর অংশ বিভাগে আরও বিস্তারিতভাবে বর্ণনা করা হয়েছে।

  • বিষয়বস্তু অংশ

    • ThrowingPartsRepresentable প্রোটোকল সরানো হয়েছে, এবং মাঝে মাঝে কম্পাইলার ত্রুটিগুলি এড়াতে ModelContent জন্য ইনিশিয়ালাইজারগুলিকে সরলীকৃত করেছে৷ generateContent এ ব্যবহার করার সময় যে ছবিগুলি সঠিকভাবে এনকোড করে না সেগুলি এখনও ত্রুটি ছুঁড়বে।

    • ModelContent.Part কেসগুলিকে Part প্রোটোকলের সাথে সামঞ্জস্যপূর্ণ নিম্নলিখিত struct টাইপ দিয়ে প্রতিস্থাপন করা হয়েছে:

      • .text থেকে TextPart
      • InlineDataPart এ .data
      • .fileData থেকে FileDataPart
      • .functionCall to FunctionCallPart
      • .functionResponse to FunctionResponsePart

  • ক্ষতি বিভাগ

    • HarmCategory পরিবর্তন করে SafetySetting টাইপ এ আর নেস্ট করা যাবে না। আপনি যদি এটিকে SafetySetting.HarmCategory হিসেবে উল্লেখ করেন, তাহলে সেটিকে HarmCategory দিয়ে প্রতিস্থাপন করা যেতে পারে।

  • নিরাপত্তা প্রতিক্রিয়া

    • SafetyFeedback প্রকারটি সরানো হয়েছে, যেহেতু এটি কোনো প্রতিক্রিয়াতে ব্যবহার করা হয়নি।

  • উদ্ধৃতি মেটাডেটা

    • CitationMetadata এ citationSources সম্পত্তির নাম পরিবর্তন করে citations ।

  • মোট বিলযোগ্য অক্ষর

    • CountTokensResponse এ totalBillableCharacters সম্পত্তি পরিবর্তন করা হয়েছে যাতে কোনো অক্ষর পাঠানো হয় না এমন পরিস্থিতিতে প্রতিফলিত করতে ঐচ্ছিক।

  • প্রার্থীর প্রতিক্রিয়া

    • অন্যান্য প্ল্যাটফর্মের সাথে মেলে Candidate প্রতি CandidateResponse নাম পরিবর্তন করা হয়েছে।

  • জেনারেশন কনফিগারেশন

    • GenerationConfig এর সর্বজনীন বৈশিষ্ট্যগুলিকে internal পরিবর্তন করা হয়েছে। এগুলি সবই ইনিশিয়ালাইজারে কনফিগারযোগ্য থাকে।

স্থানান্তর সম্পর্কিত সম্ভাব্য ত্রুটি৷

যেহেতু আপনি Firebase-এ Vertex AI- এর GA সংস্করণ ব্যবহার করতে মাইগ্রেট করছেন, আপনি যদি এই মাইগ্রেশন গাইডে বর্ণিত সমস্ত প্রয়োজনীয় পরিবর্তনগুলি সম্পূর্ণ না করে থাকেন তবে আপনি ত্রুটির সম্মুখীন হতে পারেন৷

403 ত্রুটি: Requests to this API firebasevertexai.googleapis.com ... are blocked.

আপনি যদি Requests to this API firebasevertexai.googleapis.com ... are blocked. , এর সাধারণত মানে হল যে আপনার ফায়ারবেস কনফিগারেশন ফাইল/অবজেক্টের API কী-তে আপনি যে পণ্যটি ব্যবহার করার চেষ্টা করছেন তার অনুমোদিত তালিকায় প্রয়োজনীয় API নেই।

নিশ্চিত করুন যে আপনার অ্যাপের দ্বারা ব্যবহৃত API কী- এর "API সীমাবদ্ধতা" মঞ্জুরি তালিকায় সমস্ত প্রয়োজনীয় API অন্তর্ভুক্ত রয়েছে। Firebase-এ Vertex AI-এর জন্য, আপনার API কী-এর অনুমোদিত তালিকায় Firebase API-এর ন্যূনতম Vertex AI থাকতে হবে। আপনি যখন Firebase কনসোলের মাধ্যমে নতুন API সক্ষম করেন তখন এই APIটি আপনার API কী-এর অনুমোদিত তালিকায় স্বয়ংক্রিয়ভাবে যোগ করা উচিত ছিল।

আপনি Google Cloud কনসোলে API এবং পরিষেবা > শংসাপত্র প্যানেলে আপনার সমস্ত API কী দেখতে পারেন৷