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


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

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