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

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

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

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

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

• يمكنك إنشاء معرّفات نماذج يتم إلحاقها بإصدار يستخدم نظام تحديد الإصدارات الدلالي (semver).

• يمكنك استخدام Firebase Remote Config لتغيير النموذج والقيم الأخرى في طلبك بسهولة.

حماية نموذجك

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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