إدارة نماذج خادم الإعداد عن بُعد وإصداراته

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


نماذج Remote Config هي مجموعات من المَعلمات والشروط بتنسيق JSON تم إنشاؤها لمشروع Firebase. توفّر نماذج الخادم الإعدادات لمثيلات الخادم باستخدام Firebase Admin SDK لـ Remote Config (متاحة لـ Node.js وJava وPython وGo).

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

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

{
  "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-3.8-flash"
      },
      "valueType": "STRING"
    },
    "generation_config": {
      "defaultValue": {
        "value": "{\"maxOutputTokens\": 2048}"
      },
      "valueType": "JSON"
    }
  },
  "version": {
    "versionNumber": "19",
    "isLegacy": true
  }
}

يمكنك تنفيذ مهام إدارة الإصدارات هذه في وحدة تحكّم Firebase (انتقِل إلى DevOps والتفاعل > الإعداد عن بُعد):

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

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

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

يمكنك حذف نماذج Remote Config حسب الحاجة في DevOps & Engagement > الإعداد عن بُعد > صفحة سجلّ التغييرات في وحدة تحكّم Firebase.

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

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

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

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

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps & Engagement > الإعداد عن بُعد > المَعلمات.

  2. انقر على رمز "الساعة" في أعلى يسار الصفحة.

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

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

استرداد إصدار محدّد من نموذج "Remote Config"

يمكنك استرداد أي نسخة مخزّنة محدّدة من نموذج Remote Config. في ما يلي كيفية استرداد نسخة من نموذج مخزَّن:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps والتفاعل > الإعداد عن بُعد > سجلّ التغييرات.

  2. تعرض الصفحة تلقائيًا النموذج النشط الحالي. لعرض نسخة مختلفة، اختَرها من جزء التفاصيل على يسار الصفحة.

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

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

يمكنك العودة إلى أي إصدار مخزَّن من النموذج. في ما يلي كيفية العودة إلى إصدار سابق من النموذج:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps والتفاعل > الإعداد عن بُعد > سجلّ التغييرات.

  2. ابحث عن زر الخيار في أعلى يسار الصفحة لإصدارات النماذج السابقة المؤهلة للتراجع.

  3. يُرجى النقر على هذا الخيار وتأكيده فقط إذا كنت متأكدًا من رغبتك في العودة إلى هذا الإصدار واستخدام هذه القيم على الفور لجميع التطبيقات والمستخدمين.

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

حذف نموذج Remote Config

يمكنك حذف نماذج "Remote Config" باستخدام وحدة تحكّم "Firebase". إليك كيفية حذف نموذج:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps & Engagement > الإعداد عن بُعد > المَعلمات.

  2. انقر على سجلّ التغييرات.

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

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

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

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

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

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

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

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

لتصدير نماذج Remote Config واستيرادها:

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

تنزيل نموذج "Remote Config" الحالي

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

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps & Engagement > الإعداد عن بُعد > المَعلمات أو الشروط.

  2. افتح القائمة، واختَر تنزيل ملف الإعدادات الحالي.

  3. عندما يُطلب منك ذلك، انقر على تنزيل ملف الإعداد، واختَر المكان الذي تريد حفظ الملف فيه، ثم انقر على حفظ.

التحقّق من صحة نموذج "Remote Config"

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

نشر نموذج "Remote Config"

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

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

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

اتّبِع الخطوات التالية لنشر النموذج:

  1. في وحدة تحكّم Firebase، انتقِل إلى صفحة DevOps & Engagement > الإعداد عن بُعد > المَعلمات أو الشروط.

  2. افتح القائمة، وانقر على النشر من ملف.

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

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

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