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


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

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

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

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

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

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

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

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

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

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

الميزات غير المتاحة بعد

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

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

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

  • دردشة
  • استخدام الأدوات (بما في ذلك استدعاء الدوال وتحديد المصدر باستخدام "بحث Google")
  • تعديل الصور بشكل متكرّر (محادثة) باستخدام نماذج Gemini (يتطلّب محادثة)
  • تعديل الصور باستخدام نماذج Imagen
  • البث الثنائي الاتجاه (Gemini Live API)
  • Hybrid on-device
  • تقييد الناتج بقائمة من القيم الثابتة
  • ضبط الإعدادات المتعلّقة بالتفكير
  • ضبط إعدادات الأمان

يُرجى أيضًا العِلم أنّه في حال استخدام ميزة المراقبة المستندة إلى الذكاء الاصطناعي في وحدة تحكّم 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 (التي يمكن تقديمها كمتغيّرات إدخال).