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

iOS والإصدارات الأحدث Android الويب Flutter

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

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

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

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

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

1. انتقِل إلى صفحة إنشاء الإصدارات باستخدام Gemini.

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

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

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

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

ملاحظة: كان الإصدار التجريبي من Vertex AI in Firebase يتطلّب استخدام Firebase ML API (firebaseml.googleapis.com)، ولكن لم تعُد هذه الواجهة مطلوبة الآن بعد أن أصبح Vertex AI in Firebaseمتاحًا بشكل عام (الإصدار العلني).

ما هي الأذونات المطلوبة لاستخدام حِزم تطوير البرامج (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 في طلباتك المتعدّدة الوسائط. يجب أن تكون مالكًا للمشروع، وعليك سوى إكمال هذه المجموعة من المهام مرة واحدة فقط لمشروعك.

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

2. اتّبِع التعليمات المعروضة في المحطة الطرفية لتشغيل gcloud CLI على مشروعك على Firebase إذا طُلب منك ذلك.

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

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

   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 ''
   

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

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

تقديم ملاحظات حول تجربتك مع Vertex AI in Firebase