الأسئلة الشائعة وتحديد المشاكل وحلّها

ما هي واجهات برمجة التطبيقات التي يجب تفعيلها لاستخدام حِزم تطوير البرامج (SDK) من Vertex AI in Firebase؟ كيف يمكنني تفعيلها؟

لاستخدام Vertex AI in Firebase حِزم تطوير البرامج (SDK)، يجب أن يكون مشروعك مزوّدًا بواجهتَي برمجة التطبيقات التاليتَين:

Vertex AI واجهة برمجة التطبيقات (aiplatform.googleapis.com)
Vertex AI in Firebase واجهة برمجة التطبيقات (firebasevertexai.googleapis.com)

يمكنك تفعيل واجهات برمجة التطبيقات هذه ببضع نقرات في وحدة تحكّم Firebase:

انتقِل إلى صفحة إنشاء الإصدارات باستخدام Gemini.
انقر على بطاقة Vertex AI in Firebase لبدء سير عمل يتيح استخدام IDEتَين. سيؤدي سير العمل هذا أيضًا إلى إضافة واجهة برمجة التطبيقات Vertex AI in Firebase إلى القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات في Firebase.

بدلاً من ذلك، يمكنك استخدام وحدة تحكّم Google Cloud (خيار أكثر يدوية):

انقر على كل رابط لواجهة برمجة التطبيقات في أعلى إدخال الأسئلة الشائعة هذا، ثم انقر على تفعيل في صفحة كل واجهة برمجة تطبيقات.
أضِف واجهة برمجة التطبيقات Vertex AI in Firebase إلى القائمة المسموح بها لمفتاح واجهة برمجة التطبيقات في Firebase، وذلك باتّباع التعليمات الواردة في إضافة قيود لواجهة برمجة التطبيقات في مستندات Google Cloud.

ما هي الأذونات المطلوبة لاستخدام حِزم تطوير البرامج (SDK) Vertex AI in Firebase؟

الإجراء	أذونات إدارة الهوية وإمكانية الوصول المطلوبة	أدوار "إدارة الهوية وإمكانية الوصول" التي تتضمّن الأذونات المطلوبة تلقائيًا
ترقية خطة الفوترة إلى خطة الدفع حسب الاستخدام (Blaze)	`firebase.billingPlans.update` `resourcemanager.projects.createBillingAssignment` `resourcemanager.projects.deleteBillingAssignment`	المالك
تفعيل واجهات برمجة التطبيقات في المشروع	`serviceusage.services.enable`	المحرِّر المالك
إنشاء تطبيق Firebase	`firebase.clients.create`	مشرف Firebase المحرِّر المالك

ما هي النماذج التي يمكن استخدامها مع حِزم تطوير البرامج (SDK) من Vertex AI in Firebase؟

يمكنك استخدام حِزم تطوير البرامج (SDK) من Vertex AI in Firebase مع أيّ من نماذج Vertex AI in Firebase الأساسية في Gemini المُدرَجة في مقالة التعرّف على نماذج Gemini.

لا يمكنك استخدام نماذج Gemini غير الأساسية، مثل نماذج PaLM أو النماذج المحسّنة أو نماذج Gemma المستندة إلى Vertex AI in Firebase حِزم تطوير البرامج.

نضيف إمكانات جديدة إلى حِزم تطوير البرامج (SDK) بشكلٍ متكرّر، لذا يُرجى الرجوع إلى هذه الأسئلة الشائعة للاطّلاع على التحديثات (بالإضافة إلى ملاحظات الإصدار والمدوّنات والمشاركات على وسائل التواصل الاجتماعي).

كيف يمكنني حلّ خطأ 400 هذا؟ `Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.`

إذا كنت تحاول إرسال طلب متعدد الوسائط باستخدام Cloud Storage for Firebase عنوان URL، قد يظهر لك الخطأ 400 التالي:
Service agents are being provisioned ... Service agents are needed to read the Cloud Storage file provided.

يحدث هذا الخطأ بسبب مشروع لم يكن يتضمّن موظّفي الخدمة المطلوبين تمّ توفيرهم تلقائيًا بشكل صحيح عند تفعيل واجهة برمجة التطبيقات Vertex AI في المشروع. هذه مشكلة معروفة في بعض المشاريع، ونحن نعمل على حلّها على مستوى عالمي.

