عندما تكون مستعدًا لإطلاق تطبيقك وجعل المستخدمين النهائيين يتفاعلون مع ميزات الذكاء الاصطناعي التوليدي، احرص على مراجعة قائمة التحقّق هذه التي تتضمّن أفضل الممارسات والنقاط المُهمّة التي يجب أخذها في الاعتبار.
التعليمات العامة
مراجعة قائمة التحقّق العامة للإطلاق للتطبيقات التي تستخدم Firebase
توضِّح قائمة التحقّق من إطلاق Firebase هذه أفضل الممارسات المهمة قبل إطلاق أي تطبيق على Firebase في قناة الإصدار العلني.
التأكّد من اتّباع أفضل الممارسات في مشاريعك على Firebase
على سبيل المثال، تأكَّد من استخدام مشاريع مختلفة على Firebase للتطوير والاختبار والإصدار العلني. راجِع المزيد من أفضل الممارسات المتعلّقة بإدارة مشاريعك.
الوصول والأمان
مراجعة قائمة التحقّق العامة للأمان للتطبيقات التي تستخدم Firebase
توضّح قائمة التحقّق من الأمان هذه أفضل الممارسات المهمة المتعلّقة بالوصول والأمان في تطبيقات Firebase وخدماتها.
بدء فرض Firebase App Check
يساعد App Check في حماية Vertex AI Gemini API من خلال التحقّق من أنّ الطلبات تأتي من تطبيقك الفعلي. وهو متوافق مع مقدّمي خدمات التصديق لplatforms Apple (DeviceCheck أو App Attest) وAndroid (Play Integrity) و الويب (reCAPTCHA Enterprise).
ضبط قيود لمفاتيح واجهة برمجة التطبيقات في Firebase
راجِع قائمة المسموح بها الخاصة بكل مفتاح من مفاتيح واجهة برمجة التطبيقات في Firebase "قيود واجهة برمجة التطبيقات":
تأكَّد من أنّ واجهة برمجة التطبيقات Vertex AI in 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.
يتم قياس حصة كل واجهة برمجة تطبيقات بشكل مختلف قليلاً، ما يعني أنّه يمكن استخدامها لأغراض مختلفة. للاطّلاع على الاعتبارات المهمة، اطّلِع على مقالة التعرّف على الحصص لكل واجهة برمجة تطبيقات.
يُرجى العِلم أنّ الحصص تتغيّر أيضًا وفقًا للطراز والمنطقة، لذا تأكَّد من ضبط الحصص وفقًا لذلك للمستخدمين وحالات الاستخدام.
يمكنك أيضًا تعديل الحصة أو طلب زيادة الحصة، حسب الحاجة.
تجنُّب الفواتير غير المتوقّعة
من أفضل الممارسات في مرحلة الإنتاج هو مراقبة معدّل الاستخدام و إعداد تنبيهات الميزانية.
إدارة الإعدادات
استخدام إصدار ثابت من النموذج في تطبيقك العلني
في تطبيقك العلني، استخدِم فقط
إصدارات النماذج الثابتة (مثل
gemini-1.5-flash-002)، وليس إصدار معاينة أو إصدار يتم تحديثه تلقائيًا.
على الرغم من أنّ الإصدار المُحدَّث تلقائيًا يشير إلى إصدار ثابت، إلا أنّ الإصدار الفعلي للنموذج الذي يشير إليه سيتغيّر تلقائيًا عند طرح إصدار جديد وثابت، ما قد يؤدي إلى ظهور سلوك أو ردود فعل غير متوقّعة. بالإضافة إلى ذلك، لا يُنصح باستخدام إصدارات المعاينة إلا أثناء إنشاء النماذج الأولية.
ننصح أيضًا بشدة باستخدام Firebase Remote Config للتحكّم في اسم النموذج المُستخدَم في تطبيقك وتعديله (اطّلِع على القسم التالي للاطّلاع على التفاصيل).
إعداد Firebase Remote Config واستخدامه
باستخدام Remote Config، يمكنك التحكّم في الإعدادات المهمة لميزة الذكاء الاصطناعي التوليدي في السحابة الإلكترونية بدلاً من الترميز الثابت للقيم في الرمز البرمجي. وهذا يعني أنّه يمكنك تعديل الإعدادات بدون طرح إصدار جديد من تطبيقك. يمكنك تنفيذ الكثير من الإجراءات باستخدام Remote Config، ولكن في ما يلي أهم القيم التي ننصحك بالتحكم فيها عن بُعد لميزة الذكاء الاصطناعي التوليدي:
يُرجى تحديث تطبيقك باستمرار.
- اسم النموذج: عدِّل النموذج الذي يستخدمه تطبيقك عند طرح نماذج جديدة أو إيقاف نماذج أخرى.
تعديل القيم والمدخلات استنادًا إلى سمات العميل أو لاستيعاب الملاحظات الواردة من الاختبارات أو المستخدمين
إعداد النموذج: يمكنك ضبط درجة الحرارة والحد الأقصى للرموز المميّزة للإخراج وغيرها.
إعدادات الأمان: يمكنك ضبط إعدادات الأمان إذا كان يتم حظر عددٍ كبير جدًا من الردود أو إذا أبلغ المستخدمون عن ردود ضارة.
تعليمات النظام وأي طلبات تقدّمها: يمكنك تعديل السياق الإضافي الذي ترسله إلى النموذج لتوجيه استجاباته وسلوكه. على سبيل المثال، قد تحتاج إلى تخصيص طلبات محددة لأنواع عملاء معيّنة، أو تخصيص طلبات للمستخدمين الجدد تختلف عن تلك المستخدَمة لإنشاء الردود للمستخدمين الحاليين.
يمكنك أيضًا اختياريًا ضبط مَعلمة minimum_version في Remote Config
لمقارنة الإصدار الحالي من التطبيق بآخر
إصدار محدّد في Remote Config، وذلك إما لعرض إشعار ترقية للمستخدمين أو إجبارهم على
الترقية.
ضبط الموقع الجغرافي لتشغيل خدمة Vertex AI والوصول إلى نموذج
يمكن أن يساعد ضبط موقع جغرافي في تقليل التكاليف، فضلاً عن المساعدة في منع وقت الاستجابة لدى المستخدمين.
إذا لم تحدّد موقعًا جغرافيًا، ستكون القيمة التلقائية هي us-central1. يمكنك ضبط
هذا الموقع الجغرافي أثناء الإعداد، أو يمكنك اختياريًا
استخدام Firebase Remote Config لتغيير الموقع الجغرافي ديناميكيًا استنادًا إلى الموقع الجغرافي لكل مستخدم.