أفضل الممارسات والاعتبارات المتعلّقة بالنماذج


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

أفضل الممارسات

يتم أيضًا تفصيل العديد من أفضل الممارسات هذه في مقالة إدارة النماذج.

تحديد إصدارات نماذجك

حماية نموذجك

  • تجنَّب تعديل النماذج المستخدَمة في مرحلة الإنتاج ما لم تكن قد اختبرت التغيير بدقة.

  • يمكنك قفل نموذجك قبل الانتقال إلى مرحلة الإنتاج.

    • يعمل قفل النموذج كحماية من التعديل غير المقصود، ولكن يمنع القفل التعديل تمامًا. يمكن لأحد أعضاء المشروع الحاصل على الأذونات المناسبة إلغاء قفل النموذج لتعديله في أي وقت.

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

حماية استخدام Gemini API

الميزات التي لا تتيحها بعد نماذج طلبات الخادم

يُرجى العِلم أنّ العديد من هذه الميزات ستتوفّر مع تطوّر نماذج طلبات الخادم، لذا يُرجى الاطّلاع على ملاحظات الإصدار للاطّلاع على التحديثات.

إمكانات Firebase AI Logic التي لا تتيحها بعد النماذج

لا تتيح نماذج طلبات الخادم بعد الإمكانات العادية التالية من Firebase AI Logic:

  • البث ثنائي الاتجاه (Gemini Live API)
  • الاستدلال المختلط أو على الجهاز
  • حصر الناتج في قائمة من القيم الثابتة

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

العناصر الشائعة في Dotprompt التي لا تتيحها بعد النماذج

من المحتمل أن تتيح قريبًا نماذج طلبات الخادم العناصر الشائعة التالية في Dotprompt:

  • استخدام مواصفات مخطط JSON لمخططات الإدخال والإخراج في المقدمة

    • يُرجى العِلم أنّ هذه المواصفات غير متاحة أيضًا في طلبات النماذج غير المستندة إلى الخادم. لا نتيح حاليًا سوى مواصفات مخطط OpenAPI.

  • الإعلان عن تعريف حقل حرف بدل باستخدام *

  • استخدام @key أو التكرار بشكل عام على حقول إدخال كائن (وهو ما يحدث عندما يكون @key مناسبًا)

  • استخدام @root، ما يتيح لك الإشارة إلى سياق المتغيّر الجذر بغض النظر عن this الحالي

من المحتمل ألا تتيح نماذج طلبات الخادم العناصر الشائعة التالية في Dotprompt:

  • استخدام الأجزاء، وهي مقتطفات نماذج قابلة لإعادة الاستخدام يمكن تضمينها في نماذج أخرى

اعتبارات أخرى