Google AI Studio اکنون از توسعه پشته کامل پشتیبانی می‌کند و به شما امکان می‌دهد برنامه‌هایی بسازید که فراتر از نمونه‌های اولیه سمت کارخواه هستند. با زمان اجرای سمت سرور، می‌توانید اطلاعات محرمانه را مدیریت کنید، به میاناهای برنامه‌سازی کاربردی خارجی متصل شوید، و تجربه‌های چندنفره هم‌زمان بسازید.
زمان اجرای سمت سرور
برنامه‌های Google AI Studio اکنون می‌توانند شامل مؤلفه سمت سرور (Node.js) باشند. این کار به شما امکان می‌دهد:
- اجرای منطق سمت سرور: اجرای کدی که نباید برای کارخواه آشکار شود.
- دسترسی به بسته‌های npm: عامل Antigravity می‌تواند بسته‌ها را از بوم‌سازگان وسیع npm نصب و استفاده کند.
- مدیریت اطلاعات محرمانه: استفاده ایمن از کلیدهای میانای برنامه‌سازی کاربردی و اطلاعات کاربری.
استفاده از بسته‌های npm
نیازی نیست npm install را به‌صورت دستی اجرا کنید. کافی است از «نماینده» بخواهید عملکردی را که به بسته نیاز دارد اضافه کند، و او نصب و وارد کردن را انجام خواهد داد.
مثال: > «از axios برای واکشی داده‌ها از API خارجی استفاده کن.»
مدیریت ایمن اطلاعات محرمانه
با کد سمت سرور و مدیریت اسرار، اکنون می‌توانید برنامه‌هایی بسازید که با جهان تعامل دارند.
کلید Gemini API
وقتی برنامه جدیدی ایجاد می‌کنید که از Gemini API استفاده می‌کند، AI Studio به‌طور خودکار
GEMINI_API_KEY شما را به‌عنوان رمز سمت سرور پیکربندی می‌کند — نیازی به راه‌اندازی دستی
نیست. می‌توانید این کلید را در پانل اطلاعات محرمانه در «تنظیمات» مشاهده کنید. فراخوانی‌های Gemini API برنامه شما بااستفاده از این کلید از کد سمت سرور انجام می‌شود، بنابراین هرگز در مرورگر نمایش داده نمی‌شود.
کلیدهای میانای برنامه‌سازی کاربردی شخص ثالث
برای سرویس‌های دیگر، می‌توانید کلیدهای میانای برنامه‌سازی کاربردی را به‌صورت دستی اضافه کنید:
- میاناهای برنامه‌سازی کاربردی طرف سوم: به سرویس‌هایی مثل Stripe، SendGrid، یا میاناهای برنامه‌سازی کاربردی REST سفارشی متصل شوید.
- پایگاه‌های داده: به پایگاه‌های داده خارجی (مثلاً ازطریق Supabase، Firebase، یا MongoDB Atlas) متصل شوید تا داده‌ها را فراتر از جلسه حفظ کنید.
هنگام ساختن برنامه‌های دنیای واقعی، اغلب لازم است به سرویس‌های طرف سوم (مثل Twilio، Slack، یا پایگاه‌های داده) که به کلیدهای API نیاز دارند متصل شوید. با مراحل زیر می‌توانید کلیدها را به‌صورت دستی اضافه کنید:
- افزودن رمز: به منو تنظیمات در Google AI Studio بروید و بخش «رمزها» را پیدا کنید.
- ذخیره کردن کلید: کلیدهای میانای API یا کدهای مخفی خود را در اینجا اضافه کنید.
- دسترسی در کد: «نماینده» می‌تواند کد سمت سرور بنویسد که به‌طور ایمن به این اطلاعات محرمانه دسترسی داشته باشد (معمولاً ازطریق متغیرهای محیطی)، و مطمئن شود که این اطلاعات هرگز در مرورگر سمت کارخواه نمایش داده نمی‌شوند.
درصورت نیاز، هرگاه به رمز جدیدی نیاز باشد یا کلید جدیدی در متغیرهای محیطی پروژه شناسایی شود، نماینده کارتی را در گپ نشان می‌دهد که از شما می‌خواهد کلیدها را اضافه کنید.
ادغام Firebase برای پایگاه داده و اصالت‌سنجی
اکنون Google AI Studio ازطریق ادغام Firebase، افزودن پایگاه داده یا اصالت‌سنجی به برنامه را آسان می‌کند. «عامل Antigravity» می‌تواند سرویس‌های زیر را به‌طور خودکار برای شما تأمین و راه‌اندازی کند:
- پایگاه داده Firestore: پایگاه داده ابری NoSQL انعطاف‌پذیر و مقیاس‌پذیر برای ذخیره و همگام‌سازی داده‌ها برای توسعه سمت کارخواه و سمت سرور.
- اصالت‌سنجی Firebase: به کاربران شما اجازه می‌دهد بااستفاده از جریان‌های «ورود به سیستم با Google» به‌طور ایمن به سیستم برنامه شما وارد شوند.
کافی است از نماینده بخواهید «یک پایگاه داده به برنامه من اضافه کند» یا «ورود به سیستم با Google را راه‌اندازی کند»، و نماینده پیکربندی و تولید کد لازم را برای شما انجام خواهد داد. هنگام ساختن برنامه‌های Android، یکپارچه‌سازی Firebase همچنین Firebase AI Logic و بررسی برنامه Firebase را برای فراخوانی‌های ایمن Gemini API سمت کارخواه فراهم می‌کند.
Firebase به شما امکان می‌دهد به‌طور رایگان شروع کنید و هر زمان که برای سهمیه بیشتر یا استفاده از ویژگی‌های پولی آماده بودید، به‌طور اختیاری با حساب پولی مقیاس‌بندی کنید.
Google Workspace APIs
Google AI Studio به شما امکان می‌دهد برنامه‌هایی بسازید که به میاناهای برنامه‌سازی کاربردی Google Workspace متصل می‌شوند، بنابراین کاربرانتان می‌توانند با داده‌های واقعی خود کار کنند: ایمیل‌ها، صفحه‌گسترده‌ها، اسناد، رویدادهای تقویم، و موارد دیگر، همه در برنامه شما. دیگر نیازی به راه‌اندازی پروژه Google Cloud، پیکربندی OAuth، یا مدیریت دستی میانای برنامه‌سازی کاربردی ندارید.
روش کار
به دو روش می‌توانید ادغام Workspace را اضافه کنید:
- آن را در پانل گپ شرح دهید: کافی است آنچه را می‌خواهید در پانل گپ در پایین به نماینده بگویید. برای مثال، «ردیاب هزینه‌ای بساز که رسیدها را در «کاربرگ‌نگار Google» من ثبت کند» یا «داشبوردی بساز که پیام‌های خوانده‌نشده Gmail من را خلاصه کند.»
- انتخاب از پانل ادغام‌ها: پانل ادغام‌ها را در نوار کناری سمت چپ حالت «ساخت» باز کنید و برنامه Workspace موردنظرتان را برای اتصال فعال کنید.
وقتی برنامه Workspace اضافه می‌کنید، AI Studio به‌طور خودکار:
- میانای برنامه‌سازی کاربردی Google لازم را برای برنامه‌تان متصل می‌کند.
- کد سمت سرور را برای فراخوانی API تولید می‌کند.
- جریان امن «ورود به سیستم با Google» را اضافه می‌کند تا کاربران نهایی برنامه‌تان بتوانند دسترسی به داده‌های خودشان را مجاز کنند.
برنامه‌های پشتیبانی‌شده
برنامه‌های Google Workspace زیر دردسترس هستند:
| برنامه | آنچه می‌توانید بسازید |
|---|---|
| تقویم Google | خواندن، ایجاد، و مدیریت رویدادها و تقویم‌ها |
| Google Chat | خواندن و تعامل با مکالمه‌ها و فضاهای گروهی |
| سندنگار Google | ایجاد، خواندن، به‌روزرسانی، و قالب‌بندی اسناد |
| Google Drive | سازمان‌دهی، جستجو، و مدیریت فایل‌ها و پوشه‌ها |
| فرم‌نگار Google | ایجاد نظرسنجی، به‌روزرسانی سؤالات، و بازیابی پاسخ‌ها |
| Gmail | خواندن، ارسال، و مدیریت محتوای ایمیل |
| Google Keep | مدیریت یادداشت‌ها، فهرست‌ها، و پیوست‌ها |
| Google Meet | زمان‌بندی و مدیریت تماس‌های ویدیویی |
| مخاطبین | همگام‌سازی و مدیریت مخاطبین |
| کاربرگ‌نگار Google | خواندن، نوشتن، و قالب‌بندی داده‌های صفحه‌گسترده |
| اسلایدنگار Google | ایجاد و اصلاح ارائه‌ها |
| Google Tasks | ایجاد، مدیریت، و سازمان‌دهی تکالیف |
اصالت‌سنجی و اجازه‌ها
به‌عنوان سازنده، نیازی نیست کارخواه‌های OAuth را پیکربندی کنید، اطلاعات کاربری را مدیریت کنید، یا پروژه Google Cloud راه‌اندازی کنید. AI Studio همه این موارد را برای شما مدیریت می‌کند.
برنامه‌هایی که Workspace API در آن‌ها ادغام شده است از «ورود به سیستم با Google» برای اصالت‌سنجی کاربران نهایی استفاده می‌کنند. وقتی کاربری برنامه شما را باز می‌کند، از او خواسته می‌شود به سیستم وارد شود و اجازه‌های خاصی را که برنامه‌تان نیاز دارد (برای مثال، دسترسی فقط خواندنی به تقویم او، یا توانایی ویرایش صفحه‌گسترده) اعطا کند. برنامه‌تان فقط به داده‌های فردی که از آن استفاده می‌کند دسترسی دارد. هر کاربر دسترسی به حساب خودش را مجاز می‌کند.
پیام‌واره‌های نمونه
در اینجا چند ایده برای شروع کار با ادغام‌های Workspace ارائه شده است:
- «برنامه‌ای بساز که «تقویم Google» من را بخواند و برای هر جلسه در Gmail ایمیل‌های آماده‌سازی پیش‌نویس کند.»
- «ابزاری ایجاد کن که یک سند Google را بگیرد و یک ارائه خلاصه ۵ اسلایدی در «اسلایدنگار Google» تولید کند.»
- «یک ردیاب هزینه بساز که در آن رسید را بارگذاری کنم، Gemini جزئیات را استخراج کند، و آن را در ردیف جدیدی در «کاربرگ‌نگار Google» من ثبت کند.»
راه‌اندازی OAuth
یکی از موارد استفاده کلیدی برای مدیریت اسرار، راه‌اندازی OAuth برای اتصال به وب‌سایت‌ها یا برنامه‌های دیگر است. وقتی پیام‌واره شما شامل دستورالعمل‌هایی درباره اتصال به یک برنامه شخص ثالث باشد که به اصالت‌سنجی OAuth نیاز دارد، نماینده دستورالعمل‌هایی درباره نحوه راه‌اندازی OAuth برای آن برنامه ارائه خواهد داد. این دستورالعمل‌ها شامل نشانی‌های وب فراخوانی لازم برای پیکربندی «برنامه OAuth» شما خواهد بود. همچنین می‌توانید نشانی‌های وب بازگشت تماس را در بخش ادغام‌ها در پانل «تنظیمات» پیدا کنید.
ایجاد تجربه‌های چندنفره
زمان اجرای پشته کامل ویژگی‌های مشارکت هم‌زمان را فعال می‌کند.
- وضعیت هم‌زمان: می‌توانید از «نماینده» بخواهید ویژگی‌هایی مثل «گپ زنده»، «تخته سفید مشارکتی»، یا «بازی چندنفره» بسازد.
- جلسه‌های همگام‌سازی‌شده: سرور وضعیت را مدیریت می‌کند و به چندین کاربر اجازه می‌دهد به‌طور هم‌زمان با همان نمونه برنامه تعامل داشته باشند.
نمونه پیام‌واره: > «این را به بازی چندنفره‌ای تبدیل کن که بازیکنان بتوانند مکان‌نماهای یکدیگر را ببینند.»
نکاتی برای آزمایش برنامه‌های چندنفره
قبل‌از استقرار برنامه‌تان، می‌توانید حالت چندنفره را به دو روش آزمایش کنید.
- برنامه‌تان را در حالت «ساخت» Google AI Studio در چند برگه باز کنید. وقتی در حالت «ساخت» توسعه می‌دهید، برنامه‌تان در محفظه توسعه قرار دارد. باز کردن برنامه در چند برگه به شما امکان می‌دهد چند بازیکن را که از برنامه‌تان استفاده می‌کنند شبیه‌سازی کنید.
- بااستفاده از منو هم‌رسانی در بالا سمت چپ، برنامه را با دیگران هم‌رسانی کنید. سپس از نشانی وب هم‌رسانی‌شده در برگه ادغام‌ها در منو هم‌رسانی استفاده کنید تا از برنامه با بازیکنانی که برنامه را با آن‌ها هم‌رسانی کرده‌اید استفاده کنید.
روال‌های مطلوب
- فراخوانی‌های Gemini API:
GEMINI_API_KEYشما به‌طور خودکار به‌عنوان یک رمز سمت سرور پیکربندی می‌شود. بااستفاده از این کلید، از کد سمت سرور خود تماس‌های Gemini API برقرار کنید. می‌توانید آن را در پانل Secrets مشاهده کنید. - امنیت اسرار: همیشه از «مدیر اسرار» برای کلیدهای حساس استفاده کنید. هرگز آن‌ها را در فایل‌هایتان کدنویسی ثابت نکنید.
- جداسازی نگرانی‌ها: منطق واسط کاربر را در چارچوب سمت کارخواه (React/Angular) و منطق کسب‌وکار/مدیریت داده‌ها را در سمت سرور نگه دارید.
- رسیدگی به خطا: مطمئن شوید کد سمت سرور شما به‌طور مؤثر به خطاهای ناشی از فراخوانی‌های میانای برنامه‌سازی کاربردی خارجی رسیدگی می‌کند تا از خراب شدن برنامه جلوگیری شود.