نماذج "الإعداد عن بُعد" وتحديد الإصدارات


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

يناقش هذا القسم نماذج الخادم. للاطّلاع على معلومات حول النماذج الخاصة بالعملاء، انقر على نماذج العملاء.

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

في ما يلي مثال على ملف نموذج الخادم:

{
  "parameters": {
    "preamble_prompt": {
      "defaultValue": {
        "value": "You are a helpful assistant who knows everything there is to know about Firebase! "
      },
      "description": "Add this prompt to the user's prompt",
      "valueType": "STRING"
    },
    "model_name": {
      "defaultValue": {
        "value": "gemini-pro-test"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"temperature\": 0.9, \"maxOutputTokens\": 2048, \"topP\": 0.9, \"topK\": 20}"
      },
      "valueType": "JSON"
    },
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

يمكنك تنفيذ مهام إدارة الإصدارات هذه باستخدام وحدة تحكّم Firebase:

  • عرض قائمة بجميع إصدارات النماذج المخزَّنة
  • استرداد إصدار معيّن
  • العودة إلى إصدار محدّد من تطبيق العميل
  • حذف نماذج Remote Config من صفحة سجلّ التغيير

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

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

يمكنك حذف نماذج Remote Config حسب الحاجة من صفحة سجلّ التغييرات في وحدة تحكّم Remote Config.

إدارة نُسخ نموذج Remote Config

يوضّح هذا القسم كيفية إدارة إصدارات نموذج Remote Config.

عرض جميع الإصدارات المخزَّنة من النموذج Remote Config

يمكنك استرداد قائمة بجميع الإصدارات المخزّنة من نموذج Remote Config. ولإجراء ذلك:

  1. من وحدة تحكّم Firebase، افتح Remote Config.

  2. بعد ذلك، من علامة التبويب المَعلمات، انقر على رمز "الساعة" المعروض في أعلى يسار الصفحة.

    يؤدي ذلك إلى فتح صفحة سجلّ التغييرات التي تعرض جميع إصدارات النماذج المخزّنة في قائمة على يسار الصفحة.

    تتضمّن قائمة النماذج بيانات وصفية لجميع النُسخ المخزّنة، بما في ذلك وقت التعديل والمستخدم الذي أجراه وطريقة إجرائه.

استرداد إصدار معيّن من نموذج Remote Config

يمكنك استرداد أي إصدار محدّد مخزَّن من نموذج Remote Config. لاسترداد نسخة من نموذج مخزَّن، اتّبِع الخطوات التالية:

  1. افتح لوحة التفاصيل الخاصة بسجلّ التغييرات.

  2. للاطّلاع على تفاصيل نسخة أخرى في القائمة، اختَرها من القائمة اليمنى.

  3. يمكنك الاطّلاع على اختلاف مفصّل بين النموذج النشط وأي نسخة أخرى مخزّنة من خلال تمرير مؤشر الماوس فوق قائمة السياق لأي نسخة غير محدّدة واختيار المقارنة مع النسخة المحدّدة.

العودة إلى إصدار محدّد مخزَّن من نموذج Remote Config

يمكنك الرجوع إلى أي نسخة محفوظة من النموذج. للتراجع عن نموذج:

  1. ابحث عن زر الخيار في أعلى يسار صفحة سجلّ التغيير. انقر على هذا الخيار وأكِّده فقط إذا كنت متأكدًا من أنّك تريد الرجوع إلى هذا الإصدار واستخدام هذه القيم على الفور لجميع التطبيقات والمستخدمين.

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

حذف نموذج Remote Config

يمكنك حذف نماذج Remote Config من وحدة تحكّم Firebase. لحذف نموذج Remote Config، اتّبِع الخطوات التالية:

1. من صفحة Remote Config المَعلمات، انقر على سجلّ التغييرات.

  1. انتقِل إلى النموذج الذي تريد حذفه، وانقر على المزيد، ثم اختَر حذف.

  2. عندما يُطلب منك تأكيد الحذف، انقر على حذف.

تنزيل نماذج Remote Config ونشرها

نزِّل نماذج Remote Config وانشرها لدمجها في أنظمة التحكّم في المصدر والإنشاء، وأتمِت تعديلات الإعدادات، وحافظ على مزامنة المَعلمات والقيم في مشاريع متعددة.

يمكنك تنزيل نموذج Remote Config النشط حاليًا من وحدة تحكّم Firebase. يمكنك بعد ذلك تعديل ملف JSON الذي تم تصديره ونشره في المشروع نفسه، أو نشره في مشروع جديد أو حالي.

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

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

لا يتم تضمين المَعلمات وقيم المَعلمات التي تم إنشاؤها خصيصًا كخيارات في تجربة A/B Testing ضمن النماذج التي يتم تصديرها.

لتصدير نماذج Remote Config واستيرادها، اتّبِع الخطوات التالية:

  1. نزِّل Remote Config نموذج الإعدادات الحالي.
  2. التحقّق من صحة نموذج Remote Config
  3. انشر نموذج Remote Config.

تنزيل نموذج "الإعداد عن بُعد" الحالي

استخدِم ما يلي لتنزيل نموذج Remote Config النشط بتنسيق JSON:

  1. من علامة التبويب Remote Config المَعلمات أو الشروط، افتح القائمة، ثم اختَر تنزيل ملف الإعداد الحالي.
  2. عندما يُطلب منك ذلك، انقر على تنزيل ملف الإعداد، واختَر المكان الذي تريد حفظ الملف فيه، ثم انقر على حفظ.

التحقّق من صحة نموذج الإعداد عن بُعد

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

نشر نموذج Remote Config

بعد تنزيل نموذج وإجراء أي تغييرات مطلوبة على محتوى JSON والتحقّق من صحته، يمكنك نشره في مشروع.

يؤدي نشر نموذج إلى استبدال نموذج الإعداد الحالي بالكامل بالملف المعدَّل وزيادة رقم إصدار النموذج بمقدار واحد. بما أنّه يتم استبدال الإعداد بأكمله، إذا حذفت مَعلمة من ملف JSON ونشرته، سيتم حذف المَعلمة من الخادم ولن تكون متاحة للعملاء بعد ذلك.

بعد النشر، تصبح التغييرات التي يتم إجراؤها على المَعلمات والقيم متاحة على الفور لتطبيقاتك ومستخدميها. عند اللزوم، يمكنك العودة إلى إصدار سابق.

استخدِم الأوامر التالية لنشر النموذج:

  1. من علامة التبويب Remote Config المَعلمات أو الشروط، افتح القائمة، ثم اختَر النشر من ملف.
  2. عندما يُطلب منك ذلك، انقر على تصفّح، وانتقِل إلى ملف Remote Config الذي تريد نشره واختَره، ثم انقر على اختيار.
  3. سيتم التحقّق من صحة الملف، وفي حال نجاح العملية، يمكنك النقر على نشر لإتاحة الإعدادات على الفور لتطبيقاتك ومستخدميك.

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