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