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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

تتوفّر إمكانية محدودة لاستخدام عناوين IPv6 مع سياسات الوصول المستندة إلى عناوين IP في Remote Config. إذا كانت مؤسستك تحظر الوصول إلى نطاقات محددة من عناوين 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 أو واجهة برمجة التطبيقات Remote Config REST. تحتوي كل مجموعة مَعلمات تنشئها على اسم فريد في نموذج Remote Config. عند إنشاء مجموعات المَعلمات، يُرجى مراعاة ما يلي:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

عرض التغييرات التي تم إجراؤها على المَعلمات والشروط

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

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

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

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

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

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

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

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

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

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

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

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