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


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

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

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

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

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

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

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

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

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

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

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

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

إمكانات 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 (التي يمكن تقديمها كمتغيرات إدخال).