ساخت اپلیکیشن در گوگل هوش مصنوعی استودیو

این صفحه نحوه استفاده از Google AI Studio را برای ساخت سریع (یا "کد vibe") و استقرار برنامه‌هایی که آخرین قابلیت‌های Gemini مانند Nano Banana و Live API را آزمایش می‌کنند، شرح می‌دهد. Google AI Studio اکنون از زمان‌های اجرای کامل پشتیبانی می‌کند و به شما امکان می‌دهد برنامه‌های قوی با منطق سمت سرور، مدیریت امن اسرار و پشتیبانی از بسته npm، همه از طریق اعلان زبان طبیعی، بسازید.

شروع کنید

کدنویسی وایبر را در حالت ساخت (Build mode) در Google AI Studio شروع کنید. می‌توانید از چند طریق شروع به ساخت کنید:

  • با یک درخواست شروع کنید : در حالت ساخت، از کادر ورودی برای وارد کردن توضیحی از آنچه می‌خواهید بسازید استفاده کنید. برای افزودن ویژگی‌های خاص مانند تولید تصویر یا داده‌های نقشه‌های گوگل به درخواست خود، تراشه‌های هوش مصنوعی را انتخاب کنید. حتی می‌توانید با استفاده از دکمه تبدیل گفتار به متن، آنچه را که می‌خواهید بگویید.
  • دکمه‌ی «خوش‌شانس هستم» : اگر به یک جرقه‌ی خلاقانه نیاز دارید، از دکمه‌ی «خوش‌شانس هستم» استفاده کنید و Gemini یک ایده‌ی پروژه برای شروع به شما ارائه می‌دهد.
  • ریمیکس کردن یک پروژه از گالری : یک پروژه را از گالری برنامه باز کنید و کپی برنامه را انتخاب کنید.

پس از اجرای اعلان، خواهید دید که کد و فایل‌های لازم تولید می‌شوند و پیش‌نمایش زنده‌ای از برنامه شما در سمت راست ظاهر می‌شود.

چه چیزی ایجاد شده است؟

وقتی اعلان خود را اجرا می‌کنید، AI Studio یک برنامه کامل ایجاد می‌کند. به طور پیش‌فرض، یک محیط full-stack ایجاد می‌کند که می‌تواند شامل موارد زیر باشد:

  • سمت کلاینت : یک رابط کاربری وب (به صورت پیش‌فرض React است).
  • سمت سرور : یک محیط اجرایی Node.js که امکان فراخوانی‌های امن API، اتصالات پایگاه داده و استفاده از بسته npm را فراهم می‌کند.

شما می‌توانید کدی را که تولید می‌شود با انتخاب تب Code در پنل پیش‌نمایش سمت راست مشاهده کنید. Antigravity Agent به طور هوشمندانه چندین فایل را در سراسر پشته شما مدیریت می‌کند و اطمینان حاصل می‌کند که تغییرات به درستی اعمال می‌شوند.

عامل ضد جاذبه

عامل ضد جاذبه (Antigravity Agent) عملکرد اصلی هوش مصنوعی در Google Antigravity است و اکنون اجزای اصلی مهار عامل، تجربه حالت ساخت (Build mode) را در Google AI Studio تقویت می‌کند. این عامل با حفظ زمینه کل پروژه شما، مدیریت چندین فایل و درک دستورالعمل‌های پیچیده برای ساخت برنامه‌های قوی و کامل، فراتر از تولید کد ساده عمل می‌کند.

قابلیت‌های کلیدی عبارتند از:

  • آگاهی از متن : متن درخواست‌های قبلی و وضعیت فایل‌ها را حفظ می‌کند.
  • مدیریت چند فایلی : وابستگی‌ها را در چندین فایل مدیریت می‌کند.
  • اجرای تأیید شده : به‌روزرسانی‌های کد را برای کاهش توهمات تأیید می‌کند.

قابلیت‌های فول‌استک

