تقدّم هذه الصفحة إجابات عن الأسئلة الشائعة (FAQ) ومعلومات عن تحديد المشاكل وحلّها في حِزم تطوير البرامج (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:
انتقِل إلى صفحة إنشاء المحتوى باستخدام 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.updateresourcemanager.projects.createBillingAssignmentresourcemanager.projects.deleteBillingAssignment
|
المالك |
| تفعيل واجهات برمجة التطبيقات في المشروع | serviceusage.services.enable |
المحرِّر المالك |
| إنشاء تطبيق Firebase | firebase.clients.create |
مشرف Firebase المحرِّر المالك |
ما هي النماذج التي يمكن استخدامها مع حِزم تطوير البرامج (SDK) من Vertex AI in Firebase؟
يمكنك استخدام أيّ من نماذج Gemini الأساسية مع حِزم تطوير البرامج (SDK) Vertex AI in Firebase، بما في ذلك الإصدارات التجريبية والإصدارات المتوفّرة للاطّلاع فقط. يمكنك الاطّلاع على قائمة بهذه الطُرز في مقالة التعرّف على طُرز 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 في طلباتك المتعدّدة الوسائط. يجب أن تكون مالكًا للمشروع، وعليك سوى إكمال هذه المجموعة من المهام مرة واحدة فقط لمشروعك.
يمكنك الوصول إلى gcloud CLI والمصادقة باستخدامه.
أسهل طريقة لإجراء ذلك هي من Cloud Shell. يمكنك الاطّلاع على مزيد من المعلومات في مستندات Google Cloud.اتّبِع التعليمات المعروضة في المحطة الطرفية لتشغيل gcloud CLI على مشروعك على Firebase إذا طُلب منك ذلك.
ستحتاج إلى رقم تعريف مشروعك على Firebase، والذي يمكنك العثور عليه في أعلى الشاشة settings إعدادات المشروع في وحدة تحكّم 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 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.
تقديم ملاحظات حول تجربتك مع Vertex AI in Firebase