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

يمكنك فرض وضع النماذج فقط في مشروع 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 API).

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

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

• إذا كانت لديك إصدارات حالية من تطبيقك لا تستخدم نماذج الطلبات المستندة إلى الخادم:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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