نحوه استفاده از Google AI Studio: Playground، حالت Build و وایب‌کدنویسی با Gemini

برای استفاده از Google AI Studio، با یک حساب گوگل در aistudio.google.com وارد شوید، پرامپت‌ها را در Playground روی مدل‌های Gemini تست کنید، و وقتی خواستید Gemini را از کد خودتان فراخوانی کنید روی Get API key کلیک کنید. برای وایب‌کدنویسی یک اپ، Build mode را باز کنید، اپ را در یک پرامپت توصیف کنید، و Gemini آن را با یک پیش‌نمایش زنده می‌سازد که با چت اصلاحش می‌کنید. سپس می‌توانید آن را روی Cloud Run منتشر کنید، با GitHub همگام‌سازی کنید یا کد را دانلود کنید.

این راهنما هر بخش را طبق مستندات گوگل در زمان نوشتن (نوامبر ۲۰۲۶) مرور می‌کند، و سپس توضیح می‌دهد AI Studio کجا قوی‌ترین است و چه زمانی یک سازنده با پایگاه داده و میزبانی خودش بهتر است. گوگل AI Studio را مرتب به‌روز می‌کند، پس برای نام‌ها و محدودیت‌های جدید مستندات آن را بررسی کنید.

Google AI Studio چیست

AI Studio محیط مرورگری گوگل برای ساختن با Gemini است. دو نوع آدم از آن استفاده می‌کنند:

• توسعه‌دهندگانی که می‌خواهند مدل‌های Gemini را امتحان کنند، پرامپت را تنظیم کنند و کد کارکننده را در پروژه خودشان کپی کنند.
• سازندگانی که می‌خواهند یک اپ را توصیف کنند و Gemini آن را بنویسد، با استفاده از Build mode.

گوگل می‌گوید استفاده از AI Studio در مناطقی که ارائه می‌شود رایگان است، با دسترسی رایگان محدود به برخی مدل‌ها. سطوح پولی API، برخی مدل‌ها، grounding سنگین با جست‌وجوی گوگل و میزبانی روی Google Cloud جداگانه صورتحساب می‌شوند.

بخش ۱: Playground

Playground با یک پرامپت چت جدید باز می‌شود. اینجا جایی است که توانایی‌های یک مدل را پیش از ساختن هر چیزی آزمایش می‌کنید.

1. یک مدل انتخاب کنید و پیامی در کادر ورودی بنویسید، سپس روی Run کلیک کنید.
2. Run settings را باز کنید (آیکون تنظیمات بالا سمت راست) تا پارامترها و تنظیمات ایمنی مدل را تغییر دهید، و خروجی ساختاریافته، فراخوانی تابع، اجرای کد یا grounding را روشن کنید.
3. System Instructions اضافه کنید تا نقش و لحن مدل را مشخص کنید، برای مثال: «تو یک دستیار دوستانه برای یک نانوایی هستی. در دو جمله پاسخ بده و یک محصول پیشنهاد کن.»
4. روی 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 اندروید که در مرورگر پیش‌نمایش می‌شوند.

زمان انتقال به یک سازنده با پایگاه داده و میزبانی

AI Studio ابزار قدرتمندی است و برای خیلی از پروژه‌ها کافی است. ارزش دارد یک سازنده اپ کامل‌استک با هوش مصنوعی را در نظر بگیرید وقتی:

• یک پایگاه داده رابطه‌ای می‌خواهید. Firestore یک پایگاه داده سندی است. اگر اپ شما مشتری، سفارش و فاکتور دارد که با هم رابطه دارند، یک پایگاه داده Postgres می‌تواند ساده‌تر به نظر برسد. راهنمای Supabase در برابر Firebase ما تفاوت را توضیح می‌دهد.
• نمی‌خواهید یک پروژه Google Cloud را مدیریت کنید. استقرار روی Cloud Run یعنی یک حساب Cloud، صورتحساب و تنظیماتش. بعضی‌ها ترجیح می‌دهند با یک کلیک منتشر کنند و میزبانی هم داخل آن باشد.
• میزبانی، پایگاه داده و ذخیره‌سازی را در یک صورتحساب می‌خواهید. در Mythex، اینها از اعتبار ابری ماهانه‌ای که در پلن گنجانده شده پرداخت می‌شوند.
• علاوه بر اندروید به iPhone هم نیاز دارید. در Mythex Pro، یک اپ منتشرشده می‌تواند یک اپ اندروید باشد که در Google Play آپلود می‌کنید و یک اپ iPhone که با کلید App Store Connect خودتان به TestFlight فرستاده می‌شود، بدون مک. (اینها اپ منتشرشده شما را باز می‌کنند؛ کد native به زبان Swift یا Kotlin نیستند.)
• هوش مصنوعی هدف اپ نیست. یک سیستم رزرو یا پورتال مشتری لازم ندارد Gemini در مرکزش باشد، و یک سازنده عمومی ممکن است طبیعی‌تر باشد.
• دامنه اختصاصی می‌خواهید بدون پیکربندی سرویس‌های Cloud.

Mythex این‌طور کار می‌کند: اپ را در چت توصیف می‌کنید، به هر زبانی، و یک اپ کامل‌استک واقعی با پیش‌نمایش زنده می‌سازد، یک پایگاه داده Postgres و ذخیره‌سازی فایل به آن وصل می‌کند و با یک کلیک روی یک آدرس عمومی منتشرش می‌کند. پلن Free بدون کارت است و انتشار را شامل می‌شود؛ Pro ماهانه $25/month است و ویرایش کد، خروجی گرفتن، GitHub، دامنه‌های اختصاصی و اپ‌های موبایل را اضافه می‌کند. صفحه سازنده اپ هوش مصنوعی را ببینید.

در هر صورت، کد با خود شماست: AI Studio از طریق GitHub یا ZIP، و Mythex از طریق خروجی گرفتن و GitHub در Pro. برای دید گسترده‌تر، بهترین ابزارهای وایب‌کدنویسی و ChatGPT در برابر Claude در برابر Gemini برای ساخت اپ را بخوانید.

نکات کلیدی استفاده از Google AI Studio

1. با یک حساب گوگل در aistudio.google.com وارد شوید.
2. در Playground یک مدل انتخاب کنید، پرامپت بنویسید و Run را بزنید. با Run settings پارامترها و قابلیت‌ها را تغییر دهید.
3. برای استفاده از Gemini در اپ خودتان، با Get API key کلید بسازید و آن را در متغیرهای محیطی سمت سرور ذخیره کنید.
4. اگر می‌خواهید اپ بسازید، Build mode را باز کنید و اپ موردنظرتان را با متن توصیف کنید. با چت یا Annotation Mode و در پیش‌نمایش زنده اصلاح کنید.
5. وقتی تمام شد، آن را روی Cloud Run منتشر کنید، با GitHub همگام کنید، یا به‌صورت ZIP دانلود کنید.

اگر می‌خواهید پایگاه داده، میزبانی، دامنه اختصاصی و اپ‌های iPhone و اندروید را یک‌جا مدیریت کنید، یک سازنده اپ هوش مصنوعی کامل‌استک مثل Mythex هم می‌تواند گزینه‌ای باشد.

پرسش‌ها