في ما يلي الحلّ البديل لإصلاح مشروعك وتوفير جهات تدبير الخدمة هذه بشكل صحيح حتى تتمكّن من بدء تضمين عناوين URL الخاصة بـ Cloud Storage for Firebase في طلباتك المتعدّدة الوسائط. يجب أن تكون مالكًا للمشروع، وعليك سوى إكمال هذه المجموعة من المهام مرة واحدة فقط لمشروعك.

يمكنك الوصول إلى gcloud CLI والمصادقة باستخدامه.
أسهل طريقة لإجراء ذلك هي من Cloud Shell. يمكنك الاطّلاع على مزيد من المعلومات في مستندات Google Cloud.
اتّبِع التعليمات المعروضة في المحطة الطرفية لتشغيل gcloud CLI على مشروعك على Firebase إذا طُلب منك ذلك.

ستحتاج إلى رقم تعريف مشروعك على Firebase، والذي يمكنك العثور عليه في أعلى الشاشة إعدادات المشروع في وحدة تحكّم Firebase.

يمكنك توفير موظّفي الدعم المطلوبين في مشروعك من خلال تنفيذ الأمر التالي:

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" -H "Content-Type: application/json"  https://us-central1-aiplatform.googleapis.com/v1/projects/PROJECT_ID/locations/us-central1/endpoints -d ''

انتظِر بضع دقائق للتأكّد من توفير موظّفي الدعم، ثم أعِد محاولة إرسال طلبك المتعدّد الوسائط الذي يتضمّن عنوان URL Cloud Storage for Firebase.

إذا استمر ظهور هذا الخطأ بعد الانتظار لعدة دقائق، يُرجى التواصل مع فريق دعم Firebase.

كيف يمكنني حلّ خطأ 400 هذا؟ `API key not valid. Please pass a valid API key.`

إذا تلقّيت خطأ 400 يشير إلى API key not valid. Please pass a valid API key.، يعني ذلك عادةً أنّ مفتاح واجهة برمجة التطبيقات في ملف/عنصر إعدادات Firebase غير متوفّر أو لم يتم إعداده لاستخدامه مع تطبيقك و/أو مشروعك على Firebase.

تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المدرَج في ملف/عنصر إعدادات Firebase يتطابق مع مفتاح واجهة برمجة التطبيقات لتطبيقك. يمكنك عرض جميع مفاتيح واجهة برمجة التطبيقات في ملف واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد لوحة وحدة تحكّم Google Cloud.

إذا تبيّن لك أنّهما لا يتطابقان، عليك الحصول على ملف/عنصر إعدادات جديدَين في Firebase، ثم استبدال الملف/العنصر المتوفّرَين في تطبيقك. يجب أن يحتوي ملف/عنصر الإعدادات الجديدَين على مفتاح واجهة برمجة تطبيقات صالح لتطبيقك ومشروعك على Firebase.

كيف يمكنني حلّ خطأ 403 هذا؟ `Requests to this API ... are blocked.`

إذا تلقّيت خطأ 403 يشير إلى Requests to this API ... are blocked.، يعني ذلك عادةً أنّ مفتاح واجهة برمجة التطبيقات في ملف/عنصر إعدادات Firebase لا يتضمّن واجهة برمجة تطبيقات مطلوبة في القائمة المسموح بها للمنتج الذي تحاول استخدامه.

تأكَّد من أنّ مفتاح واجهة برمجة التطبيقات المستخدَم في تطبيقك يتضمّن كل واجهات برمجة التطبيقات المطلوبة والمُدرَجة في القائمة المسموح بها ضمن "قيود واجهة برمجة التطبيقات" للمفتاح. بالنسبة إلى Vertex AI in Firebase، يجب أن يتضمّن مفتاح واجهة برمجة التطبيقات على الأقل واجهة برمجة التطبيقات Vertex AI in Firebase في القائمة المسموح بها.

يمكنك الاطّلاع على جميع مفاتيح واجهة برمجة التطبيقات في واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد لوحة في وحدة تحكّم Google Cloud.

كيف يمكنني حلّ خطأ 403 هذا؟ `PERMISSION_DENIED: The caller does not have permission.`

إذا تلقّيت خطأ 403 يشير إلى PERMISSION_DENIED: The caller does not have permission.، يعني ذلك عادةً أنّ مفتاح واجهة برمجة التطبيقات في ملف/عنصر إعدادات Firebase ينتمي إلى مشروع Firebase مختلف.