گوگل هوش مصنوعی استودیو قدرت اکوسیستم وب مدرن را آزاد می‌کند و به شما امکان می‌دهد چیزی بیش از نمونه‌های اولیه سمت کلاینت بسازید.

  • زمان اجرای سمت سرور و npm : از کتابخانه عظیم بسته‌های npm استفاده کنید. عامل به طور خودکار بسته‌های مورد نیاز برنامه شما را شناسایی و نصب می‌کند (مثلاً کتابخانه‌های خاص برای تجسم داده‌ها یا کلاینت‌های API). همچنین می‌توانید در صورت تمایل بسته‌های خاصی را درخواست کنید.
  • مدیریت اسرار : کلیدها و اسرار API را به طور ایمن در منوی تنظیمات ذخیره کنید. این موارد در کد سمت سرور شما قابل دسترسی هستند و آنها را از افشای سمت کلاینت در امان نگه می‌دارند.
  • چند نفره : تجربیات مشارکتی بلادرنگ را مستقیماً در استودیوی هوش مصنوعی بسازید. زمان اجرای سمت سرور، وضعیت و اتصالات مورد نیاز برای تعامل کاربران با یکدیگر را مدیریت می‌کند.
  • یکپارچه‌سازی با فایربیس : به طور خودکار فایربیس، از جمله پایگاه داده فایراستور (ذخیره‌سازی داده‌های پایدار) و احراز هویت فایربیس (جریان‌های ورود به سیستم، به ویژه "ورود با گوگل") را آماده و راه‌اندازی می‌کند. عامل، کل فرآیند راه‌اندازی را مدیریت می‌کند و حتی کد مربوط به این سرویس‌ها را در برنامه شما می‌نویسد.

درباره توسعه برنامه‌های فول‌استک بیشتر بدانید

ادامه ساخت و ساز

زمانی که Google AI Studio کد اولیه برنامه شما را تولید کرد، می‌توانید آن را اصلاح کنید:

ساخت در استودیوی هوش مصنوعی گوگل

  • تکرار با Gemini : از پنل چت در حالت ساخت استفاده کنید تا از Gemini بخواهید اصلاحاتی انجام دهد، ویژگی‌های جدیدی اضافه کند یا ظاهر را تغییر دهد.
  • ویرایش مستقیم کد : برای انجام ویرایش‌های زنده، تب کد را در پنل پیش‌نمایش باز کنید.

توسعه بیرونی

برای گردش‌های کاری پیشرفته‌تر، می‌توانید کد را اکسپورت کنید و در محیط دلخواه خود کار کنید:

  • دانلود و توسعه محلی : کد تولید شده را به صورت یک فایل ZIP صادر کرده و آن را در ویرایشگر کد خود وارد کنید.
  • ارسال به گیت‌هاب : با ارسال کد به یک مخزن گیت‌هاب، آن را با فرآیندهای توسعه و استقرار موجود خود ادغام کنید.

ویژگی‌های کلیدی

استودیوی هوش مصنوعی گوگل شامل چندین ویژگی است که فرآیند ساخت را بصری و شهودی می‌کند:

  • ایجاد و تکرار برنامه‌های فول‌استک : برنامه‌های فول‌استک را فقط با یک اعلان ایجاد کنید و از طریق چت یا حالت حاشیه‌نویسی تکرار کنید. حالت حاشیه‌نویسی به شما امکان می‌دهد هر بخشی از رابط کاربری برنامه خود را برجسته کرده و تغییر مورد نظر خود را شرح دهید.
  • اشتراک‌گذاری و استقرار برنامه : می‌توانید ساخته‌های خود را با دیگران به اشتراک بگذارید تا با آنها همکاری کنید یا کار خود را به نمایش بگذارید. سپس وقتی برنامه شما آماده شد، آن را روی Cloud Run مستقر کنید.
  • گالری برنامه‌ها : گالری برنامه‌ها یک کتابخانه بصری از ایده‌های پروژه ارائه می‌دهد. می‌توانید با Gemini امکانات را مرور کنید، فوراً پیش‌نمایش برنامه‌ها را ببینید و آنها را با هم ترکیب کنید تا به سبک خودتان درآیند.

برنامه خود را مستقر یا بایگانی کنید

وقتی برنامه شما آماده شد، می‌توانید آن را مستقر کنید:

  • Google Cloud Run : برنامه خود را به عنوان یک سرویس مقیاس‌پذیر مستقر کنید. قیمت‌گذاری برای Google Cloud Run ممکن است بر اساس میزان استفاده اعمال شود.
  • GitHub : پروژه خود را به یک مخزن GitHub صادر کنید.

محدودیت‌ها

این بخش محدودیت‌های فعلی حالت ساخت در Google AI Studio را فهرست می‌کند.

