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

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

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

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

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

• يمكنك إنشاء معرّفات نماذج يتم إلحاقها بإصدار يستخدم نظام الترقيم الدلالي (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 (التي يمكن تقديمها كمتغيّرات إدخال).