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

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

عام

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

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

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

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

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

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

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

بدء فرض Firebase App Check

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

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

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

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

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

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

تجنُّب الفواتير المفاجئة

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

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

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

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

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

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

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

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