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