نحوه استفاده از Google AI Studio: Playground، حالت Build و وایبکدنویسی با Gemini
برای استفاده از Google AI Studio، با یک حساب گوگل در aistudio.google.com وارد شوید، پرامپتها را در Playground روی مدلهای Gemini تست کنید، و وقتی خواستید Gemini را از کد خودتان فراخوانی کنید روی Get API key کلیک کنید. برای وایبکدنویسی یک اپ، Build mode را باز کنید، اپ را در یک پرامپت توصیف کنید، و Gemini آن را با یک پیشنمایش زنده میسازد که با چت اصلاحش میکنید. سپس میتوانید آن را روی Cloud Run منتشر کنید، با GitHub همگامسازی کنید یا کد را دانلود کنید.
این راهنما هر بخش را مطابق مستندات Google در زمان نوشتن این متن (نوامبر ۲۰۲۶) توضیح میدهد و سپس نشان میدهد AI Studio کجا قویترین است و چه زمانی باید به یک سازنده با پایگاه داده و میزبانی اختصاصی رفت. Google اغلب AI Studio را بهروز میکند، پس برای نامها و محدودیتهای جدید مستندات آن را بررسی کنید.
Google AI Studio چیست
AI Studio محیط مرورگری گوگل برای ساختن با Gemini است. دو نوع آدم از آن استفاده میکنند:
- توسعهدهندگانی که میخواهند مدلهای Gemini را امتحان کنند، پرامپت را تنظیم کنند و کد کارکننده را در پروژه خودشان کپی کنند.
- سازندگانی که میخواهند یک اپ را توصیف کنند و Gemini آن را بنویسد، با استفاده از Build mode.
گوگل میگوید استفاده از AI Studio در مناطقی که ارائه میشود رایگان است، با دسترسی رایگان محدود به برخی مدلها. سطوح پولی API، برخی مدلها، grounding سنگین با جستوجوی گوگل و میزبانی روی Google Cloud جداگانه صورتحساب میشوند.
بخش ۱: Playground
Playground با یک پرامپت چت جدید باز میشود. اینجا جایی است که تواناییهای یک مدل را پیش از ساختن هر چیزی آزمایش میکنید.
- یک مدل انتخاب کنید و پیامی در کادر ورودی بنویسید، سپس روی Run کلیک کنید.
- Run settings را باز کنید (آیکون تنظیمات بالا سمت راست) تا پارامترها و تنظیمات ایمنی مدل را تغییر دهید، و خروجی ساختاریافته، فراخوانی تابع، اجرای کد یا grounding را روشن کنید.
- System Instructions اضافه کنید تا نقش و لحن مدل را مشخص کنید، برای مثال: «تو یک دستیار دوستانه برای یک نانوایی هستی. در دو جمله پاسخ بده و یک محصول پیشنهاد کن.»
- روی Get code کلیک کنید تا پرامپت و تنظیمات به کد به زبان موردنظرتان تبدیل شوند.
جز چت، Playground نوعهای دیگری از پرامپت مثل استریم بلادرنگ و تولید ویدیو هم دارد.
گرفتن کلید API
وقتی میخواهید Gemini را داخل اپ خودتان داشته باشید، کلید را از صفحه Get API key (aistudio.google.com/apikey) بسازید. مثل رمز عبور با آن رفتار کنید: آن را در متغیرهای محیطی یا secrets سرورتان نگه دارید، نه در کدی که در مرورگر بازدیدکننده اجرا میشود. راهنمای ما درباره امن نگه داشتن کلیدهای API دلیلش را توضیح میدهد.
بخش ۲: وایبکدنویسی در Build mode
Build mode جایی است که «وایبکدنویسی با Gemini» اتفاق میافتد. اپ را توصیف میکنید، عامل AI Studio کد را مینویسد و نتیجه را کنار آن نشان میدهد.
شروع یک پروژه
چند راه برای ورود وجود دارد:
- یک پرامپت درباره اپ تایپ کنید.
- I'm Feeling Lucky را بزنید تا یک ایده تولیدشده بگیرید.
- یک اپ را از App Gallery با Copy App Remix کنید.
- از GitHub import کنید با منوی Add files.
میتوانید AI Chips اضافه کنید تا قابلیتهایی مثل تولید تصویر یا داده Maps را وارد کنید، و پرامپتها را با تبدیل گفتار به متن دیکته کنید.
چه چیزی ساخته میشود
طبق مستندات گوگل:
- اپهای وب بهطور پیشفرض: یک frontend با React بهعلاوه یک سرور Node.js، تا فراخوانیهای API روی سرور بمانند، بستههای npm خودکار نصب شوند و اپ بتواند به پایگاه داده وصل شود.
- اپهای native اندروید با Kotlin و Jetpack Compose که میتوانید در یک شبیهساز مرورگری پیشنمایش کنید، از طریق ADB نصب کنید و برای تست داخلی در Google Play منتشر کنید.
- راهاندازی خودکار Firebase: Firestore برای داده و Firebase Authentication با Sign in with Google.
- یکپارچهسازی با Google Workspace مثل Gmail، Sheets، Docs، Drive و Calendar.
یک پرامپت اول
یک اپ دستور غذا بساز. من یک دستور یا لینک را paste میکنم و Gemini آن را به یک کارت تمیز با مواد لازم، مراحل و زمان پخت تبدیل میکند. میتوانم دستورها را ذخیره، جستوجو و برای تعداد نفرات دیگر مقدار مواد را تنظیم کنم. اجازه بده با Google وارد شوم تا دستورهایم در حساب من ذخیره شوند.
این پرامپت نقاط قوت AI Studio را نشان میدهد: Gemini بخشی از قابلیت است، ورود با Google انجام میشود و ذخیرهسازی با Firebase است.
اصلاح اپ
- با عامل چت کنید: «یک لیست خرید اضافه کن که مواد دستورهای تیکخورده را ترکیب کند.»
- Annotation Mode: بخشی از صفحه اپ را هایلایت کنید و تغییر موردنظرتان را همانجا توضیح دهید. این از توضیح دادن اینکه منظورتان کدام دکمه است سریعتر است.
- تب Code: کد تولیدشده را ببینید و در صورت تمایل مستقیم آن را ویرایش کنید.
مستندات گوگل میگوید Build mode کلید API مربوط به Gemini را بهعنوان یک secret سمت سرور نگه میدارد (به نام GEMINI_API_KEY که در پنل Secrets دیده میشود)، نه در کد سمت کلاینت. اپهای اندروید بهجای کلید از Firebase AI Logic و App Check استفاده میکنند.
اشتراکگذاری و انتشار
- اشتراکگذاری: اپها بهطور پیشفرض خصوصی هستند. افرادی که با آنها به اشتراک میگذارید میتوانند کد را ببینند و fork کنند، و کسانی که حق ویرایش دارند میتوانند آن را تغییر دهند. فراخوانیهای Gemini که افرادی با اپ مشترک شما انجام میدهند، به مصرف شما حساب میشود، و AI Studio پیش از اشتراکگذاری، در صورت احتمال هزینه، هشدار میدهد.
- Cloud Run: از AI Studio بهعنوان یک سرویس مقیاسپذیر مستقر کنید. ممکن است قیمتگذاری Google Cloud اعمال شود.
- GitHub: همگامسازی دوطرفه با یک مخزن، با نمای تعارض وقتی هر دو طرف تغییر کرده باشند.
- دانلود ZIP: کد را هرجا خواستید ببرید. کلید API را روی میزبان خودتان تنظیم میکنید.
نکات برای نتیجه بهتر در Build mode
- با کاری که Gemini در اپ انجام میدهد شروع کنید. Build mode وقتی بهترین عملکرد را دارد که هوش مصنوعی قابلیت اصلی باشد: خلاصهسازی، استخراج، تولید تصویر، یا پاسخ دادن به پرسشها روی یک سند.
- بگویید چه چیزی ذخیره میشود و برای چه کسی. «دستورهای هر کاربر فقط برای خودش خصوصی است» قانونی است که ارزش دارد از همان ابتدا بیان شود.
- در هر پیام فقط یک چیز را تغییر دهید و قبل از پیام بعدی در پیشنمایش آزمایشش کنید.
- قوانین امنیتی Firebase را پیش از ورود کاربران واقعی بررسی کنید. اینکه اپ برای شما کار میکند به این معنا نیست که دیگران نمیتوانند دادههای شما را بخوانند. بپرسید: «قوانین Firestore را نشان بده و توضیح بده چه کسی میتواند هر collection را بخواند و بنویسد.»
برای پرامپتهای بیشتری که در هر ابزاری کار میکنند، چیتشیت پرامپتهای وایبکدنویسی ما را ببینید.
جایی که Google AI Studio قویترین است
- اپهایی که Gemini قابلیت اصلی آنهاست، با کلید نگهداشتهشده روی سرور.
- پشتههای متمرکز بر گوگل: Firebase، ورود با Google، داده Workspace، Maps.
- توسعهدهندگانی که یک نمونه اولیه سریع میخواهند و بعد آن را با GitHub همگام میکنند و ادامه میدهند.
- آزمایشهای native اندروید که در مرورگر پیشنمایش میشوند.
زمان انتقال به یک سازنده با پایگاه داده و میزبانی
به یک ابزار ساخت اپ کاملاستک مثل Mythex بروید وقتی:
- پایگاه داده رابطهای میخواهید. Firestore یک پایگاه داده سندی است. اگر اپ شما مشتری، سفارش و فاکتور با ارتباط بین آنها دارد، پایگاه داده Postgres میتواند سادهتر فهمیده شود. راهنمای Supabase در برابر Firebase تفاوت را توضیح میدهد.
- نمیخواهید یک پروژه Google Cloud را مدیریت کنید. استقرار روی Cloud Run یعنی یک حساب Cloud، صورتحساب و تنظیماتش. بعضی آدمها ترجیح میدهند با یک کلیک منتشر کنند و میزبانی همراه داشته باشند.
- میزبانی، پایگاه داده و ذخیرهسازی را در یک صورتحساب میخواهید. در Mythex، اعتبارها از یک موجودی هزینه ساخت و میزبانی را پرداخت میکنند.
- علاوه بر Android به iPhone هم نیاز دارید. در Mythex Pro، یک اپ منتشرشده میتواند به یک اپ Android که به آزمایش داخلی Google Play میرود و یک اپ iPhone که به TestFlight با حساب App Store خودتان میرود تبدیل شود، بدون Mac. هر Publish محتوای اپهای گوشی را بدون نسخه جدید فروشگاه بهروز میکند.
- هوش مصنوعی هدف اپ نیست. یک سیستم رزرو یا پورتال مشتری به Gemini در مرکزش نیاز ندارد، و Mythex آن را دور کسبوکار شما میسازد.
- دامنه اختصاصی میخواهید بدون تنظیم سرویسهای Cloud.
Mythex اینگونه کار میکند: اپ را در چت توصیف میکنید، به هر زبانی، و یک اپ کاملاستک واقعی با پیشنمایش زنده میسازد، یک پایگاه داده Postgres و ذخیرهسازی فایل وصل میکند و با یک کلیک در یک نشانی عمومی منتشر میکند. پلن Free بدون کارت است و انتشار را شامل میشود؛ Pro از ۲۵ دلار در ماه شروع میشود و ویرایش کد، دانلود پروژه، همگامسازی با GitHub، دامنههای اختصاصی و اپهای موبایل را بدون هزینه صندلی اضافه میکند. صفحه ساخت اپ با هوش مصنوعی و Mythex در برابر Google AI Studio را ببینید.
در هر صورت کد با خودتان است: AI Studio از طریق GitHub یا ZIP، و Mythex از طریق دانلود پروژه و همگامسازی GitHub در Pro. همچنین میتوانید یک ZIP یا مخزن GitHub از AI Studio را در Mythex وارد کنید و عامل آن را راهاندازی میکند. برای دیدی گستردهتر از گزینهها، بهترین ابزارهای vibe coding و ChatGPT در برابر Claude در برابر Gemini برای ساخت اپ را ببینید.
نکات کلیدی استفاده از Google AI Studio
- با یک حساب گوگل در aistudio.google.com وارد شوید.
- در Playground یک مدل انتخاب کنید، پرامپت بنویسید و Run را بزنید. با Run settings پارامترها و قابلیتها را تغییر دهید.
- برای استفاده از Gemini در اپ خودتان، با Get API key کلید بسازید و آن را در متغیرهای محیطی سمت سرور ذخیره کنید.
- اگر میخواهید اپ بسازید، Build mode را باز کنید و اپ موردنظرتان را با متن توصیف کنید. با چت یا Annotation Mode و در پیشنمایش زنده اصلاح کنید.
- وقتی تمام شد، آن را روی Cloud Run منتشر کنید، با GitHub همگام کنید، یا بهصورت ZIP دانلود کنید.
اگر میخواهید پایگاه داده، میزبانی، دامنه اختصاصی و اپهای iPhone و اندروید را یکجا مدیریت کنید، یک سازنده اپ هوش مصنوعی کاملاستک مثل Mythex هم میتواند گزینهای باشد.
پرسشها
آیا Google AI Studio رایگان است؟
گوگل میگوید استفاده از AI Studio در مناطقی که در دسترس است رایگان است، با دسترسی رایگان محدود به برخی مدلها. استفاده پولی از API، برخی مدلهای جدیدتر، جستوجوی اضافی با Search grounding و میزبانی روی Cloud Run میتوانند هزینه داشته باشند، پس پیش از اشتراکگذاری یا انتشار اپ صفحه قیمت گوگل را بررسی کنید.
حالت Build در Google AI Studio چیست؟
Build mode فضای وایبکدنویسی AI Studio است. اپ را در یک پرامپت توصیف میکنید، Gemini کد را با یک پیشنمایش زنده تولید میکند و شما با چت یا با هایلایت کردن بخشی از صفحه آن را اصلاح میکنید. اپهای وب یک frontend با React و یک سرور Node.js میگیرند، و میتواند اپهای native اندروید هم تولید کند.
آیا اپهای Google AI Studio میتوانند پایگاه داده و ورود کاربر داشته باشند؟
بله. طبق مستندات گوگل، Build mode میتواند Firebase را خودکار راهاندازی کند، شامل Firestore برای داده و Firebase Authentication با Sign in with Google. پایگاههای داده دیگر هم کار میکنند اگر سرور شما بتواند از طریق شبکه به آنها دسترسی داشته باشد.
یک اپ Google AI Studio را چطور منتشر کنم؟
میتوانید از خود AI Studio آن را روی Google Cloud Run مستقر کنید، کد را با GitHub همگام کنید، یا یک ZIP دانلود کنید و روی جای دیگری میزبانی کنید. Cloud Run بخشی از Google Cloud است، پس قیمتگذاری عادی آن ممکن است اعمال شود، و با ZIP باید کلید API مربوط به Gemini را روی میزبان خودتان تنظیم کنید.
چه زمانی باید به جای Google AI Studio از یک سازنده اپ استفاده کنم؟
وقتی اپ باید به یک محصول واقعی تبدیل شود. Mythex پایگاه داده Postgres، ذخیرهسازی فایل، میزبانی، دامنه اختصاصی در Pro، و اپ iPhone و Android در Pro را در یک جا میدهد که همه از یک موجودی اعتبار پرداخت میشوند، بدون راهاندازی یک پروژه Google Cloud. عامل همچنان میتواند با کلید API خودتان از اپ، Gemini را صدا بزند.