Google AI Studio مستقیماً با Cloud Firestore و Firebase Authentication ادغام میشود و به شما امکان میدهد برنامههایی با دادههای پایدار و جریانهای ورود امن بسازید. وقتی از ویژگی "Add Firebase backend" در Google AI Studio استفاده میکنید، عامل کد مورد نیاز را تولید کرده و برنامه شما را به یک پروژه Firebase متصل میکند.
مرور کلی: یک بکاند به برنامه Google AI Studio خود اضافه کنید
ایده خود را شرح دهید : یک برنامه جدید در Google AI Studio ایجاد کنید و یک ویژگی را که نیاز به پایگاه داده یا احراز هویت دارد شرح دهید (برای مثال، "ایجاد یک لیست کارهای مشترک").
فعال کردن ادغام Firebase : گزینه Add Firebase backend chip را انتخاب کنید. عامل کد لازم، شامل فایل
/src/lib/firebase.tsو فایلfirestore.rulesرا تولید میکند و سپس برنامه شما را به Cloud Firestore و Firebase Authentication متصل میکند.استقرار : پس از آماده شدن، از گزینه اشتراکگذاری > انتشار برای استقرار برنامه خود در Cloud Run استفاده کنید.
سهمیه مشترک برای Cloud Firestore را درک کنید
تمام پایگاههای داده Cloud Firestore که توسط عامل در Google AI Studio ارائه میشوند، در همان "گروه" پایگاههای داده در پروژه Firebase شما قرار میگیرند. همه آنها این ویژگیها را دارند:
- سهمیه مشترک : همه پایگاههای داده در گروه، سهمیه استفاده مشترکی دارند ( جزئیات بیشتر را در زیر ببینید ).
- بدون نیاز به حساب Cloud Billing : میتوانید برنامه خود را بدون اضافه کردن پرداخت بسازید و آزمایش کنید. جزئیات مربوط به اضافه کردن اختیاری پرداخت را در زیر مشاهده کنید.
- بازنشانیهای روزانه : اگر به محدودیت سهمیه روزانه (مثلاً ۵۰ هزار خواندن در روز) برسید، سرویس برای تمام پایگاههای داده درون گروه متوقف میشود و روز بعد حدود نیمهشب به وقت اقیانوس آرام از سر گرفته میشود.
| متریک | سهمیه |
|---|---|
| دادههای ذخیره شده | مجموع ۱ گیگابایت |
| خروجی شبکه | ۱۰ گیگابایت در ماه |
| واحدها را بنویسید | ۴۰،۰۰۰ نوشته در روز |
| واحدها را بخوانید | ۵۰،۰۰۰ بازدید در روز |
| واحدهای بهروزرسانی بلادرنگ | ۵۰،۰۰۰ بهروزرسانی در روز |
(اختیاری) برای دریافت سهمیه بیشتر Cloud Firestore صورتحساب را اضافه کنید
اگر برنامه شما مورد توجه قرار گرفت و نیاز داشتید که از محدودیتهای رایگان Cloud Firestore فراتر بروید، میتوانید پروژه خود را به طرح قیمتگذاری Pay-as-you-go Blaze ارتقا دهید.
- افزودن صورتحساب (اگر قبلاً این کار را نکردهاید) : به کنسول Firebase بروید و یک حساب صورتحساب را به پروژه خود پیوند دهید .
ارتقاء پایگاه داده : به طور پیشفرض، پایگاههای داده Cloud Firestore که توسط نماینده Google AI Studio ایجاد شدهاند ، حتی پس از ارتقاء طرح قیمتگذاری شما ، همچنان از سهمیه مشترک استفاده میکنند. برای فعال کردن مقیاسپذیری کامل پولی برای یک پایگاه داده خاص، باید آن را به صورت دستی با استفاده از دستور
curlاز گروه خارج کنید.- PROJECT_ID : شناسه پروژه Firebase؛ این شناسه را در تنظیمات پروژه کنسول Firebase پیدا کنید.
- DATABASE_ID : شناسه پایگاه داده Cloud Firestore ، که با شناسه اپلت شما مطابقت دارد؛ این شناسه پایگاه داده را در ستون نام در صفحه پایگاههای داده Cloud Firestore در کنسول Firebase پیدا کنید.
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=limited_free_tier" \ -d '{"limited_free_tier": false}'
تولید Security Rules
Google AI Studio به طور خودکار Firebase Security Rules بر اساس منطق برنامه شما ایجاد میکند. این Security Rules به گونهای طراحی شدهاند که "به طور پیشفرض قابل انکار" باشند، به این معنی که کاربران نهایی برنامه شما فقط میتوانند به دادههایی که متعلق به خودشان است دسترسی داشته باشند.
توجه داشته باشید که اگر Security Rules خود را مستقیماً در کنسول Firebase به صورت دستی تنظیم کنید، عامل Google AI Studio از تغییرات مطلع نخواهد شد و در طول تکرارهای بعدی برنامه بازنویسی میشوند. توصیه میکنیم از عامل Google AI Studio برای تنظیم Firebase Security Rules خود استفاده کنید تا مطمئن شوید که تغییرات شما حفظ شده و با منطق برنامه شما همسو هستند.
استفاده از یک پروژه موجود
همچنین میتوانید از نماینده Google AI Studio بخواهید که Cloud Firestore در یک پروژه Google Cloud موجود که متعلق به شماست، ارائه دهد. با یک درخواست مانند زیر، به نماینده دستور دهید که از پروژه موجود شما استفاده کند:
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 مشاهده کنید. برای دسترسی به پروژههای مرتبط با Google AI Studio ، این مراحل را دنبال کنید:
- به کنسول Firebase بروید و پروژهای با عنوان AI Studio را انتخاب کنید.
- در پنل ناوبری سمت چپ، برای مشاهده و ویرایش دادههای خود در Cloud Firestore ، روی Build > Cloud Firestore Database کلیک کنید، یا برای پیکربندی تنظیمات و دادههای Authentication خود، روی Build > Authentication کلیک کنید.
عیبیابی و سوالات متداول
پاسخ سوالات متداول را بیابید و یاد بگیرید که چگونه هنگام ادغام Firebase با برنامه Google AI Studio خود، مشکلات را حل کنید.
چه روشهای احراز هویتی پشتیبانی میشوند؟
وقتی از ویژگی Add Firebase backend استفاده میکنید، Google AI Studio agent، ورود به سیستم گوگل (Google Sign-In) را تنظیم میکند. برای تنظیم متدهای اضافی، آنها را در کنسول Firebase فعال کنید و از Google AI Studio agent برای بهروزرسانی کدبیس خود کمک بگیرید.
فایل firebase-blueprint.json چیست؟
این یک فایل واسطه است که توسط عامل Google AI Studio برای درک کدبیس برنامه شما استفاده میشود. این فایل را به صورت دستی تغییر ندهید، زیرا ممکن است باعث شود عامل کد نادرست یا Security Rules ناامن تولید کند.
اگر با خطای «سهمیه از حد مجاز تجاوز کرده است» مواجه شدم، چه کاری باید انجام دهم؟
رسیدن به سقف سهمیه Cloud Firestore به این معنی است که برنامه شما به سقف استفاده روزانه خود برای گروه سهمیه مشترک پایگاه داده Cloud Firestore شما رسیده است. دو راه برای حل این مشکل وجود دارد:
- گزینه ۱: صبر کنید : سهمیهها روزانه حدود نیمهشب به وقت اقیانوس آرام بازنشانی میشوند.
- گزینه ۲: ارتقا : به طرح قیمتگذاری Blaze که در آن پرداخت در حین استفاده انجام میشود، ارتقا دهید.
- اگر نماینده Google AI Studio ، Cloud Firestore برای شما راهاندازی کرده باشد، باید از دستور
curlکه در بخش افزودن صورتحساب توضیح داده شده است، استفاده کنید تا سهمیه Cloud Firestore بیشتری دریافت کنید و پایگاه داده خود را به حالت پرداخت منظم منتقل کنید. اگر Cloud Firestore به صورت دستی راهاندازی کردهاید، اجرای دستورcurlضروری نیست.
- اگر نماینده Google AI Studio ، 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 شما حذف، ویرایش یا دستکاری کند، اما میتواند کدی را در اپلت شما بنویسد که برای انجام این اقدامات طراحی شده است. برای انجام وظایف مدیریت دادهها، مانند حذف ورودیها، به صفحه پایگاه داده Cloud Firestore در کنسول Firebase بروید.
من عضو سازمانی هستم که از Google Cloud استفاده میکند؛ آیا میتوانم برنامه گوگل هوش مصنوعی استودیو خود را به یک پروژه موجود در محیط Google Cloud سازمانم متصل کنم؟
مطمئن شوید که پروژه Firebase شما در یک پوشه سازماندهی خاص Google Cloud قرار دارد:
- پروژه Firebase خود را از قبل به صورت دستی ایجاد کنید.
هنگام تنظیم backend فایربیس خود در Google AI Studio ، به agent دستور دهید که از پروژه موجود شما استفاده کند:
Add Firestore to this app using project PROJECT_ID.
چرا نمیتوانم اسناد خاصی را در کنسول Firebase پیدا کنم؟
وقتی عامل AI Studio دادهها را در یک مسیر تو در تو (مانند /users/user1/messages/msg1 ) ذخیره میکند، بدون اینکه ابتدا سند والد ( user1 ) را ایجاد کند، چیزی ایجاد میکند که به عنوان یک سند والد ناموجود شناخته میشود. این اسناد در کنسول Firebase نمایش داده نمیشوند، که میتواند پیدا کردن آنها را هنگام مرور پایگاه داده Cloud Firestore شما دشوار کند. اگرچه این موضوع بر نحوه اجرای برنامه شما تأثیری ندارد، اما اغلب میتوانید مشکل را برای عامل AI Studio شرح دهید تا از آن بخواهد اسناد والد مفقود شده را ایجاد کند.
برای جزئیات بیشتر، به بخش «اسناد والد ناموجود» مراجعه کنید.
مکان پایگاه داده Cloud Firestore من چگونه انتخاب میشود؟
در حال حاضر، مکان پایگاه داده Cloud Firestore شما به طور خودکار بر اساس موقعیت مکانی شما انتخاب میشود و نمیتوان آن را تغییر داد یا به صورت دستی مشخص کرد. اگر مایلید امکان انتخاب مکان خاصی وجود داشته باشد، با رفتن به تنظیمات > ارسال بازخورد در Google AI Studio به ما اطلاع دهید.
گوگل چگونه از دادههای من (مثلاً کد و دستورالعملها) در Google AI Studio استفاده میکند؟
برای جزئیات بیشتر در مورد نحوه استفاده از دادههای شما، به شرایط خدمات تکمیلی Gemini API مراجعه کنید.