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


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

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

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

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

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

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

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

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

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

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

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

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

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

الميزات غير المتاحة بعد في نماذج الطلبات من الخادم

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

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

لا تتوفّر الإمكانات العادية التالية من Firebase AI Logic بعد من خلال نماذج الطلبات على الخادم:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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