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


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

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

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

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

حماية النموذج

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

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

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

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

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

  • اكتب عمليات تحقّق قوية من صحة الإدخال لمتغيّرات الإدخال، ما يساعد في ما يلي:

    • يمكن أن تساعد في الحماية من هجمات حقن الطلبات.
    • يمكن أن يساعد ذلك في ضمان نجاح الطلبات والحصول على الردود المتوقّعة.

  • فرض وضع النماذج فقط لمشروع Firebase لكي تستخدم جميع طلبات Gemini API عبر Firebase AI Logic نموذجًا لطلب من الخادم.

الميزات التي لا تتوافق بعد مع نماذج الطلبات من الخادم

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

إمكانات Firebase AI Logic غير متاحة بعد في النماذج

لا تتوفّر الإمكانات العادية التالية من Firebase AI Logic بعد من خلال نماذج الطلبات على الخادم:

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

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

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

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

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

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

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

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

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

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

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

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

  • عند استخدام واجهة المستخدم الإرشادية في وحدة تحكّم Firebase، نوفّر النموذج تلقائيًا في جميع المناطق المتاحة لـ Firebase AI Logic. إذا كنت تستخدم Vertex AI Gemini API وكانت حالة الاستخدام تتطلّب قيودًا مستندة إلى الموقع الجغرافي، يمكنك تحديد الموقع الجغرافي للنموذج باستخدام REST API.

  • إذا أردت تقديم نموذج طلب من الخادم كملف (بدلاً من استخدام واجهة المستخدم الموجّهة في وحدة تحكّم Firebase)، يمكنك استخدام REST API. يُرجى العِلم أنّ نماذج طلبات الخادم لا تتوافق مع المخطط المحدّد في الرمز البرمجي للتطبيق والذي يتم تمريره إلى النموذج.

  • على الرغم من أنّ النموذج متوفّر على الخادم، لا يمكنه التفاعل مباشرةً مع موارد الخادم الأخرى في مشروع Firebase (مثل قاعدة البيانات) باستثناء عناوين URL الخاصة بـ Cloud Storage for Firebase (التي يمكن تقديمها كمتغيّرات إدخال).