مَعلمات وشروط الإعداد عن بُعد في نماذج الخادم

اختيار نوع النموذج:

نماذج برامج العميل نماذج الخادم

يمكنك عرض مَعلمات وقيم Remote Config من النماذج الخاصة بالخادم لعمليات تنفيذ Remote Config (بما في ذلك Cloud Run وCloud Functions for Firebase) التي تستخدم بيئات الخادم التالية:

• الإصدار 12.1.0 أو إصدار أحدث من حزمة Firebase Admin Node.js SDK
• الإصدار 6.7.0 من حزمة تطوير البرامج (SDK) لمشرف Firebase في Python أو إصدار أحدث
• الإصدار 4.17.0 من حزمة Firebase Admin Go SDK أو الإصدارات الأحدث
• الإصدار 9.7.0 من حزمة Firebase Admin Java SDK أو إصدار أحدث

عند استخدام وحدة تحكّم Firebase أو واجهات برمجة تطبيقات الخلفية لميزة "Remote Config"، يمكنك تحديد مَعلمة واحدة أو أكثر (أزواج المفتاح/القيمة) وتقديم قيم تلقائية لهذه المَعلمات في رمز الخادم. يمكنك إلغاء القيم التلقائية من خلال تحديد قيم المَعلمات في نموذج Remote Config. مفاتيح المَعلمات وقيمها هي سلاسل، ولكن يمكن تحويل قيم المَعلمات إلى أنواع بيانات أخرى عند استخدام هذه القيم في تطبيقك.

باستخدام وحدة تحكّم Firebase، Admin SDK أو واجهة برمجة تطبيقات REST لخدمة Remote Config، يمكنك إنشاء قيم تلقائية جديدة للمَعلمات، بالإضافة إلى قيم شرطية تُستخدَم لاستهداف مجموعات من طلبات العملاء. في كل مرة تعدّل فيها إعداداتك في وحدة تحكّم "Firebase"، تنشئ Firebase إصدارًا جديدًا من نموذج "Remote Config" وتنشره. يتم تخزين النسخة السابقة، مما يتيح لك استردادها أو التراجع عنها حسب الحاجة. تتوفّر لك هذه العمليات في وحدة تحكّم Firebase وFirebase Admin SDK وREST API، ويتم شرحها بمزيد من التفصيل في مقالة إدارة إصدارات نماذج Remote Config.

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

الشروط والقواعد والقيم الشرطية

يتم استخدام الشرط لاستهداف مجموعة من طلبات العملاء. تتألف الشروط من قاعدة واحدة أو أكثر يجب أن يتم تقييمها جميعًا على أنّها true لكي يتم تقييم الشرط على أنّه true لطلب عميل معيّن. إذا كانت قيمة القاعدة غير محدّدة (على سبيل المثال، في حال عدم توفّر قيمة)، يتم تقييم هذه القاعدة على أنّها false.

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

يمكن أن تحتوي المَعلمة على قيم شرطية متعددة تستخدم شروطًا مختلفة، ويمكن أن تشارك المَعلمات الشروط ضمن مشروع معيّن. في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps & Engagement > الإعداد عن بُعد > المَعلمات للاطّلاع على نسبة الجلب للقيم الشرطية لكل مَعلمة. يشير هذا المقياس إلى النسبة المئوية للطلبات التي تلقّت كل قيمة في آخر 24 ساعة.

إضافة الشروط أو تعديلها أو إعادة ترتيبها أو حذفها باستخدام وحدة تحكّم Firebase

يمكنك إنشاء شروط الاستهداف وتعديلها وإعادة ترتيبها وحذفها في وحدة تحكّم Firebase. تتم مشاركة الشروط في جميع المَعلمات ضمن المشروع. إليك كيفية إدارة الشروط:

1. في وحدة تحكّم Firebase، انتقِل إلى DevOps & Engagement > الإعداد عن بُعد > صفحة الشروط (أو اختَر إدارة الشروط من صفحة المَعلمات).
2. إضافة شرط: انقر على إضافة شرط (أو إنشاء الشرط الأول)، وأدخِل اسمًا يحدّد هدف الاستهداف، واختَر قاعدة استهداف واحدة أو أكثر.
3. تعديل شرط: انقر على اسم الشرط أو رمز التعديل، وعدِّل القواعد حسب الحاجة، ثم انقر على حفظ.
4. تغيير أولوية الشرط: في صفحة الشروط، اسحب الشروط باستخدام مقبض الإمساك لإعادة ترتيبها. وتحظى الشروط الأعلى في القائمة بالأولوية على الشروط الأدنى في القائمة.
5. حذف شرط: انقر على رمز الحذف بجانب الشرط الذي تريد إزالته. إذا تمت الإشارة إلى الشرط من خلال أي مَعلمة، ستؤدي إزالته أيضًا إلى إزالة القيم الشرطية المرتبطة به.

