عندما تكون مستعدًا لإطلاق تطبيقك والسماح للمستخدمين النهائيين بالتفاعل مع ميزات الذكاء الاصطناعي التوليدي، احرص على مراجعة قائمة التحقّق هذه التي تتضمّن أفضل الممارسات والاعتبارات المهمة.
عام
مراجعة قائمة التحقّق العامة لإطلاق التطبيقات التي تستخدم Firebase
توضّح قائمة التحقّق هذه الخاصة بإطلاق Firebase أهم أفضل الممارسات قبل إطلاق أي تطبيق على Firebase في مرحلة الإنتاج.
التأكّد من أنّ مشاريعك على Firebase تتّبع أفضل الممارسات
على سبيل المثال، احرص على استخدام مشاريع مختلفة على Firebase للتطوير والاختبار والإصدار العلني. يمكنك مراجعة المزيد من أفضل الممارسات المتعلّقة بإدارة مشاريعك.
الوصول والأمان
مراجعة قائمة التحقّق العامة من الأمان للتطبيقات التي تستخدم Firebase
توضّح قائمة التحقّق من الأمان هذه أهم أفضل الممارسات المتعلّقة بالوصول والأمان لتطبيقات وخدمات Firebase.
بدء فرض Firebase App Check
تساعد Firebase App Check في حماية واجهات برمجة التطبيقات التي تتيح لك الوصول إلى نماذج Gemini وImagen. تتحقّق App Check من أنّ الطلبات صادرة من تطبيقك الفعلي ومن جهاز أصلي غير معدَّل. تتيح هذه الخدمة استخدام موفّري خدمات التصديق على منصات Apple (DeviceCheck أو App Attest) وAndroid (Play Integrity) والويب (reCAPTCHA Enterprise)، كما تتيح استخدام جميع هؤلاء الموفّرين لتطبيقات Flutter وUnity أيضًا.
بالإضافة إلى ذلك، ننصحك بتفعيل استخدام الرموز المميزة ذات الاستخدام المحدود في تطبيقاتك للاستعداد لميزة App Checkالحماية المحسّنة من عمليات إعادة التشغيل القادمة.
إعداد قيود على مفاتيح واجهة برمجة التطبيقات في Firebase
راجِع قائمة السماح "قيود واجهة برمجة التطبيقات" لكل مفتاح من مفاتيح واجهة برمجة التطبيقات في Firebase:
تأكَّد من أنّ واجهة برمجة التطبيقات Firebase AI Logic مدرَجة في القائمة المسموح بها.
تأكَّد من أنّ واجهات برمجة التطبيقات الأخرى الوحيدة في قائمة السماح الخاصة بالمفتاح هي تلك الخاصة بخدمات Firebase التي تستخدمها في تطبيقك. اطّلِع على قائمة واجهات برمجة التطبيقات التي يجب إدراجها في قائمة السماح لكل منتج.
اضبط "قيود التطبيق" للمساعدة في حصر استخدام كل مفتاح لواجهة برمجة تطبيقات Firebase على الطلبات الواردة من تطبيقك فقط (على سبيل المثال، معرّف حزمة مطابق لتطبيق Apple). يُرجى العِلم أنّه حتى في حال فرض قيود على مفتاحك، يظلّ من المهم إعداد Firebase App Check للمساعدة في حماية تطبيقك من إساءة استخدام واجهة برمجة التطبيقات.
يُرجى العِلم أنّ واجهات برمجة التطبيقات المرتبطة بمنصة Firebase تستخدم مفاتيح واجهة برمجة التطبيقات فقط لتحديد مشروع Firebase أو التطبيق، وليس للحصول على إذن لاستدعاء واجهة برمجة التطبيقات.
حصر الطلبات على المستخدمين الذين تمت المصادقة عليهم فقط
فرض وضع المستخدمين الذين تم التحقّق من هويتهم في مشروعك على Firebase، وذلك لضمان أنّ جميع الطلبات التي يرسلها تطبيقك من خلال Firebase AI Logic صادرة عن مستخدمين تم التحقّق من هويتهم (وإلا سيتم حظر الطلب).
الفوترة والرصد والحصة
تجنُّب الفواتير المفاجئة
إذا كان مشروع Firebase الخاص بك على خطة Blaze المَرِنة للدفع حسب الاستخدام:
(Gemini Developer API فقط) إعداد حدود الإنفاق
إعداد ميزة تتبُّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase
إعداد ميزة مراقبة الذكاء الاصطناعي للاطّلاع على مقاييس الأداء الرئيسية، مثل الطلبات ووقت الاستجابة والأخطاء واستخدام الرموز المميزة يساعدك تتبّع استخدام الذكاء الاصطناعي أيضًا في فحص ميزات Firebase AI Logic وتصحيح أخطائها من خلال عرض عمليات التتبُّع الفردية.
مراجعة الحصص المخصّصة لواجهات برمجة التطبيقات الأساسية المطلوبة
تأكَّد من فهم الحصص المخصّصة لكل واجهة برمجة تطبيقات مطلوبة.
ضبط حدود المعدّل لكل مستخدم (القيمة التلقائية هي 100 طلب في الدقيقة)
عدِّل الحصة أو اطلب زيادة الحصة حسب الحاجة.
إدارة عمليات الإعداد
استخدام إصدار نموذج ثابت في تطبيقك المتاح للإصدار العلني
في تطبيقك على قناة الإصدار العلني، استخدِم فقط إصدارات نموذجية ثابتة (مثل gemini-2.0-flash-001)، وليس إصدار معاينة أو تجريبي أو اسمًا مستعارًا يتم تعديله تلقائيًا.
على الرغم من أنّ الاسم المستعار الثابت الذي يتم تعديله تلقائيًا يشير إلى إصدار ثابت، سيتغيّر إصدار النموذج الفعلي الذي يشير إليه تلقائيًا عند إصدار إصدار ثابت جديد، ما قد يؤدي إلى سلوك أو ردود غير متوقّعة. بالإضافة إلى ذلك، لا يُنصح باستخدام الإصدارات التجريبية والمعاينة إلا أثناء إنشاء النماذج الأولية.
إعداد Firebase Remote Config واستخدامه
باستخدام Remote Config، يمكنك التحكّم في الإعدادات المهمة لميزات الذكاء الاصطناعي التوليدي في السحابة الإلكترونية بدلاً من ترميز القيم بشكل ثابت في الرمز. وهذا يعني أنّه يمكنك تعديل الإعدادات بدون إصدار إصدار جديد من تطبيقك.
(يُنصح به بشدة) تغيير اسم النموذج المستخدَم في تطبيقك عن بُعد عند طرح نماذج جديدة أو إيقاف نماذج أخرى
(اختياري) التحكّم بشكلٍ ديناميكي وحتى مشروط في المَعلمات الأخرى في تطبيقك، مثل إعدادات إنشاء النماذج (مثل الحد الأقصى لعدد الرموز المميزة للناتج) وإعدادات الأمان وتعليمات النظام وبيانات الطلبات
(اختياري) اضبط المَعلمة
minimum_versionفي Remote Config لمقارنة الإصدار الحالي من التطبيق بأحدث إصدار محدّد في Remote Config، إما لعرض إشعار ترقية للمستخدمين أو لإجبارهم على الترقية.
ضبط الموقع الجغرافي للوصول إلى النموذج
| لا تتوفّر هذه الميزة إلا عند استخدام Vertex AI Gemini API كمزوّد لواجهة برمجة التطبيقات. |
يمكن أن يساعدك تحديد موقع جغرافي للوصول إلى النموذج في خفض التكاليف والمساعدة في منع حدوث تأخير للمستخدمين.
إذا لم تحدّد موقعًا جغرافيًا، سيكون الموقع الجغرافي التلقائي هو us-central1. يمكنك ضبط هذا الموقع الجغرافي أثناء عملية الإعداد، أو يمكنك اختياريًا استخدام Firebase Remote Config لتغيير الموقع الجغرافي بشكل ديناميكي استنادًا إلى الموقع الجغرافي لكل مستخدم.