امنیت کلید API

  • سمت کلاینت : هرگز از کلیدهای API واقعی مستقیماً در کد سمت کلاینت استفاده نکنید.
  • سمت سرور : از ویژگی مدیریت اسرار برای مدیریت ایمن کلیدهای حساس در زمان اجرای سمت سرور استفاده کنید.

استقرار خارج از استودیوی هوش مصنوعی گوگل

  • اگرچه می‌توانید برنامه خود را برای یک URL عمومی در Cloud Run مستقر کنید، اما این تنظیمات از کلید API شما برای فراخوانی‌های API Gemini همه کاربران استفاده خواهد کرد.
    • برنامه‌های جاوا اسکریپت سمت کلاینت اجرا می‌شوند، بنابراین اطمینان حاصل کنید که کلیدهای API فقط دسترسی حداقلی دارند تا از نشت داده‌ها یا سوءاستفاده جلوگیری شود. به عنوان مثال، سایر فروشگاه‌های جستجوی فایل از همان پروژه ممکن است از طریق این مکانیسم برای کاربران قابل دسترسی باشند.
  • استقرار خارجی امن: برای اجرای امن یک برنامه در خارج از AI Studio (مثلاً پس از دانلود فایل زیپ)، باید منطقی را که از کلید API استفاده می‌کند به یک جزء سمت سرور منتقل کنید تا از افشای کلید به کاربران نهایی جلوگیری شود. در صورت استقرار با استفاده از Cloud Run، نیازی به این کار نیست.
  • هشدار افشای کلید: جایگزینی ساده‌ی placeholder با یک کلید API واقعی در محیط سمت کلاینت اکیداً توصیه نمی‌شود، زیرا کلید برای هر کاربری قابل مشاهده خواهد بود.

خطا هنگام اشتراک گذاری برنامه ها

اگر برنامه خود را به اشتراک می‌گذارید و کاربر نهایی شما هنگام استفاده از URL مشترک با خطای ۴۰۳ Access Restricted مواجه می‌شود، ممکن است به دلیل یکی از موارد زیر باشد:

  • افزونه‌های مرورگر : افزونه‌های حریم خصوصی مانند Privacy Badger ممکن است برنامه را مسدود کنند. برای جلوگیری از خطا، افزونه را غیرفعال کنید.
  • مشکلات ساخت : ممکن است مشکلاتی در کد فعلی وجود داشته باشد. از نماینده بخواهید که "هرگونه مشکل ساخت با کد فعلی را برطرف کند" و سپس URL را دوباره به اشتراک بگذارد.

سوالات متداول

ساخت در استودیوی هوش مصنوعی چیست؟

AI Studio Build پلتفرمی است که برای رساندن شما از یک دستور ساده به یک برنامه‌ی آماده‌ی تولید مبتنی بر هوش مصنوعی با استفاده از Gemini طراحی شده است. آنچه را که می‌خواهید بسازید با یک دستور توضیح دهید و Gemini یک برنامه برای شما تولید می‌کند. همچنین می‌توانید گالری ما را بررسی کنید تا ببینید با API Gemini چه امکاناتی می‌توانید داشته باشید و برنامه‌ها را با هم ترکیب کنید تا آنها را به برنامه‌ی خودتان تبدیل کنید.

چرا Build، رابط برنامه‌نویسی Gemini را از کد سمت کلاینت فراخوانی می‌کند؟

معمولاً بهترین روش این است که API مربوط به Gemini را از سمت سرور فراخوانی کنید تا کلید API شما افشا نشود. اما AI Studio یک پروکسی API مربوط به Gemini برای فراخوانی‌های سمت کلاینت دارد که کلید API را بدون افشای آن در کد، ضمیمه می‌کند. در حال حاضر ما فراخوانی‌های سمت کلاینت را برای استفاده از این پروکسی ایجاد می‌کنیم، زیرا کد را ساده می‌کند و به شما امکان می‌دهد برنامه خود را بدون نیاز به ارائه کلید API با دیگران به اشتراک بگذارید.

آیا کلید API من هنگام اشتراک‌گذاری برنامه‌ها افشا می‌شود؟

