تم إطلاق Vertex AI in Firebase للجمهور العام في 21 تشرين الأول (أكتوبر) 2024.
إذا كنت قد استخدمت الإصدار التجريبي من مكتبة Vertex AI in Firebase
(firebase-vertexai:16.0.0-betaXX
)، عليك إجراء الخطوات التالية
للترقية إلى استخدام إصدار المكتبة العلني
(firebase-vertexai:16.0.0
أو إصدار أحدث).
في ما يلي قائمة على مستوى عالٍ بالتغييرات المطلوبة لنقل البيانات:
- تفعيل واجهة برمجة التطبيقات الجديدة المطلوبة في مشروعك على Firebase (إجراء مطلوب للجميع)
- التحديث إلى إصدار المكتبة العلني (مطلوب للجميع)
- تغييرات إضافية (مطلوب استنادًا إلى الميزات التي تستخدمها)
تفعيل واجهة برمجة التطبيقات الجديدة المطلوبة في مشروعك على Firebase (إجراء مطلوب للجميع)
عليك تفعيل واجهة برمجة التطبيقات Vertex AI in Firebase في مشروعك على Firebase وإضافتها إلى القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات Firebase. هذه واجهة برمجة تطبيقات جديدة مطلوبة لاستخدام إصدار Universal Analytics من Vertex AI in Firebase.
في وحدة تحكّم Firebase، انتقِل إلى صفحة الإنشاء باستخدام Gemini.
في بطاقة Vertex AI in Firebase، انقر على البدء لبدء عملية سير تساعدك في تفعيل واجهة برمجة التطبيقات هذه وإضافتها إلى القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات في Firebase.
يمكنك تخطّي بقية سير العمل في وحدة التحكّم.
التحديث إلى إصدار المكتبة العلني (مطلوب للجميع)
اتّبِع التعليمات التالية لتعديل التبعيات لاستخدام أحدث إصدار من Firebase Android BoM. ليس من الضروري استخدام BoM ، ولكننا ننصح بشدة باستخدامه لأنّه يساعد في ضمان استخدام تطبيقك لإصدارات متوافقة من كل مكتبة من مكتبات Firebase.
في ملف 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") }مزامنة مشروع 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.