این صفحه نحوه استفاده از Google AI Studio را برای ساخت سریع (یا "کد vibe") و استقرار برنامههایی که آخرین قابلیتهای Gemini مانند Nano Banana و Live API را آزمایش میکنند، شرح میدهد. Google AI Studio از ساخت برنامههای وب با زمانهای اجرای کامل و برنامههای بومی اندروید با Kotlin و Jetpack Compose پشتیبانی میکند - همه از طریق فراخوانی زبان طبیعی.
شروع کنید
کدنویسی وایبر را در حالت ساخت (Build mode) در Google AI Studio شروع کنید. میتوانید از چند طریق شروع به ساخت کنید:
- با یک درخواست شروع کنید : در حالت ساخت، از کادر ورودی برای وارد کردن توضیحی از آنچه میخواهید بسازید استفاده کنید. برای افزودن ویژگیهای خاص مانند تولید تصویر یا دادههای نقشههای گوگل به درخواست خود، تراشههای هوش مصنوعی را انتخاب کنید. حتی میتوانید با استفاده از دکمه تبدیل گفتار به متن، آنچه را که میخواهید بگویید.
- دکمهی «خوششانس هستم» : اگر به یک جرقهی خلاقانه نیاز دارید، از دکمهی «خوششانس هستم» استفاده کنید و Gemini یک ایدهی پروژه برای شروع به شما ارائه میدهد.
- ریمیکس کردن یک پروژه از گالری : یک پروژه را از گالری برنامه باز کنید و کپی برنامه را انتخاب کنید.
پس از اجرای اعلان، خواهید دید که کد و فایلهای لازم تولید میشوند و پیشنمایش زندهای از برنامه شما در سمت راست ظاهر میشود.
چه چیزی ایجاد شده است؟
وقتی اعلان خود را اجرا میکنید، AI Studio یک برنامه کامل ایجاد میکند. میتوانید با استفاده از انتخابگر پلتفرم، یک برنامه وب یا یک برنامه بومی اندروید بسازید.
برای برنامههای وب (پیشفرض)، AI Studio یک محیط فولاستک ایجاد میکند که شامل موارد زیر است:
- سمت کلاینت : یک رابط کاربری وب (به صورت پیشفرض React است).
- سمت سرور : یک محیط اجرایی Node.js که امکان فراخوانیهای امن API، اتصالات پایگاه داده و استفاده از بسته npm را فراهم میکند.
برای برنامههای اندروید ، AI Studio یک پروژه Kotlin و Jetpack Compose ایجاد میکند که میتوانید آن را در یک شبیهساز مبتنی بر مرورگر پیشنمایش کنید، روی یک دستگاه فیزیکی نصب کنید و برای آزمایش در فروشگاه Play منتشر کنید. درباره ساخت برنامههای اندروید بیشتر بدانید .
شما میتوانید کدی را که تولید میشود با انتخاب تب Code در پنل پیشنمایش سمت راست مشاهده کنید. Antigravity Agent به طور هوشمندانه چندین فایل را در سراسر پشته شما مدیریت میکند و اطمینان حاصل میکند که تغییرات به درستی اعمال میشوند.
عامل ضد جاذبه
عامل ضد جاذبه (Antigravity Agent) عملکرد اصلی هوش مصنوعی در Google Antigravity است و اکنون اجزای اصلی مهار عامل، تجربه حالت ساخت (Build mode) را در Google AI Studio تقویت میکند. این عامل با حفظ زمینه کل پروژه شما، مدیریت چندین فایل و درک دستورالعملهای پیچیده برای ساخت برنامههای قوی و کامل، فراتر از تولید کد ساده عمل میکند.
قابلیتهای کلیدی عبارتند از:
- آگاهی از متن : متن درخواستهای قبلی و وضعیت فایلها را حفظ میکند.
- مدیریت چند فایلی : وابستگیها را در چندین فایل مدیریت میکند.
- اجرای تأیید شده : بهروزرسانیهای کد را برای کاهش توهمات تأیید میکند.
قابلیتهای فولاستک
گوگل هوش مصنوعی استودیو قدرت اکوسیستم وب مدرن را آزاد میکند و به شما امکان میدهد چیزی بیش از نمونههای اولیه سمت کلاینت بسازید.
- زمان اجرای سمت سرور و npm : از کتابخانه عظیم بستههای npm استفاده کنید. عامل به طور خودکار بستههای مورد نیاز برنامه شما را شناسایی و نصب میکند (مثلاً کتابخانههای خاص برای تجسم دادهها یا کلاینتهای API). همچنین میتوانید در صورت تمایل بستههای خاصی را درخواست کنید.
- مدیریت اسرار : کلیدها و اسرار API را به طور ایمن در منوی تنظیمات ذخیره کنید. این موارد در کد سمت سرور شما قابل دسترسی هستند و آنها را از افشای سمت کلاینت در امان نگه میدارند.
- چند نفره : تجربیات مشارکتی بلادرنگ را مستقیماً در استودیوی هوش مصنوعی بسازید. زمان اجرای سمت سرور، وضعیت و اتصالات مورد نیاز برای تعامل کاربران با یکدیگر را مدیریت میکند.
- Firebase Firestore و احراز هویت : به طور خودکار Firebase، از جمله پایگاه داده Firestore (ذخیره سازی داده های پایدار) و احراز هویت Firebase (جریان های ورود به سیستم، به ویژه "ورود با گوگل") را تهیه و تنظیم می کند. عامل کل فرآیند راه اندازی را مدیریت می کند و حتی کد را در برنامه شما برای این سرویس ها می نویسد.
- ادغام با Google Workspace : برنامه خود را به APIهای Google Workspace مانند Gmail، Sheets، Docs، Drive، Calendar و موارد دیگر متصل کنید. AI Studio تمام پیکربندی OAuth را به طور خودکار انجام میدهد.
درباره توسعه برنامههای فولاستک بیشتر بدانید
برنامههای اندروید
همچنین میتوانید با استفاده از Kotlin و Jetpack Compose برنامههای بومی اندروید بسازید. برنامه خود را در یک شبیهساز اندروید مبتنی بر مرورگر پیشنمایش کنید، آن را با استفاده از ADB در مرورگر روی یک دستگاه فیزیکی نصب کنید و برای آزمایش داخلی در فروشگاه Play منتشر کنید.
درباره ساخت اپلیکیشن اندروید بیشتر بدانید
ادامه ساخت و ساز
زمانی که Google AI Studio کد اولیه برنامه شما را تولید کرد، میتوانید آن را اصلاح کنید:
ساخت در استودیوی هوش مصنوعی گوگل
- تکرار با Gemini : از پنل چت در حالت ساخت استفاده کنید تا از Gemini بخواهید اصلاحاتی انجام دهد، ویژگیهای جدیدی اضافه کند یا ظاهر را تغییر دهد.
- ویرایش مستقیم کد : برای انجام ویرایشهای زنده، تب کد را در پنل پیشنمایش باز کنید.
توسعه بیرونی
برای گردشهای کاری پیشرفتهتر، میتوانید کد را اکسپورت کنید و در محیط دلخواه خود کار کنید:
- دانلود و توسعه محلی : کد تولید شده را به صورت یک فایل ZIP صادر کرده و آن را در ویرایشگر کد خود وارد کنید.
- ارسال به گیتهاب : با ارسال کد به یک مخزن گیتهاب، آن را با فرآیندهای توسعه و استقرار موجود خود ادغام کنید.
ویژگیهای کلیدی
استودیوی هوش مصنوعی گوگل شامل چندین ویژگی است که فرآیند ساخت را بصری و شهودی میکند:
- ایجاد و تکرار برنامههای فولاستک : برنامههای فولاستک را فقط با یک اعلان ایجاد کنید و از طریق چت یا حالت حاشیهنویسی تکرار کنید. حالت حاشیهنویسی به شما امکان میدهد هر بخشی از رابط کاربری برنامه خود را برجسته کرده و تغییر مورد نظر خود را شرح دهید.
- اشتراکگذاری و استقرار برنامه : میتوانید ساختههای خود را با دیگران به اشتراک بگذارید تا با آنها همکاری کنید یا کار خود را به نمایش بگذارید. هنگام اشتراکگذاری، فراخوانیهای API جزو محدودیتهای استفاده شما محسوب میشوند. اگر از مدلهای پولی استفاده میکنید، ممکن است هزینههایی اعمال شود. سپس وقتی برنامه شما آماده شد، آن را روی Cloud Run مستقر کنید.
- گالری برنامهها : گالری برنامهها یک کتابخانه بصری از ایدههای پروژه ارائه میدهد. میتوانید با Gemini امکانات را مرور کنید، فوراً پیشنمایش برنامهها را ببینید و آنها را با هم ترکیب کنید تا به سبک خودتان درآیند.
برنامه خود را مستقر یا بایگانی کنید
وقتی برنامه شما آماده شد، میتوانید آن را مستقر کنید:
Cloud Run : برنامه خود را به عنوان یک سرویس مقیاسپذیر مستقر کنید. قیمتگذاری Google Cloud Run ممکن است بر اساس میزان استفاده اعمال شود. برای کسب اطلاعات بیشتر در مورد استقرار، به Deploying from Google AI Studio مراجعه کنید.
GitHub : پروژه خود را به یک مخزن GitHub صادر کنید.
محدودیتها
این بخش محدودیتهای فعلی حالت ساخت در Google AI Studio را فهرست میکند.
مدیریت کلید API
وقتی یک برنامه جدید ایجاد میکنید که از API Gemini استفاده میکند، AI Studio به طور خودکار کلید API Gemini شما را به عنوان یک راز در محیط سمت سرور برنامه پیکربندی میکند. میتوانید این کلید را در پنل اسرار مشاهده و مدیریت کنید.
- راهاندازی خودکار :
GEMINI_API_KEYشما برای شما راهاندازی شده است — برای شروع ساخت، نیازی به پیکربندی دستی نیست. - فقط سمت سرور : کلیدهای API به زمان اجرای سمت سرور تزریق میشوند و هرگز در کد سمت کلاینت گنجانده نمیشوند.
- برنامههای موجود : برای برنامههایی که قبل از ۱۴ مه ۲۰۲۶ ساخته شدهاند، دفعه بعد که ویژگیهای Gemini برنامه را تغییر میدهید، عامل به طور خودکار ادغام API Gemini شما را به رویکرد سمت سرور توصیه شده ارتقا میدهد.
استقرار خارج از استودیوی هوش مصنوعی گوگل
- Cloud Run : وقتی از طریق AI Studio به Cloud Run منتقل میشوید، کلید API شما به صورت امن در محیط سمت سرور قرار میگیرد. برنامهی مستقر شده از کلید API شما برای تمام فراخوانیهای API Gemini کاربران استفاده خواهد کرد.
- دانلود فایل زیپ : اگر برنامه خود را به صورت فایل زیپ دانلود کنید تا در جای دیگری اجرا شود، باید متغیر محیطی
GEMINI_API_KEYرا در محیط میزبانی خود تنظیم کنید. از آنجایی که فراخوانیهای API Gemini برنامه شما از کد سمت سرور انجام میشود، کلید در معرض دید کاربران نهایی قرار نمیگیرد.
خطا هنگام اشتراک گذاری برنامه ها
اگر برنامه خود را به اشتراک میگذارید و کاربر نهایی شما هنگام استفاده از URL مشترک با خطای ۴۰۳ Access Restricted مواجه میشود، ممکن است به دلیل یکی از موارد زیر باشد:
- افزونههای مرورگر : افزونههای حریم خصوصی مانند Privacy Badger ممکن است برنامه را مسدود کنند. برای جلوگیری از خطا، افزونه را غیرفعال کنید.
- مشکلات ساخت : ممکن است مشکلاتی در کد فعلی وجود داشته باشد. از نماینده بخواهید که "هرگونه مشکل ساخت با کد فعلی را برطرف کند" و سپس URL را دوباره به اشتراک بگذارد.
سوالات متداول
ساخت در استودیوی هوش مصنوعی چیست؟
AI Studio Build پلتفرمی است که برای رساندن شما از یک دستور ساده به یک برنامهی آمادهی تولید مبتنی بر هوش مصنوعی با استفاده از Gemini طراحی شده است. آنچه را که میخواهید بسازید با یک دستور توضیح دهید و Gemini یک برنامه برای شما تولید میکند. همچنین میتوانید گالری ما را بررسی کنید تا ببینید با API Gemini چه امکاناتی میتوانید داشته باشید و برنامهها را با هم ترکیب کنید تا آنها را به برنامهی خودتان تبدیل کنید.
Build چگونه کلید API جمینی من را مدیریت میکند؟
وقتی برنامهای ایجاد میکنید که از Gemini API استفاده میکند، AI Studio بهطور خودکار کلید Gemini API شما را بهعنوان یک راز سمت سرور تنظیم میکند. فراخوانیهای Gemini API برنامه شما از کد سمت سرور با استفاده از این کلید انجام میشود، بنابراین هرگز در مرورگر نمایش داده نمیشود. میتوانید کلید API خود را در پنل Secrets در تنظیمات مشاهده کنید.
آیا کلید API من هنگام اشتراکگذاری برنامهها افشا میشود؟
خیر. کلید API شما به عنوان یک راز سمت سرور ذخیره میشود و هرگز در کد سمت کلاینت گنجانده نمیشود. وقتی برنامه خود را به اشتراک میگذارید، سایر کاربران میتوانند از آن استفاده کنند، اما نمیتوانند کلید API شما را ببینند.
هنگام اشتراکگذاری برنامههایتان با دیگران، فراخوانیهای API جزو محدودیتهای استفاده شما محسوب میشوند. اگر از مدلهای پولی استفاده میکنید، ممکن است هزینههایی اعمال شود. AI Studio در طول راهاندازی و قبل از اشتراکگذاری، در صورت وجود هزینه برای برنامهتان، به شما هشدار میدهد.
چه کسی میتواند برنامههای من را ببیند؟
به طور پیشفرض برنامه شما خصوصی است. میتوانید برنامه خود را با سایر کاربران به اشتراک بگذارید تا به آنها اجازه استفاده از آن را بدهید. کاربرانی که برنامه خود را با آنها به اشتراک میگذارید میتوانند کد آن را ببینند و آن را برای اهداف خود تغییر دهند. اگر برنامه خود را با اجازه ویرایش به اشتراک بگذارید، سایر کاربران میتوانند کد برنامه شما را ویرایش کنند.
آیا میتوانم برنامهها را خارج از AI Studio اجرا کنم؟
بله. میتوانید برنامه خود را از طریق AI Studio روی Cloud Run مستقر کنید، که به برنامه شما یک URL عمومی با کلید API شما که به طور ایمن در محیط سمت سرور پیکربندی شده است، میدهد. همچنین میتوانید برنامه خود را به صورت یک فایل ZIP دانلود کرده و در جای دیگری میزبانی کنید - باید متغیر محیطی GEMINI_API_KEY را در محیط میزبانی خود تنظیم کنید. از آنجایی که فراخوانیهای API Gemini از کد سمت سرور انجام میشود، کلید شما ایمن میماند.
برای کسب اطلاعات بیشتر در مورد گزینههای استقرار، به استقرار از Google AI Studio مراجعه کنید.
آیا میتوانم با ابزارهای خودم به صورت محلی برنامهها را توسعه دهم و سپس آنها را اینجا به اشتراک بگذارم؟
این قابلیت هنوز در دسترس نیست. ما مشتاقیم که در آینده از موارد استفاده بیشتری برای برنامهها پشتیبانی کنیم. لطفاً اگر مورد خاصی مد نظر دارید، بازخورد خود را با ما در میان بگذارید.
چگونه میتوانم از یک پایگاه داده یا فضای ذخیرهسازی دیگر با برنامههایم استفاده کنم؟
برنامههای AI Studio برنامههای استانداردی هستند که در یک کانتینر Cloud Run اجرا میشوند. شما میتوانید از هر راهکار ذخیرهسازی که بتوانید از طریق شبکه به آن متصل شوید، استفاده کنید، البته تا زمانی که فایروالی وجود نداشته باشد که مانع دسترسی از یک محدوده IP پویا شود.
ما در حال کار بر روی اضافه کردن پشتیبانی مستقیم برای ذخیرهسازی در آینده هستیم که میتوانید آن را مستقیماً در AI Studio پیکربندی کنید.
چگونه میتوانم به میکروفون، وبکم و سایر APIهای Navigator دسترسی پیدا کنم؟
برای اطمینان از اینکه بینندگان از استفاده یک برنامه از وبکم یا سایر دستگاههایشان آگاه هستند، قبل از اینکه برنامه بتواند به این APIهای Navigator دسترسی پیدا کند، به یک تأیید اضافی نیاز داریم. سازندگان برنامه میتوانند این درخواستهای مجوز را به فایل metadata.json برنامه خود اضافه کنند. به عنوان مثال:
{
"name": "My app",
"requestFramePermissions": [
"microphone",
"camera",
"display-capture",
"geolocation",
"bluetooth",
"clipboard-read",
"serial",
"usb"
]
}
مقادیر پشتیبانیشده برای requestFramePermissions زیرمجموعهای از ویژگیهای استاندارد کنترلشده توسط سیاست هستند.
چگونه میتوانم از گیتهاب با برنامههایم استفاده کنم؟
ادغام GitHub در AI Studio به شما امکان میدهد یک مخزن برای کار خود ایجاد کنید و آخرین تغییرات خود را ثبت کنید. ما در حال حاضر از دریافت تغییرات از راه دور پشتیبانی نمیکنیم.
آیا میتوانم به کاربران دیگر دسترسی ویرایش برنامهام را بدهم؟
این هنوز پشتیبانی نمیشود، اما به زودی اضافه خواهد شد.
چرا برنامه من به دلیل نقض خطمشی علامتگذاری شد؟
ما سیستمهایی داریم که بهطور خودکار برنامهها را بررسی میکنند تا از مطابقت آنها با سیاستهای ما اطمینان حاصل شود. اگر متوجه شویم که یک برنامه سیاستهای ما را نقض میکند، برنامه از AI Studio حذف خواهد شد. نقض سیاستها میتواند شامل موارد زیر باشد، اما محدود به آنها نیست:
- برنامههایی که حاوی بدافزار، فیشینگ یا جعل هویت هستند
- برنامههایی که محتوایی را نمایش میدهند یا توزیع میکنند که خطمشی تصاویر سوءاستفاده جنسی از کودکان را نقض میکند
- برنامههایی که محتوایی را نمایش میدهند یا توزیع میکنند که سیاست آزار و اذیت را نقض میکند
- برنامههایی که محتوایی را نمایش میدهند یا توزیع میکنند که سیاست نفرتپراکنی را نقض میکند
- برنامههایی که محتوایی را نمایش میدهند یا توزیع میکنند که سیاست قاچاق انسان را نقض میکند
- برنامههایی که محتوایی را نمایش میدهند یا توزیع میکنند که خطمشی محتوای صریح جنسی را نقض میکند
- برنامههایی که محتوایی را نمایش میدهند یا توزیع میکنند که ناقض قوانین خشونت و خونریزی است
- برنامههایی که محتوایی را نمایش میدهند یا توزیع میکنند که خطمشی مضر یا خطرناک را نقض میکند
اگر برنامه شما به دلیل نقض خطمشی علامتگذاری شده است و شما آن را اشتباه میدانید، میتوانید درخواست تجدیدنظر ارسال کنید. نقض مکرر خطمشیهای ما ممکن است منجر به قطع دسترسی شما به AI Studio شود.
مسئولیتهای من به عنوان یک توسعهدهنده اپلیکیشن چیست؟
به عنوان یادآوری، شما به عنوان مالک برنامه خود، مسئول رفتار آن و تمام دادههایی هستید که مدیریت میکند. این شامل موارد زیر میشود:
- انطباق با قوانین و حقوق اشخاص ثالث: اطمینان از اینکه برنامه شما با تمام قوانین و مقررات مربوطه مطابقت دارد و حقوق دیگران، از جمله حقوق مالکیت معنوی و حریم خصوصی را نقض نمیکند.
- نظارت بر محتوا: رعایت شرایط اضافی ممکن است برای سایر سرویسهای مورد استفاده برنامه شما اعمال شود. به عنوان مثال، شرایط خدمات Google Cloud که برای Firestore قابل اجرا است، مشتریانی را که میزبان محتوای شخص ثالث هستند، ملزم میکند تا سیاستهایی را منتشر کنند که مشخص کند چه محتوایی ممنوع است (مثلاً محتوای غیرقانونی) و وجود آن محتوای غیرقانونی را رصد کنند.
- پیادهسازی ایمن: پیادهسازی ابزارهای حفاظتی و مدیریتی لازم برای جلوگیری از سوءاستفاده از برنامه شما.
از محدودیتهای استفاده در شرایط خدمات آگاه باشید.
چه شرایطی برای برنامههای موجود در گالری برنامهها در AI Studio اعمال میشود؟
شرایط خدمات اضافی Gemini API برای استفاده از برنامههای نمایش داده شده در گالری برنامه در AI Studio اعمال میشود، مگر اینکه خلاف آن ذکر شده باشد.
قدم بعدی چیست؟
- توسعه برنامههای فولاستک (وب)
- ساخت برنامههای اندروید
- نمونهها را در گالری برنامه ببینید.