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

ما هي واجهات برمجة التطبيقات التي يجب تفعيلها لاستخدام حِزم تطوير البرامج (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.

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

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

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

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

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

هل هذه الميزات متاحة عند استخدام Vertex AI in Firebase؟ التخزين المؤقت للسياق، و"بحث Google" كأداة، و"بحث Google" كأداة مرجعية، وتنفيذ الرموز البرمجية، وتحسين النموذج، وإنشاء النماذج المضمّنة، والاسترجاع الدلالي؟

تتيح نماذج مختلفة أو Vertex AI Gemini API ميزة الاحتفاظ المؤقت بالسياق واستخدام "بحث Google" كأداة وربط البيانات بقاعدة المعلومات في "بحث Google" وتنفيذ الرموز البرمجية، وتحسين النموذج وإنشاء النماذج المضمّنة واسترجاع المحتوى بالاستناد إلى السياق، ولكن لا تتوفّر هذه الميزات عند استخدام Vertex AI in Firebase.

إذا أردت إضافة هذه الطلبات كطلبات ميزات أو التصويت على طلب ميزة حالي، يُرجى الانتقال إلى Firebase UserVoice.

كيف يمكنني ضبط حدّ أقصى للسعر لكل مستخدم؟

بشكلٍ تلقائي، يضبط Vertex AI in Firebase الحدّ الأقصى للطلبات لكلّ مستخدِم على 100 طلب في الدقيقة (RPM).

إذا كنت تريد تعديل الحد الأقصى للسعر لكل مستخدم، عليك تعديل إعدادات حصة Vertex AI in Firebase API.

مزيد من المعلومات حول حصة واجهة برمجة التطبيقاتVertex AI in Firebase في هذه الصفحة، يمكنك أيضًا التعرّف على كيفية عرض حصّتك وتعديلها.

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

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

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

   ستحتاج إلى رقم تعريف مشروعك على Firebase، والذي يمكنك العثور عليه في أعلى الشاشة settings إعدادات المشروع في وحدة تحكّم 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.

كيف يمكنني حلّ خطأ 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 firebasevertexai.googleapis.com ... are blocked.

إذا تلقّيت خطأ 403 يشير إلى Requests to this API firebasevertexai.googleapis.com ... 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 مختلف.

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

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