بعد حفظ التغييرات في الشرط، انشر النموذج باستخدام نشر التغييرات.

قيود الإصدار السادس من بروتوكول الإنترنت (IPv6) مع التحكّم في الوصول المستند إلى عنوان IP

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

• الوصول إلى وحدة التحكّم: قد لا تتمكّن من استخدام ميزات معيّنة في "Remote Config" في وحدة تحكّم "Firebase"، مثل تحميل البيانات أو إعداد الاستهداف.
• وصول العميل: قد تظهر أخطاء PERMISSION_DENIED في تطبيقات العملاء.

لتجنُّب هذه المشاكل، يمكنك ضبط شبكتك لاستخدام IPv4 أو إضافة نطاقات عناوين IP المطلوبة في Firebase إلى القائمة المسموح بها في مؤسستك.

أولوية قيمة المَعلمة

عند استخدام Remote Config في تطبيقات الخادم باستخدام Firebase Admin SDK، يمكنك جلب النموذج بالكامل وتحميله لاستخراج قيم المَعلمات المناسبة عند الطلب لكل طلب عميل. قد تحتوي المعلمة على عدة قيم شرطية مرتبطة بها.

تحدّد القواعد التالية القيمة التي يتم تعيينها أثناء تقييم النموذج في وقت معيّن:

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

2. إذا لم تكن هناك قيم شرطية مع شروط يتم تقييمها على أنّها true، يتم تقديم القيمة التلقائية لـ "Remote Config" أثناء تقييم النموذج. إذا لم تكن المَعلمة متوفّرة في النموذج، أو إذا تم ضبط القيمة التلقائية على استخدام القيمة التلقائية داخل التطبيق، لن يتم تقديم أي قيمة لهذه المَعلمة عند تقييم النموذج.

لمزيد من المعلومات حول تحميل نماذج Remote Config وتقييمها في تطبيقات الخادم، يُرجى الاطّلاع على استخدام Remote Config في بيئات الخادم.

أنواع بيانات قيم المَعلمات

تتيح لك ميزة "Remote Config" اختيار نوع بيانات لكل مَعلمة، والتحقّق من صحة جميع قيم "Remote Config" وفقًا لهذا النوع قبل تعديل النموذج. يتم تخزين نوع البيانات وعرضه في طلب getRemoteConfig.

أنواع البيانات المتوافقة هي:

• String
• Boolean
• Number
• JSON

في واجهة مستخدم وحدة تحكّم Firebase، يمكن اختيار نوع البيانات من قائمة منسدلة بجانب مفتاح المَعلمة. في REST API، يمكن ضبط الأنواع باستخدام الحقل value_type ضمن عنصر المَعلمة.

مجموعات المَعلمات

تتيح لك ميزة "Remote Config" تجميع المَعلمات معًا للحصول على واجهة مستخدم أكثر تنظيمًا وتحسين سهولة الاستخدام.

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

يمكنك إنشاء مجموعات مَعلمات باستخدام وحدة تحكّم Firebase أو REST API في Remote Config. تحمل كل مجموعة مَعلمات تنشئها اسمًا فريدًا في نموذج Remote Config. عند إنشاء مجموعات المَعلمات، يُرجى مراعاة ما يلي:

• يمكن تضمين المَعلمات في مجموعة واحدة فقط في أي وقت، ويجب أن يكون مفتاح المَعلمة فريدًا في جميع المَعلمات.
• يجب ألا يتجاوز طول أسماء مجموعات المَعلمات 256 حرفًا.
• إذا كنت تستخدم كلاً من REST API ووحدة تحكّم Firebase، تأكَّد من تعديل أي منطق في REST API للتعامل مع مجموعات المَعلمات عند النشر.

إنشاء مجموعات المَعلمات أو تعديلها باستخدام وحدة تحكّم Firebase

يمكنك تجميع المَعلمات في وحدة تحكّم Firebase. إليك كيفية إنشاء مجموعة أو تعديلها:

