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

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

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

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

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

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

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

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

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

• ينطبق هذا الإعداد على جميع الطلبات من خلال Firebase AI Logic إلى كلٍّ من Gemini Developer API وAgent Platform Gemini API (formerly Vertex AI).

• يؤدي هذا الإعداد إلى حظر أي طلبات من خلال 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 Console.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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