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


نماذج 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 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. سيتم التحقّق من الملف، وإذا كان صالحًا، يمكنك النقر على نشر لإتاحة الإعدادات على الفور لتطبيقاتك والمستخدمين.

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