فرض وضع "النماذج فقط"

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

عند حظر طلب، سيكون الردّ هو الخطأ 403: unauthorized.

اعتبارات مهمّة

يُرجى الانتباه إلى الاعتبارات المهمة التالية عند استخدام وضع النماذج فقط.

عند فرض وضع "النماذج فقط"

عند فرض وضع النماذج فقط، يُرجى الانتباه إلى ما يلي:

• هذا الإعداد هو إعداد على مستوى المشروع في Firebase AI Logic.

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

• ينطبق هذا الإعداد على جميع الطلبات التي يتم إرسالها عبر Firebase AI Logic إلى كلّ من Gemini Developer API وVertex AI Gemini API.

• يؤدي هذا الإعداد إلى حظر أي طلبات عبر Firebase AI Logic لا تستخدم نماذج طلبات الخادم. ويشمل ذلك حظر الطلبات من تطبيقك التي تستخدم إمكانات غير متاحة بعد لنماذج الطلبات من الخادم.

• لا يؤدي هذا الإعداد إلى حظر طلبات Gemini API في مشروعك التي لا تتم عبر Firebase AI Logic.

• إذا كنت تستخدم Firebase AI Logic REST API:

  • لا يحظر هذا الإعداد طلبات الاستنتاج التي تستخدم نماذج طلبات الخادم (مثل استخدام templateGenerateContent أو templateStreamGenerateContent).
  • لا يحظر هذا الإعداد طلبات لوحة التحكّم (مثل طلبات إدارة النماذج والإعدادات).

• لا يحظر هذا الإعداد الطلبات إلى countTokens (واجهة برمجة التطبيقات Count Tokens).

قبل فرض وضع "النماذج فقط"

يُرجى الانتباه إلى ما يلي قبل فرض وضع "النماذج فقط":

• إذا كانت لديك إصدارات حالية من تطبيقك لا تستخدم نماذج الطلبات من الخادم، اتّبِع الخطوات التالية:

  • سيؤدي هذا الإعداد إلى حظر الطلبات عبر Firebase AI Logic من إصدارات التطبيق الحالية.
  • تأكَّد من تعديل جميع البرامج النشطة للعملاء لاستخدام نماذج طلبات الخادم قبل فرض وضع النماذج فقط.

• إذا كان تطبيقك يستخدم إمكانات غير متاحة بعد لنماذج طلبات الموافقة من جهة الخادم:

  • سيؤدي هذا الإعداد إلى حظر الطلبات عبر Firebase AI Logic لهذه الإمكانات غير المتاحة بعد لأنّها لا تستخدم (ولا يمكنها استخدام) نماذج الطلبات على الخادم.
  • تأكَّد من أنّ تطبيقك (بما في ذلك أي إصدار سابق) لا يستخدم بشكل نشط أيًا من الإمكانات غير المتوافقة قبل فرض وضع النماذج فقط.

إدارة إعداد وضع النموذج فقط

يمكنك إدارة إعداد وضع النماذج فقط في وحدة تحكّم Firebase.

الأذونات والأدوار المطلوبة في "إدارة الهوية وإمكانية الوصول"

تتطلّب إدارة إعداد وضع النماذج فقط الحصول على إذن firebasevertexai.configs.update، والذي يتم تضمينه تلقائيًا في أدوار IAM التالية: المالك والمحرِّر ومشرف Firebase ومشرف Firebase AI Logic.

فرض وضع "النماذج فقط"

في ما يلي كيفية فرض وضع النموذج فقط لمشروع Firebase:

1. إذا لم يسبق لك ذلك، راجِع الاعتبارات المهمة لوضع النماذج فقط الواردة في وقت سابق من هذا الدليل.

2. في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب خدمات الذكاء الاصطناعي > منطق الذكاء الاصطناعي > الإعدادات.

3. ضمن وضع النموذج، حرِّك مفتاح التبديل فرض وضع النموذج فقط إلى مفروض.

4. راجِع مربّع حوار التأكيد، ثم انقر على تأكيد.

إيقاف فرض وضع "النماذج فقط"

في حال أوقفت فرض "وضع النموذج فقط"، يُرجى الانتباه إلى ما يلي:

• سيتم السماح بالطلبات التي يتم إرسالها عبر Firebase AI Logic والتي لا تستخدم نماذج طلبات الخادم.
• هذا إعداد على مستوى المشروع لـ Firebase AI Logic.

في ما يلي كيفية إيقاف فرض وضع النموذج فقط لمشروعك على Firebase:

1. في وحدة تحكّم Firebase، انتقِل إلى علامة التبويب خدمات الذكاء الاصطناعي > منطق الذكاء الاصطناعي > الإعدادات.

2. ضمن وضع النموذج، أوقِف فرض وضع النموذج فقط.

3. راجِع مربّع حوار التأكيد، ثم انقر على تأكيد.