قائمة التحقّق من الإنتاج لاستخدام ميزة"منطق الذكاء الاصطناعي" من Firebase

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

عام

مراجعة قائمة التحقّق العامة للإطلاق للتطبيقات التي تستخدم Firebase

توضِّح قائمة التحقّق من إطلاق Firebase هذه أفضل الممارسات المهمة قبل إطلاق أي تطبيق على Firebase في قناة الإصدار العلني.

التأكّد من اتّباع أفضل الممارسات في مشاريعك على Firebase

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

الوصول والأمان

مراجعة قائمة التحقّق العامة للأمان للتطبيقات التي تستخدم Firebase

توضّح قائمة التحقّق من الأمان هذه أفضل الممارسات المهمة المتعلّقة بالوصول والأمان في تطبيقات Firebase وخدماتها.

بدء فرض Firebase App Check

يساعد إطار عمل App Check في حماية واجهات برمجة التطبيقات التي تحصل على بيانات من نماذج Gemini وImagen من خلال التحقّق من أنّ الطلبات تأتي من تطبيقك الفعلي. وهو يتوافق مع مقدّمي خدمات إثبات الهوية لمنصّات Apple (DeviceCheck أو App Attest) وAndroid (Play Integrity) وWeb (reCAPTCHA Enterprise).

ضبط قيود لمفاتيح واجهة برمجة التطبيقات في Firebase

  • راجِع قائمة المسموح بها الخاصة بكل مفتاح من مفاتيح واجهة برمجة التطبيقات في Firebase "قيود واجهة برمجة التطبيقات":

  • اضبط "قيود التطبيق" للمساعدة في حصر استخدام كل مفتاح Firebase API بالطلبات الواردة من تطبيقك فقط (على سبيل المثال، رقم تعريف حِزمة مطابق لتطبيق Apple). يُرجى العِلم أنّه حتى إذا حظرت مفتاحك، يُنصح بشدة باستخدام Firebase App Check.

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

الفوترة والمراقبة والحصة

تجنُّب الفواتير غير المتوقّعة

إذا كان مشروعك على Firebase يستخدم خطة الأسعار Blaze المستندة إلى الدفع حسب الاستخدام، عليك مراقبة استخدامك و إعداد تنبيهات الميزانية.

إعداد ميزة "مراقبة الذكاء الاصطناعي" في وحدة تحكّم Firebase

لا يتوفّر هذا الخيار إلا عند استخدام Vertex AI Gemini API كموفّر لواجهة برمجة التطبيقات.

إعداد ميزة "مراقبة الذكاء الاصطناعي" لمراقبة المقاييس ولوحات البيانات المختلفة في وحدة تحكّم Firebase والحصول على رؤية شاملة لطلباتك من حِزم Firebase AI Logic SDK

مراجعة الحصص المخصّصة لواجهات برمجة التطبيقات الأساسية المطلوبة

إدارة الإعدادات

استخدام إصدار ثابت من النموذج في تطبيقك العلني

في تطبيقك العلني، استخدِم فقط إصدارات النماذج الثابتة (مثل gemini-2.0-flash-001)، وليس الإصدار المعاين أو التجريبي أو الاسم المعرِّف المحدَّث تلقائيًا.

على الرغم من أنّ الاسم المعرِّف البديل الثابت المُحدَّث تلقائيًا يشير إلى إصدار ثابت، فإنّ إصدار النموذج الفعلي الذي يشير إليه سيتغيّر تلقائيًا عند طرح إصدار ثابت جديد، ما قد يؤدي إلى ظهور سلوك أو ردود غير متوقّعة. بالإضافة إلى ذلك، لا يُنصح باستخدام الإصدارَين التجريبي والمعاينة إلا أثناء مرحلة إنشاء النماذج الأولية.

إعداد Firebase Remote Config واستخدامه

باستخدام Remote Config، يمكنك التحكّم في الإعدادات المهمة لميزة الذكاء الاصطناعي التوليدي في السحابة الإلكترونية بدلاً من الترميز الثابت للقيم في الرمز. وهذا يعني أنّه يمكنك تعديل الإعدادات بدون طرح إصدار جديد من تطبيقك. يمكنك تنفيذ الكثير من الإجراءات باستخدام Remote Config، ولكن في ما يلي أهم القيم التي ننصحك بالتحكم فيها عن بُعد لميزة الذكاء الاصطناعي التوليدي:

  • يُرجى تحديث تطبيقك باستمرار.

    • اسم النموذج: عدِّل النموذج الذي يستخدمه تطبيقك عند طرح نماذج جديدة أو إيقاف نماذج أخرى.

  • تعديل القيم والمدخلات استنادًا إلى سمات العميل أو لاستيعاب الملاحظات الواردة من الاختبارات أو المستخدمين

    • إعداد النموذج: يمكنك ضبط درجة الحرارة والحد الأقصى للرموز المميّزة للإخراج وغيرها.

    • إعدادات الأمان: يمكنك ضبط إعدادات الأمان إذا كان يتم حظر عددٍ كبيرٍ جدًا من الردود أو إذا أبلغ المستخدمون عن ردود ضارة.

    • تعليمات النظام وأي طلبات تقدّمها: يمكنك تعديل السياق الإضافي الذي ترسله إلى النموذج لتوجيه استجاباته وسلوكه. على سبيل المثال، قد تحتاج إلى تخصيص طلبات محددة لأنواع عملاء معيّنة، أو تخصيص طلبات للمستخدمين الجدد تختلف عن تلك المستخدَمة لإنشاء الردود للمستخدمين الحاليين.

يمكنك أيضًا اختياريًا ضبط مَعلمة minimum_version في Remote Config لمقارنة الإصدار الحالي من التطبيق بأحدث إصدار محدّد في Remote Config، وذلك إما لعرض إشعار ترقية للمستخدمين أو إجبارهم على الترقية.

ضبط الموقع الجغرافي للوصول إلى النموذج

لا يتوفّر هذا الخيار إلا عند استخدام Vertex AI Gemini API كموفّر لواجهة برمجة التطبيقات.

يمكن أن يساعد ضبط موقع جغرافي للوصول إلى النموذج في تقليل التكاليف، كما يساعد في منع وقت الاستجابة لدى المستخدمين.

إذا لم تحدّد موقعًا جغرافيًا، ستكون القيمة التلقائية هي us-central1. يمكنك ضبط هذا الموقع الجغرافي أثناء الإعداد، أو يمكنك اختياريًا استخدام Firebase Remote Config لتغيير الموقع الجغرافي ديناميكيًا استنادًا إلى الموقع الجغرافي لكل مستخدم.