این صفحه نحوه استفاده از Google AI Studio را برای ساخت سریع (یا «vibe code») و استقرار برنامههایی که جدیدترین قابلیتهای Gemini مانند Nano Banana و Live API را آزمایش میکنند شرح میدهد. Google AI Studio از ساختن برنامههای وب با زمانهای اجرای پشته کامل و برنامههای Android بومی با Kotlin و Jetpack Compose پشتیبانی میکند — همه ازطریق پیامواره زبان طبیعی.
شروع کنید
کدنویسی حسی را در حالت ساختن Google AI Studio شروع کنید. به چند روش میتوانید ساختن را شروع کنید:
- با پیامواره شروع کنید: در حالت «ساختن»، از چارگوش ورودی برای وارد کردن شرحی از آنچه میخواهید بسازید استفاده کنید. تراشههای هوش مصنوعی را انتخاب کنید تا ویژگیهای خاصی مثل تولید تصویر یا دادههای Google Maps را به پیاموارهتان اضافه کنید. حتی میتوانید بااستفاده از دکمه گفتار به نوشتار، آنچه را میخواهید بگویید.
- دکمه «یا شانس و یا اقبال»: اگر به جرقهای خلاقانه نیاز دارید، از دکمه «یا شانس و یا اقبال» استفاده کنید تا Gemini با تولید یک پیامواره حاوی ایده پروژه، به شما کمک کند کارتان را شروع کنید.
- بازآمیزی کردن پروژه از گالری: پروژهای را از گالری برنامه باز کنید و کپی کردن برنامه را انتخاب کنید.
- وارد کردن پروژه از GitHub: در حالت «ساخت»، وارد کردن از GitHub را از منو افزودن فایلها (نماد +) در چارگوش ورودی پیامواره انتخاب کنید تا کد موجودتان را وارد کنید.
پساز اجرای پیامواره، خواهید دید که کد و فایلهای لازم تولید میشوند، و پیشنمایش زندهای از برنامهتان در سمت چپ ظاهر میشود.
چه چیزی ایجاد میشود؟
وقتی پیاموارهتان را اجرا میکنید، AI Studio یک برنامه کامل ایجاد میکند. میتوانید بااستفاده از انتخابگر پلاتفرم، برنامه وب یا برنامه Android بومی بسازید.
برای برنامههای وب (پیشفرض)، AI Studio یک محیط پشته کامل ایجاد میکند که شامل موارد زیر است:
- سمت کارخواه: یک وب فرانتاند (React پیشفرض است).
- سمت سرور: زمان اجرای Node.js که امکان برقراری تماسهای امن API، اتصال به پایگاه داده، و استفاده از بسته npm را فراهم میکند.
برای برنامههای Android، AI Studio یک پروژه Kotlin و Jetpack Compose تولید میکند که میتوانید آن را در شبیهساز مبتنی بر مرورگر پیشدید کنید، در دستگاه فیزیکی نصب کنید، و برای آزمایش در «فروشگاه Play» منتشر کنید. درباره ساختن برنامههای Android بیشتر بدانید.
با انتخاب برگه کد در قاب پیشنمایش سمت راست، میتوانید کد تولیدشده را مشاهده کنید. عامل Antigravity بهطور هوشمندانه چندین فایل را در پشته شما مدیریت میکند و اطمینان میدهد که تغییرات بهدرستی منتشر میشوند.
عامل Antigravity
عامل Antigravity عملکرد اصلی هوش مصنوعی در Google Antigravity است و اکنون مؤلفههای اصلی زیرساخت عامل، تجربه حالت «ساخت» را در Google AI Studio تقویت میکند. این ابزار با حفظ بافت کل پروژه شما، مدیریت چندین فایل، و درک دستورالعملهای پیچیده برای ساختن برنامههای تمامپشتهای قوی، فراتر از تولید کد ساده عمل میکند.
قابلیتهای کلیدی عبارتاند از:
- آگاهی از بافت: بافت پیاموارههای قبلی و وضعیت فایلها را حفظ میکند.
- مدیریت چندفایلی: وابستگیها را در چندین فایل مدیریت میکند.
- اجرای درستیسنجیشده: بهروزرسانیهای کد را درستیسنجی میکند تا کژپنداریها را کاهش دهد.
قابلیتهای پشته کامل
Google AI Studio قدرت بومسازگان وب مدرن را باز میکند و به شما امکان میدهد بیشتر از نمونههای اولیه سمت کارخواه بسازید.
- زمان اجرای سمت سرور و npm: از کتابخانه وسیع بستههای npm استفاده کنید. نماینده بهطور خودکار بستههای موردنیاز برای برنامهتان را شناسایی و نصب میکند (مثلاً کتابخانههای خاص برای تجسم دادهها یا کارخواههای میانای برنامهسازی کاربردی). همچنین میتوانید درصورت تمایل، بستههای خاصی را درخواست کنید.
- مدیریت اطلاعات محرمانه: کلیدهای میانای برنامهسازی کاربردی و اطلاعات محرمانه را بهطور ایمن در منو تنظیمات ذخیره کنید. این کلیدها در کد سمت سرور شما قابلدسترسی هستند و از قرار گرفتن درمعرض دید سمت کارخواه محافظت میشوند.
- چندبازیکنه: تجربههای مشارکتی همزمان را مستقیماً در AI Studio بسازید. زمان اجرای سمت سرور، وضعیت و اتصالات لازم برای تعامل کاربران با یکدیگر را مدیریت میکند.
- Firebase Firestore و Authentication: بهطور خودکار Firebase را فراهم و راهاندازی میکند، ازجمله پایگاه داده Firestore (فضای ذخیرهسازی دادههای پایدار) و Firebase Authentication (جریانهای ورود به سیستم، بهویژه «ورود به سیستم با Google»). نماینده کل فرایند راهاندازی را مدیریت میکند و حتی کد این سرویسها را در برنامه شما مینویسد.
- ادغامهای Google Workspace: برنامهتان را به میاناهای برنامهسازی کاربردی Google Workspace مثل Gmail، «کاربرگنگار»، «سندنگار»، Drive، «تقویم»، و غیره متصل کنید. AI Studio همه پیکربندیهای OAuth را بهطور خودکار انجام میدهد.
درباره توسعه برنامههای فولاستک بیشتر بدانید
Android Apps
همچنین میتوانید بااستفاده از Kotlin و Jetpack Compose، برنامههای Android بومی بسازید. برنامهتان را در شبیهساز Android مبتنی بر مرورگر پیشدید کنید، آن را بااستفاده از ADB در مرورگر در دستگاه فیزیکی نصب کنید، و برای آزمایش داخلی در «فروشگاه Play» منتشر کنید.
AI Studio همچنین با Firebase برای برنامههای Android ادغام میشود تا بهطور خودکار Firebase AI Logic و بررسی برنامه Firebase (برای تماسهای امن Gemini API سمت کارخواه بدون افشای کلیدهای API خام)، و همچنین Cloud Firestore و اصالتسنجی Firebase را فراهم کند.
درباره ساختن برنامههای Android بیشتر بدانید
ادامه ساختن
وقتی Google AI Studio کد اولیه را برای برنامهتان تولید کرد، میتوانید به پالایش آن ادامه دهید:
ساختن در Google AI Studio
- تکرار کردن با Gemini: از پانل گپ در حالت ساخت استفاده کنید تا از Gemini بخواهید تغییراتی ایجاد کند، ویژگیهای جدید اضافه کند، یا سبک را تغییر دهد.
- ویرایش مستقیم کد: برگه کد را در پانل پیشنمایش باز کنید تا ویرایشهای زنده انجام دهید.
توسعه خارجی
برای گردش کارهای پیشرفتهتر، میتوانید کد را همگامسازی یا صادر کنید تا در محیط دلخواهتان کار کنید:
- همگامسازی با GitHub: برنامهتان را به مخزن GitHub متصل کنید تا همگامسازی دوطرفه فعال شود. میتوانید تغییرات درخواستشده در AI Studio را مستقیماً با پیامهای ثبت تولیدشده با هوش مصنوعی به مخزن خود ارسال کنید، یا تغییرات ایجادشده بهصورت محلی در IDE خود یا توسط همتیمیها را به AI Studio برگردانید. هرزمان خواستید میتوانید وضعیت همگامسازیتان را در برگه GitHub در «تنظیمات» مدیریت کنید.
- بارگیری و توسعه محلی: کد تولیدشده را بهصورت فایل ZIP صادر کنید و آن را به ویرایشگر کد خود وارد کنید.
ویژگیهای مهم
Google AI Studio شامل چندین ویژگی است که فرایند ساخت را بصری و شهودی میکند:
- ایجاد و تکرار کردن در برنامههای پشته کامل: برنامههای پشته کامل را فقط با یک پیامواره ایجاد کنید و ازطریق گپ یا حالت حاشیهنویسی تکرار کنید. حالت حاشیهنویسی به شما امکان میدهد هر بخشی از میانای کاربری برنامهتان را برجسته کنید و تغییر موردنظرتان را شرح دهید.
- همرسانی و استقرار برنامه: میتوانید ساختههایتان را با دیگران همرسانی کنید تا باهم همکاری کنید یا کارتان را بهنمایش بگذارید. هنگام همرسانی، فراخوانیهای میانای برنامهسازی کاربردی جزو حد استفاده شما حساب میشود. اگر از مدلهای پولی استفاده کنید، ممکن است هزینههایی اعمال شود. سپس وقتی برنامهتان آماده شد، آن را در Cloud Run مستقر کنید.
- گالری برنامه: «گالری برنامه» کتابخانهای تصویری از ایدههای پروژه ارائه میدهد. میتوانید کارهایی را که با Gemini امکانپذیر است مرور کنید، برنامهها را فوراً پیشدید کنید، و آنها را بازآمیزی کنید تا به نسخه خودتان تبدیل کنید.
استقرار یا بایگانی کردن برنامه
وقتی برنامهتان آماده شد، میتوانید آن را مستقر کنید:
Cloud Run: برنامهتان را بهعنوان سرویسی مقیاسپذیر مستقر کنید. ممکن است قیمتگذاری Google Cloud Run براساس میزان استفاده اعمال شود. برای کسب اطلاعات بیشتر درباره استقرار، به استقرار از Google AI Studio مراجعه کنید.
GitHub: پروژهتان را با مخزن GitHub جدید یا موجود همگامسازی کنید تا کد منبع را مدیریت کنید یا با همتیمیهایتان همکاری کنید.
محدودیتها
این بخش محدودیتهای فعلی حالت ساخت را در Google AI Studio فهرست میکند.
مدیریت کلید میانای برنامهسازی کاربردی
وقتی برنامه وب جدیدی ایجاد میکنید که از Gemini API استفاده میکند، AI Studio بهطور خودکار کلید Gemini API شما را بهعنوان یک راز در محیط سمت سرور برنامه پیکربندی میکند. میتوانید این کلید را در پانل اطلاعات محرمانه مشاهده و مدیریت کنید.
- راهاندازی خودکار:
GEMINI_API_KEYبرای شما راهاندازی میشود — برای شروع ساختن، به پیکربندی دستی نیازی نیست. - فقط سمت سرور: کلیدهای API به زمان اجرای سمت سرور تزریق میشوند و هرگز در کد سمت کارخواه گنجانده نمیشوند.
- برنامههای موجود: برای برنامههایی که قبلاز ۱۴ مه ۲۰۲۶ ساخته شدهاند، دفعه بعدی که ویژگیهای Gemini برنامه را اصلاح کنید، عامل بهطور خودکار ادغام Gemini API شما را به رویکرد توصیهشده سمت سرور ارتقا خواهد داد.
Android Apps
هنگام ساختن برنامههای Android، AI Studio بهجای کلید API خام از Firebase AI Logic و Firebase App Check استفاده میکند، بنابراین اطلاعات کاربری هرگز در APK شما جاسازی نمیشود.
استقرار خارج از Google AI Studio
- Cloud Run: وقتی از AI Studio در Cloud Run مستقر میکنید، کلید API شما بهطور ایمن در محیط سمت سرور گنجانده میشود. برنامه مستقرشده از کلید میانای برنامهسازی کاربردی شما برای همه تماسهای میانای برنامهسازی کاربردی Gemini کاربران استفاده خواهد کرد.
- بارگیری ZIP: اگر برنامهتان را بهصورت فایل ZIP بارگیری میکنید تا آن را در جای دیگری اجرا کنید، باید متغیر محیطی
GEMINI_API_KEYرا در محیط میزبانیتان راهاندازی کنید. ازآنجاییکه فراخوانیهای Gemini API برنامه شما از کد سمت سرور انجام میشود، کلید برای کاربران نهایی آشکار نمیشود.
خطا هنگام همرسانی برنامهها
اگر برنامهتان را همرسانی کنید و کاربر نهایی شما هنگام استفاده از نشانی وب همرسانیشده با خطای 403 دسترسی محدودشده مواجه شود، ممکن است بهدلیل یکی از موارد زیر باشد:
- افزونههای مرورگر: افزونههای حریم خصوصی مانند Privacy Badger ممکن است برنامه را مسدود کنند. برای جلوگیری از این خطا، افزونه را غیرفعال کنید.
- مشکلات ساخت: ممکن است مشکلی در کد فعلی وجود داشته باشد. از نماینده بخواهید «هرگونه مشکل ساخت را با کد فعلی برطرف کند» و سپس نشانی وب را دوباره همرسانی کنید.
پرسشگان
«ساختن در AI Studio» چیست؟
AI Studio Build پلاتفرمی است که طراحی شده تا شما را از یک پیامواره ساده به یک برنامه هوشوارهای آماده تولید بااستفاده از Gemini برساند. آنچه را که میخواهید با پیامواره بسازید شرح دهید تا Gemini برنامهای برای شما تولید کند. همچنین میتوانید گالری ما را کاوش کنید تا ببینید چه کارهایی با Gemini API امکانپذیر است و برنامهها را بازآمیزی کنید تا آنها را به سلیقه خودتان طراحی کنید.
Build چگونه کلید Gemini API من را مدیریت میکند؟
وقتی برنامه وبی ایجاد میکنید که از Gemini API استفاده میکند، AI Studio بهطور خودکار کلید Gemini API شما را بهعنوان یک راز سمت سرور تنظیم میکند. فراخوانیهای Gemini API برنامه شما بااستفاده از این کلید از کد سمت سرور انجام میشود، بنابراین هرگز در مرورگر نمایش داده نمیشود. میتوانید کلید میانای برنامهسازی کاربردی خود را در پانل اطلاعات محرمانه در «تنظیمات» مشاهده کنید. برای برنامههای Android، AI Studio از Firebase AI Logic و Firebase App Check برای برقراری تماسهای امن سمت کارخواه بدون جاسازی کلید میانای برنامهسازی کاربردی در باینری برنامه استفاده میکند.
آیا کلید میانای API من هنگام همرسانی برنامهها فاش میشود؟
نه. کلید میانای برنامهسازی کاربردی شما بهعنوان یک راز سمت سرور ذخیره میشود و هرگز در کد سمت کارخواه گنجانده نمیشود. وقتی برنامهتان را همرسانی میکنید، کاربران دیگر میتوانند از آن استفاده کنند، اما نمیتوانند کلید API شما را ببینند.
هنگام همرسانی برنامههایتان با دیگران، فراخوانیهای API در محدودیتهای استفاده شما لحاظ میشود. اگر از مدلهای پولی استفاده کنید، ممکن است هزینههایی اعمال شود. AI Studio درطول راهاندازی و قبلاز همرسانی کردن، به شما هشدار میدهد که آیا برنامهتان ممکن است هزینهای داشته باشد یا نه.
چه کسی میتواند برنامههای من را ببیند؟
برنامهتان بهطور پیشفرض خصوصی است. میتوانید برنامهتان را با کاربران دیگر همرسانی کنید تا به آنها اجازه دهید از آن استفاده کنند. کاربرانی که برنامهتان را با آنها همرسانی میکنید میتوانند کد آن را ببینند و آن را برای اهداف خودشان منشعب کنند. اگر برنامهتان را با اجازه ویرایش همرسانی کنید، کاربران دیگر میتوانند کد برنامهتان را ویرایش کنند.
آیا میتوانم برنامهها را خارج از AI Studio اجرا کنم؟
بله. میتوانید برنامهتان را از AI Studio در
Cloud Run مستقر کنید، که
به برنامهتان نشانی وب عمومی میدهد و کلید میانای برنامهسازی کاربردی شما را بهطور ایمن در
محیط سمت سرور پیکربندی میکند. همچنین میتوانید برنامهتان را بهصورت فایل ZIP بارگیری کنید و
آن را در جای دیگری میزبانی کنید — باید متغیر محیطی GEMINI_API_KEY را
در محیط میزبانیتان تنظیم کنید. ازآنجاییکه فراخوانیهای Gemini API از کد سمت سرور انجام میشود، کلید شما ایمن میماند.
برای کسب اطلاعات بیشتر درباره گزینههای استقرار، به استقرار از Google AI Studio مراجعه کنید.
آیا میتوانم برنامهها را بهطور محلی با ابزارهای خودم توسعه دهم و سپس آنها را در اینجا همرسانی کنم؟
بله. میتوانید برنامه AI Studio خود را به یک مخزن GitHub متصل کنید تا بهصورت محلی بااستفاده از ویرایشگر کد یا ابزارهای CLI دلخواهتان توسعه دهید، تغییرات خود را به GitHub ارسال کنید، و سپس آن بهروزرسانیها را مستقیماً بااستفاده از برگه GitHub در «تنظیمات» به AI Studio برگردانید.
چگونه میتوانم از پایگاه داده یا فضای ذخیرهسازی دیگری با برنامههایم استفاده کنم؟
برنامههای AI Studio برنامههای استانداردی هستند که در محتوی Cloud Run اجرا میشوند. میتوانید از هر راهکار ذخیرهسازی که میتوانید ازطریق شبکه به آن متصل شوید استفاده کنید، بهشرطی که دیوار آتشی وجود نداشته باشد که از دسترسی ازطریق محدوده IP پویا جلوگیری کند.
درحال کار روی افزودن پشتیبانی مستقیم برای فضای ذخیرهسازی در آینده هستیم که میتوانید آن را مستقیماً در AI Studio پیکربندی کنید.
چگونه میتوانم به میکروفون، وببین، و دیگر میاناهای برنامهسازی کاربردی Navigator دسترسی داشته باشم؟
برای اطمینان از اینکه بینندگان از استفاده برنامه از وببین یا دستگاههای دیگرشان مطلع هستند، قبلاز اینکه برنامه بتواند به این میاناهای برنامهسازی کاربردی Navigator دسترسی پیدا کند، تأییدیه اضافی درخواست میکنیم.
سازندگان برنامه میتوانند این درخواستهای اجازه را به فایل
metadata.json برنامهشان اضافه کنند. برای مثال:
{
"name": "My app",
"requestFramePermissions": [
"microphone",
"camera",
"display-capture",
"geolocation",
"bluetooth",
"clipboard-read",
"serial",
"usb"
]
}
مقادیر پشتیبانیشده برای requestFramePermissions زیرمجموعهای از
ویژگیهای استاندارد کنترلشده با خطمشی است.
چگونه میتوانم از GitHub با برنامههایم استفاده کنم؟
AI Studio از همگامسازی دوطرفه با GitHub پشتیبانی میکند:
- وارد کردن مخزن: در حالت «ساخت»، وارد کردن از GitHub را از منو افزودن فایلها (نماد +) در چارگوش ورودی پیامواره انتخاب کنید تا کد موجود را وارد کنید.
- پیوند دادن مخزن: در «تنظیمات»، برگه GitHub را باز کنید تا مخزن GitHub جدیدی از برنامهتان ایجاد کنید یا به مخزن موجودی پیوند دهید.
- همگامسازی دوطرفه: تغییرات درخواستشده در AI Studio را مستقیماً با پیامهای ثبت هوش مصنوعی تولیدشده به مخزن خود ارسال کنید، یا تغییرات ایجادشده بهصورت خارجی (مانند ویرایشهای IDE محلی یا درخواستهای ارسال همتیمی) را به AI Studio برگردانید.
- حلوفصل تداخلهای ادغام: اگر هنگام همگامسازی با GitHub تداخلی در تغییرات وجود داشته باشد، AI Studio کادر گفتگوی حلوفصل تداخلها را با نمایشگر تفاوتهای پهلوبهپهلو ارائه میدهد که به شما امکان میدهد تفاوتها را بررسی کنید و انتخاب کنید که نسخه AI Studio یا GitHub برای هر فایل تداخلی حفظ شود.
آیا میتوانم به کاربران دیگر دسترسی ویرایش به برنامهام بدهم؟
AI Studio از ویرایش مشارکتی همزمان مستقیم پشتیبانی نمیکند. بااینحال، میتوانید با پیوند دادن برنامهتان به یک مخزن GitHub مشترک، با همتیمیهایتان مشارکت کنید. همتیمیها میتوانند تغییرات را در GitHub ارسال کنند یا درخواستهای واکشی را باز کنند، و شما میتوانید این بهروزرسانیها را به AI Studio واکشی کنید.
چرا برنامهام بهدلیل نقض خطمشی پرچمگذاری شده است؟
ما سیستمهایی داریم که بهطور خودکار برنامهها را بازبینی میکنند تا مطمئن شویم که از خطمشیهای ما پیروی میکنند. اگر متوجه شویم که برنامهای خطمشیهای ما را نقض میکند، آن برنامه از AI Studio برداشته خواهد شد. موارد نقض خطمشی میتواند شامل موارد زیر باشد، اما به آنها محدود نیست:
- برنامههایی که حاوی بدافزار، رمزگیری، یا جعل هویت هستند
- برنامههایی که محتوای ناقض خطمشی تصاویر کودکآزاری جنسی را نمایش یا توزیع میکنند
- برنامههایی که محتوای ناقض خطمشی آزار را نمایش یا توزیع میکنند
- برنامههایی که محتوای ناقض خطمشی سخنان مشوق عداوت و تنفر را نمایش یا توزیع میکنند
- برنامههایی که محتوای ناقض خطمشی قاچاق انسان را نمایش یا توزیع میکنند
- برنامههایی که محتوای ناقض خطمشی محتوای صریح جنسی را نمایش یا توزیع میکنند
- برنامههایی که محتوای ناقض خطمشی خشونت و خونریزی را نمایش میدهند یا توزیع میکنند
- برنامههایی که محتوای ناقض خطمشی محتوای مضر یا خطرناک را نمایش میدهند یا توزیع میکنند
اگر برنامهتان بهدلیل نقض خطمشی پرچمگذاری شده است و فکر میکنید اشتباهی رخ داده است، میتوانید فرم پژوهشخواهی ارسال کنید. نقض مکرر خطمشیهای ما ممکن است منجر به فسخ دسترسی شما به AI Studio شود.
مسئولیتهای من بهعنوان توسعهدهنده نرمافزار چیست؟
یادآوری میکنیم که بهعنوان مالک برنامهتان، مسئول رفتار آن و همه دادههایی هستید که مدیریت میکند. ازجمله:
- رعایت استانداردهای قانونی و حقوق طرف سوم: اطمینان از اینکه برنامهتان از همه قوانین و مقررات ذیربط تبعیت میکند و حقوق دیگران، ازجمله حقوق مالکیت فکری و حریم خصوصی، را نقض نمیکند.
- پایش محتوا: ممکن است رعایت شرایط اضافی برای سرویسهای دیگری که برنامهتان استفاده میکند اعمال شود. برای مثال، شرایط خدمات Google Cloud که برای Firestore اعمال میشود، از مشتریانی که محتوای شخص ثالث را میزبانی میکنند میخواهد خطمشیهایی را منتشر کنند که محتوای ممنوعه (مثلاً محتوای غیرقانونی) را تعریف میکند و وجود چنین محتوای غیرقانونیای را پایش کنند.
- پیادهسازی ایمن: پیادهسازی اقدامات حفاظتی لازم و ابزارهای تعدیل برای جلوگیری از سوءاستفاده از برنامهتان.
از محدودیتهای استفاده در «شرایط خدمات» مطلع باشید.
چه شرایطی برای برنامههای موجود در گالری برنامه در AI Studio اعمال میشود؟
شرایط خدمات اضافی Gemini API بر استفاده از برنامههای ویژه در گالری برنامه در AI Studio اعمال میشود، مگراینکه بهگونه دیگری ذکر شده باشد.
قدم بعدی چیست
- توسعه برنامههای Full-Stack (وب)
- ساختن برنامههای Android
- نمونهها را در گالری برنامه ببینید.