نقل البيانات لاستخدام إصدار "إحصاءات Google" من Vertex AI في Firebase


تم إطلاق Vertex AI in Firebase للجمهور العام في 21 تشرين الأول (أكتوبر) 2024.

إذا كنت قد استخدمت الإصدار التجريبي من مكتبة Vertex AI in Firebase (firebase-vertexai:16.0.0-betaXX)، عليك إجراء الخطوات التالية للترقية إلى استخدام إصدار المكتبة العلني (firebase-vertexai:16.0.0 أو إصدار أحدث).

في ما يلي قائمة على مستوى عالٍ بالتغييرات المطلوبة لنقل البيانات:

تفعيل واجهة برمجة التطبيقات الجديدة المطلوبة في مشروعك على Firebase (إجراء مطلوب للجميع)

عليك تفعيل واجهة برمجة التطبيقات Vertex AI in Firebase في مشروعك على Firebase وإضافتها إلى القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات Firebase. هذه واجهة برمجة تطبيقات جديدة مطلوبة لاستخدام إصدار Universal Analytics من Vertex AI in Firebase.

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة الإنشاء باستخدام Gemini.

  2. في بطاقة Vertex AI in Firebase، انقر على البدء لبدء عملية سير تساعدك في تفعيل واجهة برمجة التطبيقات هذه وإضافتها إلى القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات في Firebase.

  3. يمكنك تخطّي بقية سير العمل في وحدة التحكّم.

التحديث إلى إصدار المكتبة العلني (مطلوب للجميع)

اتّبِع التعليمات التالية لتعديل التبعيات لاستخدام أحدث إصدار من 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، ما عليك سوى قبول أحدث إصدار من firebase-vertexai الذي يقترحه Android Studio.

تغييرات إضافية (مطلوب استيفاؤها حسب الميزات التي تستخدمها)

تم تنفيذ العديد من التغييرات على إصدارات حِزم SDK في "إحصاءات Google". راجِع القائمتَين التاليتَين لمعرفة أي تغييرات قد تحتاج إلى إجرائها في الرمز البرمجي ليتلاءم مع استخدام إصدار حزمة SDK من الإصدار العلني في تطبيقك.

  • استدعاء الدوالّ
    إذا نفّذت هذه الميزة قبل إطلاق "إحصاءات Google"، عليك إجراء تعديلات على طريقة تحديد المخطّط. ننصحك بمراجعة دليل استدعاء الدوال البرمجية المعدَّل للتعرّف على كيفية كتابة تعريفات الدوال البرمجية.

  • إنشاء إخراج منظَّم (مثل JSON) باستخدام responseSchema
    إذا نفّذت هذه الميزة قبل إطلاق الإصدار العلني، عليك إجراء تعديلات على طريقة تحديد المخطّط. ننصحك بمراجعة دليل النتائج المنظَّمة الجديد للتعرّف على كيفية كتابة مخطّطات JSON.

  • المهلة

    • تم تغيير المهلة التلقائية للطلبات لتصبح 180 ثانية.
  • التعدادات

    • تم استبدال صفوف enum وصفوف sealed بصفوف عادية. يتيح هذا التغيير مزيدًا من المرونة لتطوير واجهة برمجة التطبيقات بطريقة متوافقة مع الإصدارات السابقة.

    • تمت إعادة تسمية التعداد BlockThreshold إلى HarmBlockThreshold.

    • تمّت إزالة القيم من التصنيفات التالية: HarmBlockThreshold وHarmProbability وHarmSeverity وBlockReason وFinishReason.

  • طرق Blob

    • تمت إعادة تسمية جميع الطرق التي تتضمّن Blob كجزء من اسمها لاستخدام InlineData بدلاً من ذلك.
  • إعدادات السلامة

    • تم تغيير الحقل method ليكون قابلاً للحذف.
  • فئة المدة

    • تمت إزالة جميع استخدامات فئة Duration في Kotlin واستبدالها بالفئة long. يوفر هذا التغيير إمكانية تفاعل أفضل مع Java.
  • البيانات الوصفية للإسناد

    • تم تضمين جميع الحقول التي تمّ الإعلان عنها سابقًا في CitationMetadata في صفّ جديد يُسمّى Citation. يمكن العثور على الإحالات في القائمة المُسمّاة citations في CitationMetadata. يتيح هذا التغيير تنسيقًا أفضل للأنواع على جميع المنصات.
  • عدّ الرموز المميّزة

    • تم تغيير الحقل totalBillableCharacters ليكون قابلاً للحذف.
  • إجمالي الأحرف التي يمكن إصدار فاتورة بها

    • تم تغيير سمة totalBillableCharacters في CountTokensResponse لتكون اختيارية لتعكس الحالات التي لا يتم فيها إرسال أي أحرف.
  • إنشاء مثيل لنموذج

    • تم نقل المَعلمة requestOptions إلى نهاية قائمة المَعلمات لمحاولة المواءمة مع المنصات الأخرى.

الأخطاء المحتمَلة المرتبطة بعملية نقل البيانات

أثناء نقل البيانات لاستخدام إصدار "إحصاءات Google" من Vertex AI in Firebase، قد تواجه أخطاء إذا لم تكن قد أكملت جميع التغييرات المطلوبة كما هو описан في دليل نقل البيانات هذا.

الخطأ 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.