حالت ساخت (Build mode) در Google AI Studio میتواند به طور خودکار Cloud Firestore و Firebase Authentication در برنامههای وب راهاندازی و ادغام کند، که ساخت برنامههایی با ذخیرهسازی دادههای پایدار و جریانهای ورود امن را آسانتر میکند. تنها با یک درخواست و چند کلیک، شما به عامل Google AI Studio این امکان را میدهید که یک پروژه Firebase راهاندازی کند، برنامه شما را به آن پروژه متصل کند و تمام کدهای Cloud Firestore و Authentication را مستقیماً در برنامه شما تولید کند.
مرور کلی: یک بکاند به برنامه Google AI Studio خود اضافه کنید
ایده خود را شرح دهید : یک برنامه جدید در Google AI Studio ایجاد کنید و یک ویژگی را که نیاز به پایگاه داده یا احراز هویت دارد شرح دهید. برای مثال، میتوانید عبارت زیر را وارد کنید:
Build a shared to-do list app using Firebase as a backend.فعال کردن ادغام Firebase : در کارتی که ظاهر میشود، تنظیمات خود را پیکربندی کنید:
- سفارشیسازی پروژه یا مکان (اختیاری) : آیکون تنظیمات کلیک کنید، سپس مکان یا پروژه Google Cloud مورد نظر خود را انتخاب کنید.
- انتخاب خود را تأیید کنید : برای ادامه، روی دکمهی فعالسازی فایربیس کلیک کنید.
سپس عامل به طور خودکار برنامه شما را به پروژه Firebase شما متصل میکند و کد Cloud Firestore و Authentication لازم، شامل یک فایل
/src/lib/firebase.tsو یک فایلfirestore.rulesتولید میکند.استقرار : پس از آماده شدن، از گزینه اشتراکگذاری > انتشار برای استقرار برنامه وب خود در Cloud Run استفاده کنید. برنامه شما به طور خودکار در همان پروژهای که هنگام راهاندازی انتخاب کردهاید، مستقر خواهد شد.
قبل از اشتراکگذاری یا استقرار برنامه خود، حتماً Firebase Security Rules که توسط هوش مصنوعی ایجاد شدهاند را نیز بررسی کنید .
اضافه کردن فایربیس به یک برنامه در حین توسعه
اگر میخواهید یکپارچهسازی Firebase را به برنامهای که در Google AI Studio روی آن کار میکنید اضافه کنید، میتوانید این کار را در هر زمانی در طول مرحله تکرار با استفاده از یکی از گزینههای زیر انجام دهید:
- صحبت با نماینده : به نماینده دستور دهید ویژگیای را که نیاز به پایگاه داده یا احراز هویت دارد اضافه کند (برای مثال،
Add a Firestore database to this app). - از منوی تنظیمات استفاده کنید : به تنظیمات > ادغامها بروید و روی کاشی Firebase Firestore & Auth کلیک کنید.
هر دو گزینه، جریان تنظیمات یکپارچهسازی Firebase را راهاندازی میکنند و به شما امکان میدهند یک پروژه را انتخاب کنید، مکان backend خود را پیکربندی کنید و یکپارچهسازی را برای برنامه خود، همانطور که در نمای کلی توضیح داده شده است، فعال کنید.
پس از فعال شدن یکپارچهسازی، میتوانید پیکربندی آن - شامل پروژه، مکان، ایمیل پشتیبانی برنامه و شناسه پایگاه داده - را در هر زمان با رفتن به تنظیمات > یکپارچهسازیها و کلیک روی کاشی Firebase Firestore & Auth بررسی کنید.
سهمیه مشترک برای Cloud Firestore را درک کنید
بسته به زمان ایجاد برنامه و واجد شرایط بودن حساب کاربری شما، پایگاههای داده شما ممکن است در یک پروژه Google Cloud Starter Tier یا یک پروژه استاندارد میزبانی شوند. با این حال، در هر دو مورد، تمام پایگاههای داده Cloud Firestore که توسط عامل Google AI Studio ارائه میشوند، در همان گروه پایگاههای داده "سهمیه مشترک هوش مصنوعی" در پروژه شما قرار میگیرند. همه آنها این ویژگیها را دارند:
- سهمیه مشترک : همه پایگاههای داده در گروه، سهمیه استفاده مشترکی دارند ( جزئیات بیشتر را در زیر ببینید ).
- بدون نیاز به حساب Cloud Billing : میتوانید برنامه خود را بدون اضافه کردن پرداخت بسازید و آزمایش کنید. جزئیات مربوط به اضافه کردن اختیاری پرداخت را در زیر مشاهده کنید.
- بازنشانیهای روزانه : اگر به محدودیت سهمیه روزانه (مثلاً ۵۰ هزار خواندن در روز) برسید، سرویس برای تمام پایگاههای داده درون گروه متوقف میشود و روز بعد حدود نیمهشب به وقت اقیانوس آرام از سر گرفته میشود.
| متریک | سهمیه |
|---|---|
| دادههای ذخیره شده | مجموع ۱ گیگابایت |
| خروجی شبکه | ۱۰ گیگابایت در ماه |
| واحدها را بنویسید | ۴۰،۰۰۰ نوشته در روز |
| واحدها را بخوانید | ۵۰،۰۰۰ بازدید در روز |
| واحدهای بهروزرسانی بلادرنگ | ۵۰،۰۰۰ بهروزرسانی در روز |
(اختیاری) برای دریافت سهمیه بیشتر Cloud Firestore صورتحساب را اضافه کنید
اگر برنامه شما مورد توجه قرار گرفت و نیاز داشتید که از محدودیتهای رایگان Cloud Firestore فراتر بروید، میتوانید صورتحسابی را اضافه کنید که پروژه Firebase شما را به طرح قیمتگذاری Pay-as-you-go Blaze ارتقا میدهد.
ممکن است به دلایل مختلف، مانند استفاده از Nano Banana، قبلاً برای پروژه خود صورتحساب اضافه کرده باشید. در این صورت، پروژه شما از قبل در طرح قیمتگذاری Blaze قرار دارد و میتوانید مستقیماً به مرحله ارتقاء پایگاه داده بروید.
مرحله ۱. اضافه کردن صورتحساب (اگر قبلاً این کار را نکردهاید)
شما میتوانید مستقیماً در Google AI Studio صورتحساب تنظیم کنید.
- در Google AI Studio ، به صفحه پروژهها بروید.
- روی تنظیم صورتحساب در کنار پروژهای که میخواهید ارتقا دهید کلیک کنید.
- برای انتخاب کشور، موافقت با شرایط و اضافه کردن روش پرداخت یا انتخاب یک حساب صورتحساب موجود، دستورالعملهای روی صفحه را دنبال کنید. همچنین ممکن است از شما پیشپرداخت درخواست شود (که شامل استفاده از سرویسهای Firebase و Google Cloud نمیشود ).
مرحله ۲: ارتقاء پایگاه داده
حتی پس از افزودن صورتحساب، پایگاههای داده Cloud Firestore که توسط عامل Google AI Studio ایجاد شدهاند، در گروه سهمیه مشترک باقی میمانند. برای فعال کردن مقیاسپذیری کامل پولی برای یک پایگاه داده خاص، باید آن را به صورت دستی ارتقا دهید.
- به کنسول Firebase بروید و پروژهای که حاوی پایگاه دادهای است که میخواهید ارتقا دهید را انتخاب کنید.
- از پنل ناوبری سمت چپ، به Databases & Storage > Firestore بروید.
- اگر پروژه شما شامل چندین نمونه پایگاه داده Cloud Firestore است، موردی را که میخواهید ارتقا دهید انتخاب کنید.
- به دنبال بنری در نزدیکی بالای صفحه باشید که نشان میدهد پایگاه داده مشمول محدودیتهای سهمیه اشتراکی هوش مصنوعی است. برای ارتقاء آن، روی ارتقاء پایگاه داده > ارتقاء به پرداخت در حین استفاده کلیک کنید. اگر این بنر را نمیبینید، پایگاه داده یا توسط نماینده Google AI Studio ایجاد نشده و بخشی از گروه سهمیه اشتراکی نیست، یا قبلاً ارتقا یافته است.
تغییر برای غیرفعال کردن سهمیه اشتراکی و فعال کردن پرداخت در حین استفاده برای پایگاه داده شما باید ظرف چند دقیقه اعمال شود.
تولید Security Rules
عامل Google AI Studio به طور خودکار Firebase Security Rules بر اساس منطق برنامه شما تولید میکند. این Security Rules به گونهای طراحی شدهاند که "به طور پیشفرض قابل رد کردن" باشند، به این معنی که کاربران نهایی برنامه شما فقط میتوانند به دادههایی که متعلق به خودشان است دسترسی داشته باشند.
توجه داشته باشید که اگر Security Rules خود را مستقیماً در کنسول Firebase به صورت دستی تنظیم کنید، عامل Google AI Studio از تغییرات مطلع نخواهد شد و در طول تکرارهای بعدی برنامه بازنویسی میشوند. توصیه میکنیم از عامل Google AI Studio برای تنظیم Firebase Security Rules خود استفاده کنید تا مطمئن شوید که تغییرات شما حفظ شده و با منطق برنامه شما همسو هستند.
استفاده از یک پروژه موجود
وقتی برای اولین بار ادغام Firebase را فعال میکنید، میتوانید به صورت اختیاری یک پروژه Google Cloud موجود که متعلق به شماست را انتخاب کنید:
- در کارتی که ظاهر میشود، روی تنظیمات کلیک کنید.
- پروژه خود را انتخاب کنید و سپس روی فعال کردن Firebase کلیک کنید.
همانطور که روی برنامه خود کار میکنید، میتوانید با استفاده از یک اعلان مانند زیر، به عامل دستور دهید که از یک پروژه متفاوت استفاده کند:
Add Firestore to this app using project PROJECT_ID.
وقتی یک پروژه را انتخاب میکنید، اقدامات زیر انجام میشود:
- یک پایگاه داده جدید Cloud Firestore با استفاده از سهمیه مشترک به آن پروژه اختصاص داده خواهد شد .
- Firebase Authentication با ورود به سیستم گوگل پیکربندی خواهد شد.
- به یک حساب کاربری سرویس، دسترسی به پایگاه داده Cloud Firestore شما اعطا خواهد شد. برای دسترسی مدیر از Google AI Studio ، به یک حساب کاربری سرویس جدید با نام
ais-sandbox@ PROJECT_ID .iam.gservice.comاجازه دسترسی به پایگاه داده Cloud Firestore شما داده میشود. این حساب فقط با برنامههای Google AI Studio شما مرتبط است. - محدودیتها : اگر پروژه Firebase از قبل دارای پایگاه داده Cloud Firestore باشد، عامل نمیتواند پایگاه داده دیگری اضافه کند. برای استفاده باید یک پروژه متفاوت انتخاب کنید یا یک پروژه جدید و خالی ایجاد کنید.
استفاده از کنسول Firebase
شما میتوانید دادهها و تنظیمات برنامه خود را در کنسول Firebase مشاهده کنید. در اینجا نحوه دسترسی به پروژه Firebase مرتبط با Google AI Studio آورده شده است:
به کنسول Firebase بروید و پروژهای را که برچسب
AI Studioدارد انتخاب کنید.از پنل ناوبری سمت چپ، سرویسهای فعال در پروژه خود را بررسی کنید:
- برای مشاهده و ویرایش دادههای ذخیره شده Cloud Firestore خود، به Databases & Storage > Firestore بروید.
- برای مشاهده یا پیکربندی تنظیمات و دادههای Authentication ، به امنیت > احراز هویت بروید.
عیبیابی و سوالات متداول
پاسخ سوالات متداول را بیابید و یاد بگیرید که چگونه هنگام ادغام Firebase با برنامه Google AI Studio خود، مشکلات را حل کنید.
پروژه و مکان Google Cloud /Firebase من چگونه انتخاب میشود؟
وقتی برای یک برنامه، بکاند فایربیس درخواست میکنید، میتوانید به صورت اختیاری یک مکان و پروژه را در کارتی که ظاهر میشود انتخاب کنید:
- سفارشیسازی پروژه یا مکان (اختیاری) : روی تنظیمات کلیک کنید، مکان یا پروژه Google Cloud مورد نظر خود را انتخاب کنید و سپس روی فعال کردن Firebase کلیک کنید.
موارد زیر را در نظر داشته باشید:
- مکان پایگاه داده دائمی است : پس از انتخاب مکان پایگاه داده، دیگر نمیتوانید آن را برای آن پروژه تغییر دهید. این انتخاب به عنوان پیشفرض برای سایر سرویسهای backend استفاده خواهد شد.
- ثبات پروژه : برای اطمینان از یکپارچهسازی بینقص، Google AI Studio به طور خودکار از یک پروژه برای backend و deployment شما استفاده میکند. شما نمیتوانید از پروژههای مختلف برای سرویسهای مختلف در یک برنامه استفاده کنید.
چه روشهای احراز هویتی پشتیبانی میشوند؟
وقتی درخواست تنظیم Authentication یا صفحه ورود را میدهید، عامل Google AI Studio، ورود به سیستم Google را راهاندازی میکند. در اینجا نحوه افزودن روشهای ورود به سیستم اضافی به برنامه شما آمده است:
در کنسول Firebase ، به صفحه Security > Authentication > Sign-in method بروید و هر روش ورود دلخواهی را پیکربندی کنید.
به Google AI Studio برگردید، از نماینده Google AI Studio بخواهید که در بهروزرسانی پایگاه کد شما با روش ورود جدید به سیستم، به شما کمک کند.
آیا میتوانم با Google AI Studio یک اپلیکیشن موبایل (مثل اندروید یا iOS) بسازم؟
عامل Google AI Studio از ایجاد برنامههای وب و برنامههای اندروید پشتیبانی میکند.
با این حال، توجه داشته باشید که ادغام Firebase (افزودن Cloud Firestore و Authentication ) در حال حاضر فقط برای برنامههای وب پشتیبانی میشود، نه برای برنامههای اندروید. اگر یک برنامه اندروید میسازید، در صورت نیاز به این سرویسها، باید Firebase را به صورت دستی ادغام کنید.
درباره موارد پشتیبانیشده در مستندات عامل Google AI Studio بیشتر بدانید.
البته توجه داشته باشید که درست مانند همه برنامههای وب، برنامههای وب ایجاد شده توسط Google AI Studio میتوانند به عنوان برنامههای وب موبایل از مرورگرهای نصب شده روی دستگاههای تلفن همراه قابل دسترسی باشند.
فایل firebase-blueprint.json چیست؟
این یک فایل واسطه است که توسط عامل Google AI Studio برای درک کدبیس برنامه شما استفاده میشود. این فایل را به صورت دستی تغییر ندهید، زیرا ممکن است باعث شود عامل کد نادرست یا Security Rules ناامن تولید کند.
اگر با خطای «سهمیه از حد مجاز تجاوز کرده است» مواجه شدم، چه کاری باید انجام دهم؟
رسیدن به سقف سهمیه Cloud Firestore به این معنی است که برنامه شما به سقف استفاده روزانه خود برای گروه سهمیه مشترک پایگاه داده Cloud Firestore شما رسیده است. دو راه برای حل این مشکل وجود دارد:
- گزینه ۱: صبر کنید : سهمیهها روزانه حدود نیمهشب به وقت اقیانوس آرام بازنشانی میشوند.
- گزینه ۲: ارتقا : به طرح قیمتگذاری Blaze که در آن پرداخت در حین استفاده انجام میشود، ارتقا دهید.
- اگر نماینده Google AI Studio ، Cloud Firestore برای شما راهاندازی کرده باشد، باید از دکمه ارتقاء پایگاه داده که در بخش افزودن صورتحساب توضیح داده شده است، استفاده کنید تا سهمیه Cloud Firestore بیشتری دریافت کنید و پایگاه داده خود را به حالت پرداخت منظم منتقل کنید. اگر Cloud Firestore به صورت دستی راهاندازی کردهاید، استفاده از دکمه ارتقاء پایگاه داده ضروری نیست.
اگر خطای «مجوزهای موجود یا ناکافی» دریافت کنم، چه کاری باید انجام دهم؟
این خطا زمانی رخ میدهد که برنامه شما سعی در خواندن یا نوشتن دادهها در پایگاه داده Cloud Firestore شما دارد، اما درخواست توسط Security Rules شما رد میشود. این نشان میدهد که Security Rules بر اساس وضعیت احراز هویت فعلی یا مسیر داده، اجازه انجام عملیات را نمیدهند. روی دکمه رفع خطا کلیک کنید تا از نماینده Google AI Studio بخواهید که Security Rules اصلاح کند.
وقتی برنامه Google AI Studio خود را حذف میکنم، چه اتفاقی برای backend فایربیس من میافتد؟
حذف برنامه شما در Google AI Studio به طور خودکار پروژه Firebase متصل، پایگاه داده Cloud Firestore یا پیکربندیهای Firebase Authentication را حذف نمیکند.
اگر یک backend فایربیس اضافه کردهاید، باید به صورت دستی به کنسول Firebase بروید و پروژه را حذف کنید یا منابع جداگانه (مانند نمونه پایگاه داده Cloud Firestore و ارائه دهندگان Authentication ) را پاک کنید تا مطمئن شوید که تمام دادهها و پیکربندیها حذف شدهاند.
آیا عامل Google AI Studio میتواند دادهها را در پایگاه داده Cloud Firestore من حذف یا ویرایش کند؟
عامل Google AI Studio به گونهای طراحی شده است که به تأمین منابع لازم برای backend و تولید کد و Security Rules کمک کند. اگرچه خود عامل نمیتواند مستقیماً ورودیهای داده را در پایگاه داده Cloud Firestore شما حذف، ویرایش یا دستکاری کند، اما میتواند کدی را در برنامه شما بنویسد که برای انجام این اقدامات طراحی شده است. برای انجام وظایف مدیریت دادهها، مانند حذف ورودیها، به صفحه Databases & Storage > Firestore در کنسول Firebase بروید.
من عضو سازمانی هستم که از Google Cloud استفاده میکند؛ آیا میتوانم برنامه گوگل هوش مصنوعی استودیو خود را به یک پروژه موجود در محیط Google Cloud سازمانم متصل کنم؟
بله. مطمئن شوید که پروژه Firebase شما در پوشه سازماندهی Google Cloud شما قرار دارد و سپس پروژه خود را با استفاده از یکی از روشهای زیر متصل کنید:
- در طول فعالسازی : وقتی برای اولین بار ادغام Firebase را در Google AI Studio فعال میکنید، پروژه موجود خود را در کارتی که ظاهر میشود انتخاب کنید. روی تنظیمات کلیک کنید و پروژه خود را انتخاب کنید.
در طول تکرار : اگر قبلاً Firebase را فعال کردهاید یا میخواهید بعداً پروژهها را تغییر دهید، میتوانید با استفاده از یک اعلان مانند زیر، به عامل دستور دهید که از پروژه موجود شما استفاده کند:
Add Firestore to this app using project PROJECT_ID.
چرا نمیتوانم اسناد خاصی را در کنسول Firebase پیدا کنم؟
وقتی عامل AI Studio دادهها را در یک مسیر تو در تو (مانند /users/user1/messages/msg1 ) ذخیره میکند، بدون اینکه ابتدا سند والد ( user1 ) را ایجاد کند، چیزی ایجاد میکند که به عنوان یک سند والد ناموجود شناخته میشود. این اسناد در کنسول Firebase نمایش داده نمیشوند، که میتواند پیدا کردن آنها را هنگام مرور پایگاه داده Cloud Firestore شما دشوار کند. اگرچه این موضوع بر نحوه اجرای برنامه شما تأثیری ندارد، اما اغلب میتوانید مشکل را برای عامل AI Studio شرح دهید تا از آن بخواهد اسناد والد مفقود شده را ایجاد کند.
برای جزئیات بیشتر، به بخش «اسناد والد ناموجود» مراجعه کنید.
آیا میتوانم محل پایگاه داده Cloud Firestore خود را انتخاب کنم؟
بله. وقتی برای اولین بار ادغام Firebase را در Google AI Studio فعال میکنید، میتوانید مکان پایگاه داده Cloud Firestore خود را انتخاب کنید .
به خاطر داشته باشید که مکانی که انتخاب میکنید برای تمام پایگاههای داده Cloud Firestore که عامل Google AI Studio در آن پروژه Firebase ایجاد میکند، اعمال میشود. پس از تنظیم، این مکان برای آن پایگاههای داده قابل تغییر نیست.
آیا پس از ارتقاء پایگاه داده Cloud Firestore ، میتوانم آن را به گروه سهمیه مشترک برگردانم؟
پس از اینکه یک پایگاه داده از گروه سهمیه مشترک خارج و به یک نمونه پولی معمولی تبدیل شد، میتوانید از دستور curl برای بازگرداندن آن به گروه سهمیه مشترک استفاده کنید. توجه داشته باشید که همه پایگاههای داده درون گروه سهمیه مشترک باید نسخه یکسانی داشته و در یک منطقه قرار داشته باشند.
PROJECT_ID : شناسه پروژه Firebase. این شناسه را در
> صفحه عمومی کنسول Firebase . DATABASE_ID : شناسه پایگاه داده Cloud Firestore که با شناسه اپلت شما مطابقت دارد. این شناسه پایگاه داده را در Google AI Studio با رفتن به تنظیمات > ادغامها و کلیک روی کادر Firebase Firestore & Auth پیدا کنید.
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=free_tier_limited" \
-d '{"free_tier_limited": true}'
گوگل چگونه از دادههای من (مثلاً کد و دستورالعملها) در Google AI Studio استفاده میکند؟
برای جزئیات بیشتر در مورد نحوه استفاده از دادههای شما، به شرایط خدمات تکمیلی Gemini API مراجعه کنید.
من ایمیلی از Google Cloud در مورد «کلید API گوگل برای پروژه Google Cloud شما که برای عموم قابل دسترسی است» دریافت کردم. چه کاری باید انجام دهم؟
اگر ایمیلی از Google Cloud در مورد «کلید API گوگل برای پروژه Google Cloud شما که در دسترس عموم است» دریافت کردهاید و کلید API ذکر شده در ایمیل، کلید API فایربیس شماست ، مطمئن شوید که کلید API الزامات زیر را برآورده میکند تا بتوانید آن را با خیال راحت در کد یا فایلهای پیکربندی خود قرار دهید. میتوانید موارد زیر را در صفحه APIها و خدمات > اعتبارنامهها در کنسول Google Cloud تأیید کنید.
- این کلید API است که شما برای برنامه Firebase خود و فقط برای سرویسهای Firebase استفاده میکنید. این کلیدها معمولاً
Browser key (auto created by Firebase)یاAndroid key (auto created by Firebase)یاiOS key (auto created by Firebase)نامیده میشوند. - این کلید، تمام APIهای مورد نیاز مربوط به Firebase را که در لیست مجاز «محدودیتهای API» قرار دارند، در خود جای داده است.
- هیچ API دیگری در فهرست مجاز «محدودیتهای API» خود ندارد . به طور خاص، این فهرست نباید شامل
Generative Language APIباشد.
همچنین، مطمئن شوید که Firebase Security Rules و App Check همانطور که برای محصولات Firebase مورد استفاده شما توصیه شده است، استفاده میکنید.
میتوانید جزئیات مربوط به کلیدهای API برای Firebase را بیاموزید و فهرستی از سوالات متداول را در «درباره استفاده و مدیریت کلیدهای API برای Firebase بیاموزید» بیابید.