از کلید API واقعی در برنامه خود استفاده نکنید. در عوض از یک مقدار جایگزین استفاده کنید. process.env.GEMINI_API_KEY روی یک مقدار جایگزین تنظیم شده است که می‌توانید از آن استفاده کنید. وقتی کاربر دیگری از برنامه شما استفاده می‌کند، AI Studio فراخوانی‌ها را به API Gemini پروکسی می‌کند و مقدار جایگزین را با کلید API کاربر (نه شما) جایگزین می‌کند. از کلید API واقعی در برنامه خود استفاده نکنید، زیرا کد برای هر کسی که می‌تواند برنامه شما را مشاهده کند قابل مشاهده است.

چه کسی می‌تواند برنامه‌های من را ببیند؟

به طور پیش‌فرض برنامه شما خصوصی است. می‌توانید برنامه خود را با سایر کاربران به اشتراک بگذارید تا به آنها اجازه استفاده از آن را بدهید. کاربرانی که برنامه خود را با آنها به اشتراک می‌گذارید می‌توانند کد آن را ببینند و آن را برای اهداف خود تغییر دهند. اگر برنامه خود را با اجازه ویرایش به اشتراک بگذارید، سایر کاربران می‌توانند کد برنامه شما را ویرایش کنند.

آیا می‌توانم برنامه‌ها را خارج از AI Studio اجرا کنم؟

می‌توانید برنامه خود را از طریق AI Studio روی Cloud Run مستقر کنید، که به برنامه شما یک URL عمومی می‌دهد. این برنامه به همراه یک سرور پروکسی مستقر می‌شود که کلید API شما را خصوصی نگه می‌دارد، با این حال برنامه مستقر شده از کلید API شما برای فراخوانی‌های API Gemini همه کاربران استفاده خواهد کرد. همچنین می‌توانید برنامه خود را به صورت یک فایل زیپ دانلود کنید. اگر مقدار placeholder را با یک کلید API واقعی جایگزین کنید، همچنان باید کار کند. اما نباید برنامه خود را به این شکل مستقر کنید، زیرا هر کاربری قادر به دیدن کلید API خواهد بود. برای اینکه یک برنامه به طور ایمن در خارج از AI Studio اجرا شود، نیاز به انتقال برخی از منطق‌های سمت سرور است، بنابراین کلید API دیگر در معرض دید قرار نمی‌گیرد.

آیا می‌توانم با ابزارهای خودم به صورت محلی برنامه‌ها را توسعه دهم و سپس آنها را اینجا به اشتراک بگذارم؟

این قابلیت هنوز در دسترس نیست. ما مشتاقیم که در آینده از موارد استفاده بیشتری برای برنامه‌ها پشتیبانی کنیم. لطفاً اگر مورد خاصی مد نظر دارید، بازخورد خود را با ما در میان بگذارید.

چگونه می‌توانم از یک پایگاه داده یا فضای ذخیره‌سازی دیگر با برنامه‌هایم استفاده کنم؟

برنامه‌های AI Studio برنامه‌های استانداردی هستند که در یک کانتینر Cloud Run اجرا می‌شوند. شما می‌توانید از هر راهکار ذخیره‌سازی که بتوانید از طریق شبکه به آن متصل شوید، استفاده کنید، البته تا زمانی که فایروالی وجود نداشته باشد که مانع دسترسی از یک محدوده IP پویا شود.

ما در حال کار بر روی اضافه کردن پشتیبانی مستقیم برای ذخیره‌سازی در آینده هستیم که می‌توانید آن را مستقیماً در AI Studio پیکربندی کنید.

برای اطمینان از اینکه بینندگان از استفاده یک برنامه از وب‌کم یا سایر دستگاه‌هایشان آگاه هستند، قبل از اینکه برنامه بتواند به این 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 قابل اجرا است، مشتریانی را که میزبان محتوای شخص ثالث هستند، ملزم می‌کند تا سیاست‌هایی را منتشر کنند که مشخص کند چه محتوایی ممنوع است (مثلاً محتوای غیرقانونی) و وجود آن محتوای غیرقانونی را رصد کنند.
  • پیاده‌سازی ایمن: پیاده‌سازی ابزارهای حفاظتی و مدیریتی لازم برای جلوگیری از سوءاستفاده از برنامه شما.

از محدودیت‌های استفاده در شرایط خدمات آگاه باشید.

شرایط خدمات اضافی Gemini API برای استفاده از برنامه‌های نمایش داده شده در گالری برنامه در AI Studio اعمال می‌شود، مگر اینکه خلاف آن ذکر شده باشد.

قدم بعدی چیست؟