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


نماذج "الإعداد عن بُعد" هي مجموعات من الملفات بتنسيق 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":

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

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

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

يمكنك حذف نماذج "الإعداد عن بُعد" حسب الحاجة من سجلّ التغييرات صفحة على وحدة تحكم الإعداد عن بُعد.

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

يوضِّح هذا القسم كيفية إدارة إصدارات ميزة "الإعداد عن بُعد". القالب.

إدراج جميع الإصدارات المخزَّنة من نموذج "الإعداد عن بُعد"

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

  1. من وحدة تحكُّم Firebase، افتح ميزة "الإعداد عن بُعد".

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

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

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

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

يمكنك استرداد أي مخزن محدد من نموذج "الإعداد عن بُعد". لاسترداد نموذج مخزَّن :الإصدار:

  1. فتح جزء التفاصيل في سجلّ التغييرات:

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

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

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

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

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

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

حذف نموذج "الإعداد عن بُعد"

يمكنك حذف نماذج "الإعداد عن بُعد" من وحدة تحكُّم Firebase. إلى حذف نموذج "الإعداد عن بُعد":

1- من "الإعداد عن بُعد" المَعلمات الصفحة، انقر على سجلّ التغييرات:

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

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

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

نزِّل نماذج "الإعداد عن بُعد" وانشرها لدمجها في التحكم في المصادر وإنشاء الأنظمة، والتشغيل الآلي لتحديثات التهيئة، والاحتفاظ بالمعلمات والقيم متزامنة بين المشروعات المتعددة.

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

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

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

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

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

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

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

استخدِم ما يلي لتنزيل نموذج "الإعداد عن بُعد" النشط في تنسيق JSON:

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

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

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

نشر نموذج "الإعداد عن بُعد"

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

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

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

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

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

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