استودیوی هوش مصنوعی گوگل اکنون از توسعه فولاستک پشتیبانی میکند و شما را قادر میسازد برنامههایی بسازید که فراتر از نمونههای اولیه سمت کلاینت هستند. با یک محیط اجرای سمت سرور، میتوانید اسرار را مدیریت کنید، به APIهای خارجی متصل شوید و تجربیات چند نفره بلادرنگ بسازید.
زمان اجرای سمت سرور
برنامههای Google AI Studio اکنون میتوانند شامل یک کامپوننت سمت سرور (Node.js) باشند. این به شما امکان میدهد:
- اجرای منطق سمت سرور : اجرای کدی که نباید در معرض دید کلاینت قرار گیرد.
- دسترسی به بستههای npm : عامل ضد جاذبه میتواند بستههایی را از اکوسیستم گسترده npm نصب و استفاده کند.
- مدیریت اسرار : استفاده ایمن از کلیدها و اعتبارنامههای API.
استفاده از پکیجهای npm
لازم نیست npm install به صورت دستی اجرا کنید. کافیست از Agent بخواهید عملکردی را که به یک بسته نیاز دارد اضافه کند و خودش نصب و وارد کردن را انجام میدهد.
مثال : > " axios برای دریافت دادهها از API خارجی استفاده کنید."
مدیریت ایمن اسرار
با کد سمت سرور و مدیریت اسرار، اکنون میتوانید برنامههایی بسازید که با جهان تعامل دارند.
کلید API جمینی
وقتی برنامه جدیدی ایجاد میکنید که از Gemini API استفاده میکند، AI Studio به طور خودکار GEMINI_API_KEY شما را به عنوان یک راز سمت سرور پیکربندی میکند - نیازی به تنظیم دستی نیست. میتوانید این کلید را در پنل اسرار در تنظیمات مشاهده کنید. فراخوانیهای Gemini API برنامه شما از کد سمت سرور با استفاده از این کلید انجام میشود، بنابراین هرگز در مرورگر نمایش داده نمیشود.
کلیدهای API شخص ثالث
برای سایر سرویسها، میتوانید کلیدهای API را به صورت دستی اضافه کنید:
- APIهای شخص ثالث : به سرویسهایی مانند Stripe، SendGrid یا APIهای REST سفارشی متصل شوید.
- پایگاههای داده : برای حفظ دادهها فراتر از جلسه، به پایگاههای داده خارجی (مثلاً از طریق Supabase، Firebase یا MongoDB Atlas) متصل شوید.
هنگام ساخت برنامههای دنیای واقعی، اغلب نیاز دارید به سرویسهای شخص ثالث (مانند Twilio، Slack یا پایگاههای داده) که به کلیدهای API نیاز دارند، متصل شوید. میتوانید با مراحل زیر، کلیدها را به صورت دستی اضافه کنید:
- یک راز اضافه کنید : به منوی تنظیمات در Google AI Studio بروید و بخش رازها را پیدا کنید.
- کلید خود را ذخیره کنید : کلیدهای API یا توکنهای مخفی خود را اینجا اضافه کنید.
- دسترسی در کد : عامل میتواند کد سمت سرور بنویسد که به این اسرار به صورت ایمن (معمولاً از طریق متغیرهای محیطی) دسترسی پیدا کند و تضمین کند که آنها هرگز در معرض مرورگر سمت کلاینت قرار نمیگیرند.
در صورت نیاز، عامل همچنین کارتی را در چت نشان میدهد که از شما میخواهد هر زمان که به یک راز جدید نیاز باشد یا وقتی یک کلید جدید در متغیرهای env پروژه شناسایی شود، کلیدها را اضافه کنید.
ادغام فایربیس برای پایگاه داده و احراز هویت
Google AI Studio اکنون از طریق یکپارچهسازی Firebase، اضافه کردن پایگاه داده یا احراز هویت به برنامه شما را آسان میکند. Antigravity Agent میتواند سرویسهای زیر را به طور خودکار برای شما فراهم و راهاندازی کند:
- پایگاه داده Firestore : یک پایگاه داده ابری NoSQL انعطافپذیر و مقیاسپذیر برای ذخیره و همگامسازی دادهها برای توسعه سمت کلاینت و سرور.
- احراز هویت فایربیس : به کاربران خود اجازه دهید با استفاده از جریانهای «ورود با گوگل» به طور ایمن وارد برنامه شما شوند.
کافیست از نماینده بخواهید «یک پایگاه داده به برنامه من اضافه کند» یا «ورود به سیستم گوگل را راهاندازی کند» و او پیکربندی لازم و تولید کد را برای شما انجام خواهد داد.
فایربیس به شما امکان میدهد به صورت رایگان شروع کنید و در صورت تمایل، هر زمان که برای سهمیه بیشتر یا استفاده از ویژگیهای پولی آماده بودید، با یک حساب کاربری پولی، مقیاسپذیری را افزایش دهید.
رابطهای برنامهنویسی کاربردی (API) گوگل ورکاسپیس
Google AI Studio به شما امکان میدهد برنامههایی بسازید که به APIهای Google Workspace متصل شوند، بنابراین کاربران شما میتوانند با دادههای واقعی خود مانند ایمیلها، صفحات گسترده، اسناد، رویدادهای تقویم و موارد دیگر، همه در برنامه شما کار کنند. دیگر نیازی به راهاندازی یک پروژه Google Cloud، پیکربندی OAuth یا مدیریت دستی API خود ندارید.
چگونه کار میکند؟
شما میتوانید به دو روش، یکپارچهسازی Workspace را اضافه کنید:
- آن را در پنل چت شرح دهید : فقط در پنل چت در پایین به نماینده بگویید که چه میخواهید. برای مثال، «یک ردیاب هزینه بسازید که رسیدها را در گوگل شیت من ثبت کند» یا «داشبوردی ایجاد کنید که پیامهای خوانده نشده جیمیل من را خلاصه کند».
- از پنل ادغامها انتخاب کنید : پنل ادغامها را در نوار کناری سمت راست حالت ساخت باز کنید و برنامه Workspace مورد نظر برای اتصال را فعال کنید.
وقتی یک برنامه Workspace اضافه میکنید، AI Studio به طور خودکار:
- API گوگل لازم برای برنامه شما را متصل میکند.
- کد سمت سرور را برای فراخوانی API تولید میکند.
- یک جریان امن «ورود با گوگل» اضافه میکند تا کاربران نهایی برنامه شما بتوانند دسترسی به دادههای خودشان را تأیید کنند.
برنامههای پشتیبانیشده
برنامههای Google Workspace زیر در دسترس هستند:
| برنامه | آنچه میتوانید بسازید |
|---|---|
| تقویم گوگل | خواندن، ایجاد و مدیریت رویدادها و تقویمها |
| گوگل چت | مکالمات و فضاهای گروهی را بخوانید و با آنها تعامل داشته باشید |
| اسناد گوگل | ایجاد، خواندن، بهروزرسانی و قالببندی اسناد |
| گوگل درایو | سازماندهی، جستجو و مدیریت فایلها و پوشهها |
| فرمهای گوگل | ایجاد نظرسنجی، بهروزرسانی سوالات و بازیابی پاسخها |
| جیمیل | خواندن، ارسال و مدیریت محتوای ایمیل |
| گوگل کیپ | مدیریت یادداشتها، لیستها و پیوستها |
| گوگل میت | زمانبندی و مدیریت تماسهای ویدیویی |
| مخاطبین | همگامسازی و مدیریت مخاطبین |
| صفحات گوگل | خواندن، نوشتن و قالببندی دادههای صفحه گسترده |
| اسلایدهای گوگل | ایجاد و اصلاح ارائهها |
| وظایف گوگل | ایجاد، مدیریت و سازماندهی وظایف |
احراز هویت و مجوزها
به عنوان سازنده، نیازی به پیکربندی کلاینتهای OAuth، مدیریت اعتبارنامهها یا راهاندازی یک پروژه Google Cloud ندارید. AI Studio همه این کارها را برای شما انجام میدهد.
برنامههایی که APIهای Workspace در آنها ادغام شده است، از «ورود با گوگل» برای تأیید اعتبار کاربران نهایی استفاده میکنند. وقتی کاربری برنامه شما را باز میکند، از او خواسته میشود که وارد سیستم شود و مجوزهای خاصی را که برنامه شما نیاز دارد (مثلاً دسترسی فقط خواندنی به تقویم خود یا امکان ویرایش یک صفحه گسترده) اعطا کند. برنامه شما فقط به دادههای شخصی که از آن استفاده میکند دسترسی دارد. هر کاربر دسترسی به حساب خود را مجاز میداند.
مثالهای پیشنهادی
در اینجا چند ایده برای شروع ادغام با Workspace آورده شده است:
- «یک اپلیکیشن بساز که تقویم گوگل من را بخواند و برای هر جلسه، ایمیلهای آمادهسازی را در جیمیل آماده کند.»
- «ابزاری بسازید که یک سند گوگل را دریافت کند و یک ارائه خلاصه ۵ اسلایدی در اسلایدهای گوگل ایجاد کند.»
- «یک ردیاب هزینه درست کنید که در آن رسید را آپلود کنم، Gemini جزئیات را استخراج میکند و یک ردیف جدید در Google Sheet من ثبت میکند.»
تنظیم OAuth
یکی از کاربردهای کلیدی مدیریت اسرار، تنظیم OAuth برای اتصال به وبسایتها یا برنامههای دیگر است. هنگامی که درخواست شما شامل دستورالعملهایی در مورد اتصال به یک برنامه شخص ثالث است که نیاز به احراز هویت OAuth دارد، عامل دستورالعملهایی در مورد نحوه تنظیم OAuth برای آن برنامه ارائه میدهد. این دستورالعملها شامل URLهای فراخوانی لازم برای پیکربندی برنامه OAuth شما خواهند بود. همچنین میتوانید URLهای فراخوانی را در بخش Integrations در پنل تنظیمات پیدا کنید.
ساخت تجربیات چند نفره
زمان اجرای کامل، ویژگیهای همکاری در لحظه (real-time) را فراهم میکند.
- وضعیت بلادرنگ : میتوانید از نماینده بخواهید ویژگیهایی مانند «چت زنده»، «تخته سفید مشارکتی» یا «بازی چند نفره» را ایجاد کند.
- جلسات همگامسازی شده : سرور وضعیت را مدیریت میکند و به چندین کاربر اجازه میدهد تا با یک نمونه برنامه به صورت بلادرنگ تعامل داشته باشند.
مثال : > "این را به یک بازی چند نفره تبدیل کنید که بازیکنان بتوانند مکاننمای یکدیگر را ببینند."
نکاتی برای آزمایش برنامههای چند نفره
شما میتوانید قبل از استقرار برنامه خود، حالت چند نفره را به دو روش آزمایش کنید.
- برنامه خود را در حالت ساخت (Build) در Google AI Studio در چندین تب باز کنید. هنگام توسعه در حالت ساخت (Build)، برنامه شما در یک کانتینر توسعه (dev container) قرار دارد. باز کردن برنامه در چندین تب به شما امکان میدهد چندین بازیکن را با استفاده از برنامه خود شبیهسازی کنید.
- برنامه را با استفاده از منوی اشتراکگذاری در بالا سمت راست با دیگران به اشتراک بگذارید. سپس از طریق تب «یکپارچهسازیها» در منوی اشتراکگذاری ، از طریق «نشانی اینترنتی مشترک» (Shared URL) از برنامه با بازیکنانی که برنامه خود را با آنها به اشتراک گذاشتهاید، استفاده کنید.
بهترین شیوهها
- فراخوانیهای API مربوط به Gemini : کلید
GEMINI_API_KEYشما به طور خودکار به عنوان یک کلید مخفی سمت سرور پیکربندی میشود. با استفاده از این کلید، فراخوانیهای API مربوط به Gemini را از کد سمت سرور خود انجام دهید. میتوانید آن را در پنل Secrets مشاهده کنید. - امنیت اسرار : همیشه از مدیر اسرار برای کلیدهای حساس استفاده کنید. هرگز آنها را در فایلهای خود به صورت کد ثابت قرار ندهید.
- تفکیک دغدغهها : منطق رابط کاربری خود را در چارچوب سمت کلاینت (React/Angular) و منطق/مدیریت دادههای تجاری خود را در سمت سرور نگه دارید.
- مدیریت خطا : اطمینان حاصل کنید که کد سمت سرور شما به طور قوی خطاهای ناشی از فراخوانیهای API خارجی را مدیریت میکند تا از خرابی برنامه جلوگیری شود.