شما میتوانید حالت فقط قالب را برای پروژه Firebase خود اعمال کنید تا تمام درخواستهای API Gemini از طریق Firebase AI Logic باید از قالبهای اعلان سرور استفاده کنند.
وقتی یک درخواست مسدود میشود، پاسخ یک خطای 403: unauthorized خواهد بود.
ملاحظات مهم
از ملاحظات مهم زیر برای حالت فقط قالب آگاه باشید.
وقتی حالت فقط قالب اعمال میشود
وقتی حالت فقط قالب اعمال میشود، به موارد زیر توجه داشته باشید:
این تنظیم، یک تنظیم در سطح پروژه برای Firebase AI Logic است.
- این برای همه برنامههای ثبتشده در پروژه اعمال میشود.
- این فقط در مورد پروژهای که در آن اجرا میشود، اعمال میشود.
این تنظیم برای همه درخواستها از طریق Firebase AI Logic به هر دو API توسعهدهنده Gemini و API Vertex AI Gemini اعمال میشود.
این تنظیم، هرگونه درخواست از طریق Firebase AI Logic که از قالبهای اعلان سرور استفاده نمیکنند را مسدود میکند . این شامل مسدود کردن درخواستهایی از برنامه شما میشود که از قابلیتهای پشتیبانی نشده برای قالبهای اعلان سرور استفاده میکنند.
این تنظیم، درخواستهای API مربوط به Gemini در پروژه شما که از طریق Firebase AI Logic ارسال نمیشوند را مسدود نمیکند .
اگر از Firebase AI Logic REST API استفاده میکنید:
- این تنظیم، درخواستهای استنتاجی که از الگوهای اعلان سرور استفاده میکنند (مانند استفاده از
templateGenerateContentیاtemplateStreamGenerateContent) را مسدود نمیکند . - این تنظیم درخواستهای صفحه کنترل (مانند درخواستهای مربوط به مدیریت قالبها و پیکربندیها) را مسدود نمیکند .
- این تنظیم، درخواستهای استنتاجی که از الگوهای اعلان سرور استفاده میکنند (مانند استفاده از
این تنظیم، درخواستهای ارسالی به
countTokens(رابط برنامهنویسی کاربردی Count Tokens) را مسدود نمیکند .
قبل از اعمال حالت فقط قالب
قبل از اعمال حالت فقط قالب، از موارد زیر آگاه باشید:
اگر نسخههای موجود برنامه شما از الگوهای اعلان سرور استفاده نمیکنند :
- این تنظیم، درخواستهای ارسالی از طریق Firebase AI Logic را از نسخههای موجود برنامه مسدود میکند.
- قبل از اعمال حالت فقط قالب، مطمئن شوید که همه کلاینتهای فعال برای استفاده از قالبهای اعلان سرور بهروزرسانی شدهاند.
اگر برنامه شما از قابلیتهایی برای قالبهای اعلان سرور استفاده میکند که هنوز پشتیبانی نمیشوند :
- این تنظیم، درخواستهای Firebase AI Logic را برای این قابلیتهای پشتیبانینشده مسدود میکند، زیرا آنها از قالبهای اعلان سرور استفاده نمیکنند (و نمیتوانند) .
- قبل از اعمال حالت فقط قالب، مطمئن شوید که برنامه شما (از جمله نسخههای قبلی) به طور فعال از هیچ یک از آن قابلیتهای پشتیبانی نشده استفاده نمیکند.
مدیریت تنظیمات حالت فقط قالب
شما تنظیمات مربوط به حالت فقط قالب را در کنسول Firebase مدیریت میکنید.
مجوزها و نقشهای مورد نیاز IAM
مدیریت تنظیمات حالت فقط قالب نیاز به مجوز firebasevertexai.configs.update دارد که به طور پیشفرض در این نقشهای IAM وجود دارد: مالک، ویرایشگر، مدیر Firebase و مدیر منطق هوش مصنوعی Firebase.
حالت فقط قالب را اعمال کنید
در اینجا نحوه اعمال حالت فقط قالب برای پروژه Firebase شما آورده شده است:
اگر هنوز این کار را نکردهاید، ملاحظات مهم مربوط به حالت فقط قالب را در ابتدای این راهنما مرور کنید.
در کنسول Firebase ، به برگه خدمات هوش مصنوعی > منطق هوش مصنوعی > تنظیمات بروید.
در قسمت حالت الگو (Template mode )، گزینهی «اجرای فقط الگو» (Enforced) را روی «اجرا شده» (Enforced) قرار دهید.
کادر محاورهای تأیید را مرور کنید و سپس روی تأیید کلیک کنید.
توقف اجرای حالت فقط قالبی
اگر اجرای حالت فقط قالب را متوقف کردید، از موارد زیر آگاه باشید:
- درخواستهایی که از طریق Firebase AI Logic و بدون استفاده از الگوهای اعلان سرور ارسال شوند، مجاز خواهند بود.
- این یک تنظیم در سطح پروژه برای Firebase AI Logic است.
در اینجا نحوه متوقف کردن اجرای حالت فقط قالب برای پروژه Firebase شما آورده شده است:
در کنسول Firebase ، به برگه خدمات هوش مصنوعی > منطق هوش مصنوعی > تنظیمات بروید.
در قسمت حالت الگو (Template mode )، حالت اجرای فقط الگو (Enforce template-only mode) را غیرفعال کنید.
کادر محاورهای تأیید را مرور کنید و سپس روی تأیید کلیک کنید.