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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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