وقتی آماده راه‌اندازی برنامه‌تان هستید و کاربران نهایی واقعی با ویژگی‌های هوش مصنوعی برنامه‌تان تعامل می‌کنند، حتماً این فهرست وارسی از رویه‌های مطلوب و ملاحظات مهم را مرور کنید.
عمومی
بازبینه راه‌اندازی عمومی را مرور کنید
پیش‌از راه‌اندازی هر برنامه Firebase در محیط تولید، بازبینی فهرست وارسی راه‌اندازی Firebase را برای روال‌های مطلوب مهم مرور کنید.
پیروی از روال‌های مطلوب برای پروژه‌های Firebase
از پروژه‌های Firebase جداگانه برای توسعه، آزمایش، و تولید استفاده کنید. روال‌های مطلوب بیشتری را برای مدیریت پروژه‌هایتان مرور کنید.
دسترسی و امنیت
مرور کردن بازبینه‌های امنیتی
بازبینه امنیت Firebase و بازبینه امنیت اختصاصی برای Firebase AI Logic را برای روال‌های مطلوب مهم دسترسی و امنیت مرور کنید.
اجرا کردن Firebase App Check
Firebase App Check را برای کمک به محافظت از Gemini API دربرابر سوءاستفاده وقتی مستقیماً از برنامه شما فراخوانده می‌شود اعمال کنید. وقتی App Check اعمال می‌شود، بررسی می‌کند که درخواست‌های ورودی از برنامه اصیل شما و/یا دستگاه دستکاری‌نشده نشئت گرفته باشند.
App Check از ارائه‌دهندگان گواهی برای پلاتفرم‌های Apple (DeviceCheck، App Attest، یا reCAPTCHA Enterprise)، Android (Play Integrity یا reCAPTCHA Enterprise)، و وب (reCAPTCHA Enterprise) پشتیبانی می‌کند. این سرویس از همه این ارائه‌دهندگان برای برنامه‌های Flutter و Unity نیز پشتیبانی می‌کند.
همچنین، اجرای محافظت دربرابر بازپخش را درنظر بگیرید، که به این معنی است که نشان‌ها فقط یک‌بار قابل استفاده‌اند. این گزینه محافظت بهبودیافته‌ای فراتر از محافظت پایه ارائه می‌دهد و به شما امکان می‌دهد سطح محافظت مناسبی برای برنامه و موارد استفاده‌تان تنظیم کنید.
تنظیم محدودیت برای کلیدهای Firebase API
کلیدهای Firebase API پروژه و برنامه Firebase شما را هنگام درخواست دادن شناسایی می‌کنند. برای جلوگیری از استفاده غیرمجاز از کلیدهای API خود:
در کنسول Google Cloud، «محدودیت‌های برنامه» را تنظیم کنید تا استفاده از کلید را فقط به درخواست‌های شناسه بسته خاص برنامه (Apple)، نام بسته و اثر انگشت SHA-1 (Android)، یا ارجاع‌دهنده HTTP (وب) محدود کنید.
«محدودیت‌های API» فهرست مجاز هر کلید را بررسی کنید:
- مطمئن شوید که
میانای برنامه‌سازی کاربردی Firebase AI Logic (
firebasevertexai.googleapis.com) در فهرست مجاز قرار دارد. - مطمئن شوید که تنها میاناهای برنامه‌سازی کاربردی دیگر در فهرست مجازها، سرویس‌های خاص Firebase موردنیاز برنامه‌تان باشند. فهرست میاناهای برنامه‌سازی کاربردی موردنیاز برای کلیدهای Firebase محدودشده را ببینید.
- مطمئن شوید که
میانای برنامه‌سازی کاربردی Firebase AI Logic (
توجه داشته باشید که میاناهای برنامه‌سازی کاربردی مربوط به Firebase فقط از کلیدهای میانای برنامه‌سازی کاربردی برای شناسایی پروژه یا برنامه Firebase استفاده می‌کنند، نه برای مجاز کردن فراخوانی میانای برنامه‌سازی کاربردی.
محدود کردن درخواست‌ها به کاربران اصیل
اجرای حالت کاربران اصالت‌سنجی‌شده را درنظر بگیرید تا همه درخواست‌های ارسالی ازطریق Firebase AI Logic باید شامل اطلاعات اعتباری معتبر از Firebase Authentication باشد. اگر درخواستی از کاربر نهایی غیرتأییدشده‌ای ارسال شود، درخواست با خطای 401: unauthenticated رد می‌شود.
نظارت، محدودیت‌ها، و صورت‌حساب
راه‌اندازی پایش هوش مصنوعی در کنسول Firebase
در کنسول Firebase، پایش هوش مصنوعی راه‌اندازی کنید تا دید بهتری درباره سنجه‌های عملکرد کلیدی، مثل تعداد درخواست‌ها، تأخیر، استفاده از نشان، و نرخ خطا به‌دست آورید. همچنین می‌توانید ردپاهای تکی را در Google Cloud کنسول بازرسی کنید.
تنظیم کردن محدودیت‌های نرخ و مدیریت سهمیه‌ها
از پروژه خود دربرابر افزایش‌های ناگهانی استفاده و حمله‌های منع سرویس کیف پول محافظت کنید:
- برای جلوگیری از مصرف سهمیه بیش‌ازحد توسط نمونه‌های مشتری فردی، حدود نرخ را برای هر کاربر تنظیم کنید (پیش‌فرض ۱۰۰ دور در دقیقه است).
- بررسی و مدیریت سهمیه پروژه در کنسول Google Cloud برای هر API زیربنایی.
با هشدارها و سقف‌های هزینه از صورت‌حساب‌های غیرمنتظره جلوگیری کنید
اگر پروژه Firebase شما در طرح قیمت‌گذاری Blaze پرداخت به اندازه استفاده باشد:
هشدارهای بودجه و سقف‌های هزینه راه‌اندازی کنید.
مدیریت پیکربندی‌ها
از نسخه مدل پایدار در برنامه تولیدتان استفاده کنید
در برنامه تولید خود، فقط از
نسخه‌های مدل پایدار (مانند
gemini-3.8-flash) استفاده کنید. از نسخه پیش‌نمایش یا
آزمایشی یا نام مستعار -latest
از Firebase Remote Config یا الگوهای پیام‌واره سرور استفاده کنید
وقتی از Remote Config یا الگوهای پیام‌واره سرور استفاده می‌کنید، می‌توانید پیکربندی‌های مهم ویژگی‌های هوش مصنوعی برنامه‌تان را در فضای ابری (سمت سرور) کنترل کنید به‌جای اینکه مقادیر را در کدتان کدبندی سخت کنید. این یعنی می‌توانید پیکربندی‌هایتان را بدون انتشار نسخه جدید برنامه به‌روز کنید.
(به‌شدت توصیه می‌شود) با انتشار مدل‌های جدید یا توقف مدل‌های دیگر، تغییرات درخواستی را در نام مدل مورداستفاده برای ویژگی هوش مصنوعی خود اعمال کنید. جزئیات استفاده از Remote Config یا الگوهای پیام‌واره سرور را ببینید.
(اختیاری) به‌صورت پویا و حتی مشروط، پارامترهای دیگر ویژگی هوش مصنوعی خود را کنترل کنید، برای مثال پیکربندی مدل (مانند حداکثر نشانه‌های برونداد)، تنظیمات ایمنی، دستورالعمل‌های سیستم، و داده‌های پیام‌واره. جزئیات استفاده از Remote Config یا الگوهای پیام‌واره سرور را ببینید.
(اختیاری) پارامتر
minimum_versionرا در Remote Config تنظیم کنید تا نسخه فعلی برنامه با جدیدترین نسخه تعریف‌شده در Remote Config مقایسه شود و درنتیجه یا اعلان ارتقا به کاربران نشان داده شود یا کاربران مجبور شوند ارتقا دهند.
مکان دسترسی به مدل را تنظیم کنید
| فقط هنگام استفاده از Agent Platform Gemini API (formerly Vertex AI) به‌عنوان ارائه‌دهنده میانای برنامه‌سازی کاربردی دردسترس است. |
برای کمک به بهینه‌سازی سهمیه و جلوگیری از تأخیر برای کاربران، مکانی برای دسترسی به مدل تنظیم کنید.
اگر مکان را مشخص نکنید، مکان پیش‌فرض global است (هنگام استفاده از نحو اولیه «پلاتفرم نماینده» جدید). می‌توانید این مکان را درطول
راه‌اندازی اولیه تنظیم کنید، یا به‌صورت اختیاری
از Firebase Remote Config برای تغییر پویای مکان براساس مکان هر کاربر استفاده کنید.