این صفحه نحوه استفاده از حالت ساخت (Build mode) در Google AI Studio را برای ساخت سریع (یا کد vibe code) و استقرار برنامه‌هایی که آخرین قابلیت‌های Gemini مانند nano banana و Live API را آزمایش می‌کنند، شرح می‌دهد.
شروع کنید
کدنویسی وایبر را در حالت ساخت (Build mode) در Google AI Studio شروع کنید. می‌توانید از چند طریق شروع به ساخت کنید:
- با یک درخواست شروع کنید : در حالت ساخت، از کادر ورودی برای وارد کردن توضیحی از آنچه می‌خواهید بسازید استفاده کنید. برای افزودن ویژگی‌های خاص مانند تولید تصویر یا داده‌های نقشه‌های گوگل به درخواست خود، تراشه‌های هوش مصنوعی را انتخاب کنید. حتی می‌توانید با استفاده از دکمه تبدیل گفتار به متن، آنچه را که می‌خواهید بگویید.
- دکمه‌ی «خوش‌شانس هستم» : اگر به یک جرقه‌ی خلاقانه نیاز دارید، از دکمه‌ی «خوش‌شانس هستم» استفاده کنید و Gemini یک ایده‌ی پروژه برای شروع به شما ارائه می‌دهد.
- ریمیکس کردن یک پروژه از گالری : یک پروژه را از گالری برنامه باز کنید و کپی برنامه را انتخاب کنید.
پس از اجرای اعلان، خواهید دید که کد و فایل‌های لازم تولید می‌شوند و پیش‌نمایش زنده‌ای از برنامه شما در سمت راست ظاهر می‌شود.
چه چیزی ایجاد شده است؟
وقتی اعلان خود را اجرا می‌کنید، AI Studio یک برنامه وب ایجاد می‌کند. به طور پیش‌فرض، یک برنامه وب React ایجاد می‌کند، اما می‌توانید در منوی تنظیمات ، یک برنامه Angular ایجاد کنید. می‌توانید کدی را که تولید می‌شود با انتخاب برگه Code در پنل پیش‌نمایش سمت راست مشاهده کنید.
فایل‌های زیر قابل توجه هستند:
- geminiService.ts : این فایل شامل منطق اصلی برنامه شما، از ساخت اعلان‌ها گرفته تا فراخوانی API Gemini و تجزیه پاسخ‌های آن است. می‌توانید اعلان پایه را در این فایل ویرایش کنید یا هر عملکرد کامپوننت را مستقیماً یا با چت تعاملی با Gemini در حالت Build تغییر دهید. توجه داشته باشید که کد موجود در این فایل از GenAI TS SDK برای تعامل با API Gemini استفاده می‌کند.
ادامه ساخت و ساز
زمانی که Google AI Studio کد اولیه برنامه وب شما را تولید کرد، دو گزینه اصلی برای ادامه پروژه خود دارید: Build in AI Studio یا Develop Externally .
ساخت در استودیوی هوش مصنوعی گوگل
شما می‌توانید مستقیماً در محیط Google AI Studio به اصلاح و گسترش برنامه خود ادامه دهید:
- تکرار با Gemini : از پنل چت در حالت ساخت استفاده کنید تا از Gemini بخواهید اصلاحاتی انجام دهد، ویژگی‌های جدیدی اضافه کند یا ظاهر را تغییر دهد. برای مثال، می‌توانید بپرسید: «دکمه ای اضافه کنید که به کاربر هشدار دهد» یا «طرح رنگ را به آبی و سفید تغییر دهید».
- ویرایش مستقیم کد : برای ویرایش‌های زنده، تب Code را در پنل پیش‌نمایش باز کنید. می‌توانید پروژه خود را در GitHub ذخیره کنید تا در حین توسعه از کنترل نسخه استفاده کنید.
توسعه بیرونی
برای گردش‌های کاری پیشرفته‌تر، می‌توانید کد را اکسپورت کنید و در محیط دلخواه خود کار کنید:
- دانلود و توسعه محلی : کد تولید شده را به صورت یک فایل ZIP صادر کرده و آن را به ویرایشگر کد خود وارد کنید. این به شما امکان می‌دهد از ابزارهای آشنا، سیستم‌های ساخت و شیوه‌های کنترل نسخه محلی خود برای ادامه ساخت فراتر از نمونه اولیه استفاده کنید.
- ارسال به گیت‌هاب : با ارسال کد به یک مخزن گیت‌هاب، آن را با فرآیندهای توسعه و استقرار موجود خود ادغام کنید.
ویژگی‌های کلیدی
استودیوی هوش مصنوعی گوگل شامل چندین ویژگی است که فرآیند ساخت را بصری و شهودی می‌کند:
- حالت حاشیه‌نویسی : به جای نوشتن کد برای تغییر ظاهر برنامه، حالت حاشیه‌نویسی به شما امکان می‌دهد هر بخشی از رابط کاربری برنامه خود را برجسته کنید و تغییر مورد نظر خود را شرح دهید. به عنوان مثال، می‌توانید یک جزء را انتخاب کنید و بنویسید: «این دکمه را آبی کن» یا «این تصویر را متحرک کن تا از سمت چپ به داخل حرکت کند». وقتی گزینه « افزودن به چت » را انتخاب می‌کنید، یک اعلان با یک اسکرین‌شات از برنامه حاشیه‌نویسی شده ایجاد می‌شود.
- برنامه خود را به اشتراک بگذارید : می‌توانید آثار خود را با دیگران به اشتراک بگذارید تا با آنها همکاری کنید یا آثار خود را به نمایش بگذارید.
- گالری برنامه‌ها : گالری برنامه‌ها یک کتابخانه بصری از ایده‌های پروژه ارائه می‌دهد. می‌توانید با Gemini امکانات را مرور کنید، فوراً پیش‌نمایش برنامه‌ها را ببینید و آنها را با هم ترکیب کنید تا به سبک خودتان درآیند.
برنامه خود را مستقر یا بایگانی کنید
پس از آماده شدن برنامه، می‌توانید آن را مستقیماً از AI Studio مستقر کنید. گزینه‌های استقرار عبارتند از:
- Google Cloud Run : برنامه خود را به عنوان یک سرویس مقیاس‌پذیر مستقر کنید. توجه داشته باشید که قیمت‌گذاری برای Google Cloud Run ممکن است بر اساس میزان استفاده اعمال شود.
- GitHub : پروژه خود را به یک مخزن GitHub صادر کنید تا آن را در گردش‌های کاری توسعه و استقرار موجود خود ادغام کنید.
محدودیت‌ها
این بخش محدودیت‌های مهم هنگام استفاده از حالت ساخت (Build mode) در Google AI Studio را شرح می‌دهد.
امنیت و افشای کلید API
- کد برنامه‌های اشتراکی برای هر کسی که آنها را مشاهده می‌کند قابل مشاهده است. هرگز از یک کلید API واقعی مستقیماً در کد برنامه خود استفاده نکنید.
- به طور پیش‌فرض، برنامه‌ها از یک مکان‌نما (مثلاً process.env.GEMINI_API_KEY) برای کلید API استفاده می‌کنند. وقتی کاربری برنامه مشترک شما را در AI Studio اجرا می‌کند، AI Studio به عنوان یک پروکسی عمل می‌کند و مکان‌نما را با کلید API کاربر نهایی جایگزین می‌کند و تضمین می‌کند که کلید شما خصوصی باقی می‌ماند.
قابلیت مشاهده و اشتراک‌گذاری برنامه
- برنامه‌ها در گوگل درایو ذخیره می‌شوند و مدل مجوزهای آن را به ارث می‌برند، به این معنی که به طور پیش‌فرض خصوصی هستند.
- مجوزهای اشتراک‌گذاری: وقتی برنامه‌ای را با سایر کاربران به اشتراک می‌گذارید:
- کاربران اشتراکی می‌توانند کد را ببینند و برنامه را برای استفاده خودشان فورک کنند.
- در صورت اعطای مجوز ویرایش، کاربران اشتراکی می‌توانند کد برنامه را تغییر دهند.
استقرار خارج از استودیوی هوش مصنوعی
- اگرچه می‌توانید برنامه خود را برای یک URL عمومی در Cloud Run مستقر کنید، اما این تنظیمات از کلید API شما برای فراخوانی‌های API Gemini همه کاربران استفاده خواهد کرد.
- برنامه‌های جاوا اسکریپت سمت کلاینت اجرا می‌شوند، بنابراین اطمینان حاصل کنید که کلیدهای API فقط دسترسی حداقلی دارند تا از نشت داده‌ها یا سوءاستفاده جلوگیری شود. به عنوان مثال، سایر فروشگاه‌های جستجوی فایل از همان پروژه ممکن است از طریق این مکانیسم برای کاربران قابل دسترسی باشند.
- استقرار خارجی امن: برای اجرای امن یک برنامه در خارج از AI Studio (مثلاً پس از دانلود فایل زیپ)، باید منطقی را که از کلید API استفاده می‌کند به یک جزء سمت سرور منتقل کنید تا از افشای کلید به کاربران نهایی جلوگیری شود. در صورت استقرار با استفاده از Cloud Run، نیازی به این کار نیست.
- هشدار افشای کلید: جایگزینی ساده‌ی placeholder با یک کلید API واقعی در محیط سمت کلاینت اکیداً توصیه نمی‌شود، زیرا کلید برای هر کاربری قابل مشاهده خواهد بود.
پشتیبانی از ابزار و ویژگی‌ها
- واردات توسعه محلی: در حال حاضر، شما نمی‌توانید برنامه‌ها را به صورت محلی با ابزارهای خارجی توسعه دهید و آنها را به AI Studio وارد کنید.
قدم بعدی چیست؟
- ببینید دیگران چه ساخته‌اند و با ریمیکس کردن یک پروژه موجود در گالری برنامه ، از آنها الهام بگیرید.
- برای شروع کار، به لیست پخش یوتیوب مراجعه کنید تا مجموعه‌ای از آموزش‌های کدنویسی vibe از AI Studio را ببینید.