1. في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps & Engagement > الإعداد عن بُعد > المَعلمات.
2. انقر على إدارة المجموعات.
3. ضَع علامة في مربّعات الاختيار بجانب المَعلمات التي تريد إضافتها، ثم انقر على نقل إلى المجموعة.
4. اختَر مجموعة حالية أو أنشِئ مجموعة جديدة من خلال إدخال اسم ووصف، ثم انقر على إنشاء مجموعة جديدة. بعد حفظ مجموعة، تصبح متاحة للنشر باستخدام الزر نشر التغييرات.

أنواع قواعد الشروط

تتيح نماذج Remote Config لتطبيقات الخادم أنواع الشروط التالية:

• المستخدم في نسبة مئوية عشوائية
• شروط الإشارات المخصّصة

المستخدم في نسبة مئوية عشوائية

استخدِم هذا الحقل لتطبيق تغيير على عيّنة عشوائية من نُسخ التطبيق (بأحجام عيّنات صغيرة تصل إلى %0 .0001)، وذلك باستخدام أداة شريط التمرير لتقسيم المستخدمين الذين تم ترتيبهم عشوائيًا (نُسخ التطبيق) إلى مجموعات.

يتم ربط كل مثيل تطبيق بشكل دائم برقم عشوائي صحيح أو كسري، وفقًا للقيمة الأولية المحدّدة في هذا المشروع.

ستستخدم القاعدة المفتاح التلقائي (الذي يظهر على شكل تعديل القيمة الأساسية في وحدة تحكّم Firebase) ما لم تعدّل القيمة الأساسية. يمكنك إعادة قاعدة إلى استخدام المفتاح التلقائي من خلال محو حقل القيمة الأولية.

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

على سبيل المثال، لإنشاء شرطَين مرتبطَين ينطبق كل منهما على %5 من مستخدمي التطبيق غير المتداخلين، يمكنك ضبط شرط واحد لمطابقة نسبة مئوية تتراوح بين %0 و%5 وضبط شرط آخر لمطابقة نطاق يتراوح بين %5 و%10. للسماح لبعض المستخدمين بالظهور عشوائيًا في كلتا المجموعتين، استخدِم قيمًا أساسية مختلفة للقواعد ضمن كل شرط.

لمعرفة كيفية إضافة شروط النسبة المئوية العشوائية إلى تطبيقك، يُرجى الاطّلاع على ضبط تطبيق الخادم.

شروط الإشارات المخصّصة

يمكنك استخدام القيم الشرطية للإشارة المخصّصة لمطابقة الشروط العشوائية التي تحدّدها في تطبيقك. يتيح لك ذلك تخصيص استجابة الخادم لكل طلب عميل. تتوفّر شروط الإشارات المخصّصة في الإصدارات التالية من بيئات الخادم:

• الإصدار 12.1.0 أو إصدار أحدث من حزمة Firebase Admin Node.js SDK
• الإصدار 6.7.0 من حزمة تطوير البرامج (SDK) لمشرف Firebase في Python أو إصدار أحدث
• الإصدار 4.17.0 من حزمة Firebase Admin Go SDK أو الإصدارات الأحدث
• الإصدار 9.7.0 من حزمة Firebase Admin Java SDK أو إصدار أحدث

على سبيل المثال، إذا كنت تعمل على تطبيق خادم يستخدم الذكاء الاصطناعي التوليدي للمساعدة في صياغة الردود باستخدام نماذج مختلفة تم ضبطها لمنصات معيّنة، يمكنك إجراء ما يلي:

1. أضِف المَعلمتَين prompt وmodel_name إلى نموذج خادم Remote Config.
2. أضِف شروط إشارة مخصّصة بقيمة platform لكل منصة تريد استهدافها.
3. أضِف قيمًا تلقائية إلى نموذج Remote Config الخاص بالخادم وقيمًا شرطية لكل شرط من شروط المنصة التي حدّدتها.
4. عدِّل الرمز البرمجي للتطبيق من أجل ضبط الإشارة المخصّصة platform واستخدامها.

يمكن لتطبيقك الآن استخراج الطلب والنموذج المناسبَين أثناء تقييم النموذج واستخدامهما لتقديم ردود مخصّصة لكل عميل.

يمكنك استخدام أنواع القواعد التالية لإنشاء شروط إشارات مخصّصة في وحدة تحكّم Firebase.

