عندما تكون مستعدًا لإطلاق تطبيقك وإتاحة الفرصة للمستخدمين النهائيين الحقيقيين للتفاعل مع ميزات تستخدم الذكاء الاصطناعي في تطبيقك، احرص على مراجعة قائمة التحقّق هذه التي تتضمّن أفضل الممارسات والاعتبارات المهمة.
عام
مراجعة قائمة التحقّق العامة للإطلاق
راجِع قائمة التحقّق من إطلاق Firebase للاطّلاع على أفضل الممارسات المهمة قبل إطلاق أي تطبيق Firebase في مرحلة الإصدار العلني.
اتّباع أفضل الممارسات المتعلّقة بمشاريع Firebase
استخدِم مشاريع Firebase منفصلة للتطوير والاختبار والإنتاج. يمكنك مراجعة المزيد من أفضل الممارسات لإدارة مشاريعك.
الوصول والأمان
مراجعة قوائم التحقّق من الأمان
راجِع قائمة التحقّق من الأمان في Firebase وقائمة التحقّق من الأمان في Firebase AI Logic المخصّصة للاطّلاع على أفضل الممارسات المهمة المتعلّقة بالوصول والأمان.
فرض Firebase App Check
يجب فرض Firebase App Check للمساعدة في حماية Gemini API من إساءة الاستخدام عند استدعائه مباشرةً من تطبيقك. عند فرض App Check، يتم التحقّق من أنّ الطلبات الواردة صادرة من تطبيقك الأصلي و/أو جهاز لم يتم التلاعب به.
تتيح منصة App Check استخدام موفّري خدمات المصادقة لأنظمة Apple الأساسية (DeviceCheck أو App Attest أو reCAPTCHA Enterprise) وAndroid (Play Integrity أو reCAPTCHA Enterprise) والويب (reCAPTCHA Enterprise)، كما تتيح استخدام جميع موفّري الخدمات هؤلاء لتطبيقات Flutter وUnity أيضًا.
ننصحك أيضًا بتطبيق الحماية من إعادة التشغيل، ما يعني أنّ الرموز المميّزة تُستخدم لمرة واحدة فقط. يوفّر هذا الخيار حماية محسّنة تتجاوز مستوى الحماية الأساسي، ويتيح لك ضبط مستوى الحماية المناسب لتطبيقك وحالات الاستخدام.
إعداد قيود لمفاتيح واجهة برمجة التطبيقات في Firebase
تحدّد مفاتيح واجهة برمجة التطبيقات في Firebase مشروع Firebase وتطبيقك عند إرسال الطلبات. لمنع الاستخدام غير المصرَّح به لمفاتيح واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:
اضبط "قيود التطبيق" في وحدة تحكّم Google Cloud لحصر استخدام المفتاح على الطلبات الواردة من معرّف الحزمة المحدّد لتطبيقك (Apple) أو اسم الحزمة وبصمة الإصبع SHA-1 (Android) أو مُحيل HTTP (الويب).
راجِع القائمة المسموح بها لكل مفتاح في "قيود واجهة برمجة التطبيقات":
- تأكَّد من أنّ واجهة برمجة التطبيقات
Firebase AI Logic (
firebasevertexai.googleapis.com) مُدرَجة في القائمة المسموح بها. - تأكَّد من أنّ واجهات برمجة التطبيقات الأخرى الوحيدة المدرَجة في القائمة المسموح بها هي خدمات Firebase المحدّدة التي يتطلّبها تطبيقك. اطّلِع على قائمة واجهات برمجة التطبيقات المطلوبة لمفاتيح Firebase المقيَّدة.
- تأكَّد من أنّ واجهة برمجة التطبيقات
Firebase AI Logic (
يُرجى العِلم أنّ واجهات برمجة التطبيقات ذات الصلة بمنصة Firebase تستخدم مفاتيح واجهة برمجة التطبيقات فقط لتحديد مشروع أو تطبيق Firebase، وليس لمنح الإذن بطلب واجهة برمجة التطبيقات.
حصر الطلبات على المستخدمين الذين تمت مصادقتهم فقط
ننصحك بفرض وضع المستخدمين الذين تمت مصادقتهم لكي
تتضمّن جميع الطلبات عبر Firebase AI Logic بيانات اعتماد صالحة من
Firebase Authentication. إذا ورد طلب من مستخدم نهائي غير مصادَق عليه، يتم رفض الطلب مع ظهور الخطأ 401: unauthenticated.
المراقبة والحدود والفوترة
إعداد ميزة تتبّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase
يمكنك إعداد ميزة تتبّع استخدام الذكاء الاصطناعي في وحدة تحكّم Firebase للاطّلاع على مقاييس الأداء الرئيسية، مثل عدد الطلبات ووقت الاستجابة واستخدام الرموز المميّزة ومعدّلات الأخطاء. يمكنك أيضًا فحص عمليات التتبُّع الفردية في وحدة تحكّم Google Cloud.
ضبط حدود المعدّل وإدارة الحصص
يمكنك حماية مشروعك من الارتفاعات غير المتوقّعة في الاستخدام وهجمات حجب المحفظة:
- اضبط حدود المعدّل لكل مستخدم (القيمة التلقائية هي 100 طلب في الدقيقة) لمنع مثيلات العميل الفردية من استهلاك حصة زائدة.
- مراجعة حصص المشاريع وإدارتها في وحدة تحكّم Google Cloud لكل واجهة برمجة تطبيقات أساسية
تجنُّب الفواتير غير المتوقّعة من خلال التنبيهات والحدود القصوى للإنفاق
إذا كان مشروعك على Firebase يستخدم خطة أسعار Blaze المَرِنة:
إدارة الإعدادات
استخدام إصدار نموذج ثابت في تطبيقك العلني
في تطبيقك العلني، استخدِم فقط
إصدارات النماذج الثابتة (مثل
gemini-3.8-flash). لا تستخدِم نسخة حصرية أو
إصدارًا تجريبيًا أو الاسم المستعار -latest
استخدام Firebase Remote Config أو نماذج الطلبات من الخادم
عند استخدام Remote Config أو نماذج الطلبات من الخادم، يمكنك التحكّم في الإعدادات المهمة لميزات تطبيقك التي تستخدم الذكاء الاصطناعي في السحابة الإلكترونية (من جهة الخادم) بدلاً من استخدام قيم غير قابلة للتغيير في الرمز البرمجي. ويعني هذا أنّه يمكنك تعديل الإعدادات بدون طرح إصدار جديد من تطبيقك.
(ننصح بشدة) بإجراء تغييرات عند الطلب على اسم النموذج المستخدَم في الميزة التي تستخدم الذكاء الاصطناعي عند إصدار نماذج جديدة أو إيقاف نماذج أخرى. يمكنك الاطّلاع على تفاصيل حول استخدام Remote Config أو نماذج الطلبات من الخادم.
(اختياري) يمكنك التحكّم بشكل ديناميكي وحتى شرطي في المَعلمات الأخرى لميزة تستخدم الذكاء الاصطناعي، مثل إعدادات النموذج (مثل الحد الأقصى لعدد الرموز المميّزة في المخرجات) وإعدادات الأمان وتعليمات النظام وبيانات الطلبات. يمكنك الاطّلاع على تفاصيل حول استخدام Remote Config أو نماذج الطلبات من الخادم.
(اختياري) اضبط مَعلمة
minimum_versionفي Remote Config لمقارنة الإصدار الحالي من التطبيق مع أحدث إصدار محدّد في Remote Config، إما لعرض إشعار بالترقية للمستخدمين أو لإلزامهم بالترقية.
ضبط الموقع الجغرافي للوصول إلى النموذج
| لا تتوفّر هذه الميزة إلا عند استخدام Agent Platform Gemini API (formerly Vertex AI) كموفّر لواجهة برمجة التطبيقات. |
حدِّد موقعًا جغرافيًا للوصول إلى النموذج للمساعدة في تحسين الحصة ومنع وقت الاستجابة للمستخدمين.
في حال عدم تحديد موقع جغرافي، يكون الموقع التلقائي هو global (عند استخدام البنية الجديدة لإعداد "منصة الوكيل"). يمكنك ضبط هذا الموقع الجغرافي أثناء
الإعداد، أو يمكنك اختياريًا
استخدام Firebase Remote Config لتغيير الموقع الجغرافي ديناميكيًا استنادًا إلى الموقع الجغرافي لكل مستخدم.