برای استفاده از نسخه GA Vertex AI در Firebase، مهاجرت برای استفاده از نسخه GA Vertex AI در Firebase


Vertex AI در Firebase در 21 اکتبر 2024 برای دسترسی عمومی (GA) راه اندازی شد.

اگر از نسخه پیش‌نمایش Vertex AI در کتابخانه Firebase ( firebase/vertexai-preview ) استفاده کرده‌اید، باید تغییرات زیر را برای ارتقا و استفاده از نسخه GA کتابخانه ( firebase/vertexai ) انجام دهید.

در اینجا یک لیست سطح بالا از تغییرات مورد نیاز برای مهاجرت آمده است:

API مورد نیاز جدید را در پروژه Firebase خود فعال کنید (برای همه لازم است)

شما باید Vertex AI را در Firebase API در پروژه Firebase خود فعال کنید و آن را به لیست مجاز کلید Firebase API خود اضافه کنید. این یک API جدید است که برای استفاده از نسخه GA Vertex AI در Firebase لازم است.

  1. در کنسول Firebase ، به صفحه Build with Gemini بروید.

  2. در کارت Vertex AI در Firebase ، روی Get start کلیک کنید تا گردش کاری راه اندازی شود که به شما کمک می کند این API را فعال کنید و آن را به لیست مجاز کلید API Firebase خود اضافه کنید.

  3. می توانید از بقیه گردش کار در کنسول صرف نظر کنید.

به‌روزرسانی به نسخه GA کتابخانه (برای همه لازم است)

برای به‌روزرسانی پایگاه کد برنامه‌تان برای استفاده از نسخه GA کتابخانه، این دستورالعمل‌ها را دنبال کنید:

  1. آخرین نسخه Firebase JS SDK for Web را با استفاده از npm دریافت کنید:

    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";

تغییرات اضافی (بسته به ویژگی هایی که استفاده می کنید لازم است)

چندین تغییر برای نسخه های GA از SDK ها اعمال شد. فهرست‌های زیر را برای هرگونه تغییری که ممکن است لازم باشد در کد خود انجام دهید تا نسخه GA SDK را در برنامه خود انجام دهید، مرور کنید.

  • فراخوانی تابع
    اگر این ویژگی را قبل از GA پیاده‌سازی کرده‌اید، باید نحوه تعریف طرحواره خود را به‌روزرسانی کنید. توصیه می کنیم راهنمای فراخوانی عملکرد به روز شده را مرور کنید تا نحوه نوشتن اعلان عملکرد خود را بیاموزید.

  • تولید خروجی ساختاریافته (مانند JSON) با استفاده از responseSchema
    اگر این ویژگی را قبل از GA پیاده‌سازی کرده‌اید، باید نحوه تعریف طرحواره خود را به‌روزرسانی کنید. توصیه می‌کنیم راهنمای خروجی ساختاریافته جدید را برای یادگیری نحوه نوشتن طرحواره‌های JSON مرور کنید.

  • تایم اوت

    • مدت زمان پیش‌فرض درخواست‌ها را 180 ثانیه تغییر داد.

  • شمارش ها

    • مقادیر از شمارش‌های زیر حذف شد: HarmCategory ، BlockThreshold ، HarmProbability ، HarmSeverity ، BlockReason ، و FinishReason .

  • دلیل را مسدود کنید

    • blockReason در PromptFeedback به اختیاری تغییر داد.

خطاهای احتمالی مربوط به مهاجرت

همانطور که در حال مهاجرت برای استفاده از نسخه GA Vertex AI در Firebase هستید، اگر همه تغییرات مورد نیاز را همانطور که در این راهنمای مهاجرت توضیح داده شده انجام ندهید، ممکن است با خطاهایی روبرو شوید.

خطای 403: Requests to this API firebasevertexai.googleapis.com ... are blocked.

اگر یک خطای 403 دریافت کردید که می‌گوید Requests to this API firebasevertexai.googleapis.com ... are blocked. ، معمولاً به این معنی است که کلید API در فایل/شیء پیکربندی Firebase شما یک API مورد نیاز را در لیست مجاز خود برای محصولی که می‌خواهید استفاده کنید ندارد.

مطمئن شوید که کلید API مورد استفاده برنامه شما دارای همه APIهای مورد نیاز موجود در فهرست مجاز "محدودیت های API" کلید است . برای Vertex AI در Firebase ، کلید API شما باید حداقل دارای Vertex AI در Firebase API در لیست مجاز خود باشد. زمانی که API جدید را از طریق کنسول Firebase فعال کردید، این API باید به‌طور خودکار به فهرست مجاز کلید API شما اضافه می‌شد.

می‌توانید همه کلیدهای API خود را در APIs & Services > پنل اعتبارنامه‌ها در کنسول Google Cloud مشاهده کنید.