می‌توانید حالت فقط الگو را برای پروژه 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(میانای برنامه‌سازی کاربردی شمارش نشانه‌ها) را مسدود نمی‌کند.
قبل‌از اعمال حالت فقط الگو
قبل‌از اینکه حالت فقط الگو را اعمال کنید، از موارد زیر آگاه باشید:
اگر نسخه‌های موجود برنامه‌تان از الگوهای پیام‌واره سرور استفاده نمی‌کنند:
- این تنظیم درخواست‌های ارسالی ازطریق Firebase AI Logic از آن نسخه‌های برنامه موجود را مسدود خواهد کرد.
- مطمئن شوید که همه مشتریان فعال به‌روز شده باشند تا بتوانند از الگوهای پیام‌واره سرور قبل‌از اجرای حالت فقط الگو استفاده کنند.
اگر برنامه شما از قابلیت‌های پشتیبانی‌نشده برای الگوهای پیام‌واره سرور استفاده می‌کند:
- این تنظیم درخواست‌های ارسالی ازطریق Firebase AI Logic را برای این قابلیت‌های هنوز پشتیبانی‌نشده مسدود می‌کند زیرا از الگوهای پیام‌واره سرور استفاده نمی‌کنند (و نمی‌توانند استفاده کنند).
- مطمئن شوید که برنامه شما (ازجمله هر نسخه قبلی) قبل‌از اعمال حالت فقط الگو، به‌طور فعال از هیچ‌یک از قابلیت‌های هنوز پشتیبانی‌نشده استفاده نمی‌کند.
مدیریت تنظیم حالت فقط الگو
تنظیم حالت فقط الگو را در کنسول Firebase مدیریت می‌کنید.
نقش‌ها و اجازه‌های IAM موردنیاز
مدیریت تنظیم حالت فقط الگو به اجازه
firebasevertexai.configs.update نیاز دارد که به‌طور پیش‌فرض در این نقش‌های IAM وجود دارد:
«مالک»، «ویرایشگر»، «سرپرست Firebase»، و «سرپرست Firebase AI Logic».
اجرای حالت فقط الگو
در اینجا نحوه اعمال حالت فقط الگو برای پروژه Firebase شما آمده است:
اگر قبلاً این کار را نکرده‌اید، ملاحظات مهم برای حالت فقط الگو را در ابتدای این راهنما مرور کنید.
در کنسول Firebase، به خدمات هوش مصنوعی > منطق هوش مصنوعی > زبانه تنظیمات بروید.
در بخش حالت الگو، کلید اجرای حالت فقط الگو را به حالت اجرایی بکشید.
کادر گفتگوی تأیید را مرور کنید و سپس روی تأیید کلیک کنید.
توقف اجرای حالت فقط الگو
اگر اجرای حالت فقط الگو را متوقف کنید، به موارد زیر توجه کنید:
- درخواست‌های ارسالی ازطریق Firebase AI Logic که از الگوهای پیام‌واره سرور استفاده نمی‌کنند مجاز خواهند بود.
- این تنظیم در سطح پروژه برای Firebase AI Logic است.
در اینجا نحوه توقف اجرای حالت فقط الگو برای پروژه Firebase شما آمده است:
در کنسول Firebase، به خدمات هوش مصنوعی > منطق هوش مصنوعی > زبانه تنظیمات بروید.
در بخش حالت الگو، گزینه اجرای حالت فقط الگو را خاموش کنید.
کادر گفتگوی تأیید را مرور کنید و سپس روی تأیید کلیک کنید.