فئة المشغّل	المشغِّلون	القيمة
نص	يتطابق تمامًا، يحتوي على، لا يحتوي على، يحتوي على تعبير نمطي	تكون مقارنات السلاسل لهذه القاعدة حسّاسة لحالة الأحرف. عند استخدام عامل التشغيل يتطابق تمامًا أو يحتوي على أو لا يحتوي على أو يحتوي على تعبير عادي، يمكنك اختيار قيم متعددة. عند استخدام عامل التشغيل يحتوي على تعبير نمطي، يمكنك إنشاء تعبيرات عادية بتنسيق RE2. يمكن أن يتطابق التعبير العادي مع سلسلة الإصدار المستهدَف بالكامل أو مع جزء منها. يمكنك أيضًا استخدام الرمزين ^ و$ لمطابقة بداية سلسلة مستهدفة أو نهايتها أو السلسلة بأكملها.
أرقام	<, <=, =, !=, >, >=	رقم لا يزيد عن 10 أرقام على كل جانب من النقطة العشرية.
الإصدارات	<, <=, =, !=, >, >=	رقم يمثّل أرقام الإصدارات المطلوب مطابقتها (على سبيل المثال، 2.1.0).

لمعرفة كيفية إضافة إشارات مخصّصة إلى تطبيقك، يُرجى الاطّلاع على ضبط تطبيق الخادم.

مَعلمات البحث وشروطه

يمكنك البحث في مفاتيح المَعلمات وقيم المَعلمات والشروط الخاصة بمشروعك من وحدة تحكّم Firebase باستخدام مربّع البحث في أعلى صفحة DevOps والتفاعل > الإعداد عن بُعد > المَعلمات.

الحدود القصوى للمَعلمات والشروط

ضمن مشروع Firebase، يمكنك استخدام ما يصل إلى 3,000 مَعلمة و2,000 شرط. يمكن أن يصل طول مفاتيح المَعلمات إلى 256 حرفًا، ويجب أن تبدأ بشرطة سفلية أو حرف باللغة الإنجليزية (A-Z أو a-z)، ويمكن أن تتضمّن أيضًا أرقامًا. لا يمكن أن يتجاوز إجمالي طول سلاسل قيم المَعلمات ضمن المشروع الواحد 1,000,000 حرف. بالإضافة إلى ذلك، يمكن أن تتضمّن قواعد الشروط المستندة إلى خصائص المستخدمين ما يصل إلى 100 قيمة لخصائص المستخدمين. للاطّلاع على قائمة كاملة بالحدود القصوى، يُرجى مراجعة الحصص والحدود القصوى.

الاطّلاع على التغييرات في المَعلمات والشروط

يمكنك الاطّلاع على آخر التغييرات التي تم إجراؤها على نماذج "Remote Config" من خلال وحدة تحكّم "Firebase". لكل مَعلمة وشرط فردي، يمكنك إجراء ما يلي:

• يمكنك الاطّلاع على اسم المستخدم الذي أجرى آخر تعديل على المَعلمة أو الشرط.

• إذا حدث التغيير في اليوم نفسه، يمكنك الاطّلاع على عدد الدقائق أو الساعات التي انقضت منذ نشر التغيير في نموذج Remote Config النشط.

• إذا حدث التغيير قبل يوم واحد أو أكثر، يمكنك الاطّلاع على تاريخ نشر التغيير في نموذج "Remote Config" النشط.

سجلّ التغييرات للمَعلمات

في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps & Engagement > الإعداد عن بُعد > المَعلمات. يعرض عمود تاريخ آخر نشر آخر مستخدم عدّل كل مَعلمة وتاريخ آخر نشر للتغيير:

• لعرض البيانات الوصفية للتغييرات في المَعلمات المجمّعة، وسِّع مجموعة المَعلمات.

• للترتيب تصاعديًا أو تنازليًا حسب تاريخ النشر، انقر على تصنيف عمود تاريخ آخر نشر.

سجلّ التغييرات للشروط

في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps & Engagement > الإعداد عن بُعد > الشروط. يمكنك الاطّلاع على آخر مستخدم عدّل الشرط وتاريخ تعديله بجانب تاريخ آخر تعديل ضمن كل شرط.

الخطوات التالية

لضبط مشروع Firebase وتطبيق الخادم لاستخدام Remote Config، يُرجى الاطّلاع على استخدام Remote Config في بيئات الخادم.