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

يمكنك فرض وضع النماذج فقط على مشروع 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 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. راجِع مربّع حوار التأكيد، ثم انقر على تأكيد.