قائمة التحقّق الخاصة بالإنتاج لاستخدام Vertex AI في 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

على سبيل المثال، إذا جرّبت Gemini API لأول مرة باستخدام Google AI Studio، يمكنك الآن إيقاف Generative Language API. يستخدم تطبيقك الآن Vertex AI in Firebase، الذي يعتمد على Vertex AI API و Vertex AI in Firebase API بدلاً من ذلك.

الفوترة والحصة

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

يتطلّب استخدام Vertex AI in Firebase واجهتَي برمجة تطبيقات: واجهة برمجة تطبيقات Vertex AI و واجهة برمجة تطبيقات Vertex AI in Firebase.

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

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

يمكنك أيضًا تعديل الحصة أو طلب زيادة الحصة، حسب الحاجة.

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

من أفضل الممارسات في مرحلة الإنتاج هو مراقبة معدّل الاستخدام و إعداد تنبيهات الميزانية.

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

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

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

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

ننصح أيضًا بشدة باستخدام Firebase Remote Config للتحكّم في اسم النموذج المُستخدَم في تطبيقك وتعديله (اطّلِع على القسم التالي للاطّلاع على التفاصيل).

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

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

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

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

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

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

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

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

ضبط الموقع الجغرافي لتشغيل خدمة Vertex AI والوصول إلى نموذج

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

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