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


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

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

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

إصدار النماذج

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

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

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

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

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

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