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

استودیوی هوش مصنوعی گوگل اکنون از توسعه فول‌استک پشتیبانی می‌کند و شما را قادر می‌سازد برنامه‌هایی بسازید که فراتر از نمونه‌های اولیه سمت کلاینت هستند. با یک محیط اجرای سمت سرور، می‌توانید اسرار را مدیریت کنید، به APIهای خارجی متصل شوید و تجربیات چند نفره بلادرنگ بسازید.

زمان اجرای سمت سرور

برنامه‌های Google AI Studio اکنون می‌توانند شامل یک کامپوننت سمت سرور (Node.js) باشند. این به شما امکان می‌دهد:

  • اجرای منطق سمت سرور : اجرای کدی که نباید در معرض دید کلاینت قرار گیرد.
  • دسترسی به بسته‌های npm : عامل ضد جاذبه می‌تواند بسته‌هایی را از اکوسیستم گسترده npm نصب و استفاده کند.
  • مدیریت اسرار : استفاده ایمن از کلیدها و اعتبارنامه‌های API.

استفاده از بسته‌های npm

لازم نیست npm install به صورت دستی اجرا کنید. کافیست از Agent بخواهید عملکردی را که به یک بسته نیاز دارد اضافه کند و خودش نصب و وارد کردن را انجام می‌دهد.

مثال : > " axios برای دریافت داده‌ها از API خارجی استفاده کنید."

مدیریت ایمن اسرار

با کد سمت سرور و مدیریت اسرار، اکنون می‌توانید برنامه‌هایی بسازید که با جهان تعامل دارند.

  • APIهای شخص ثالث : به سرویس‌هایی مانند Stripe، SendGrid یا APIهای REST سفارشی متصل شوید.
  • پایگاه‌های داده : برای حفظ داده‌ها فراتر از جلسه، به پایگاه‌های داده خارجی (مثلاً از طریق Supabase، Firebase یا MongoDB Atlas) متصل شوید.

هنگام ساخت برنامه‌های دنیای واقعی، اغلب نیاز دارید به سرویس‌های شخص ثالث (مانند Twilio، Slack یا پایگاه‌های داده) که به کلیدهای API نیاز دارند، متصل شوید. می‌توانید با مراحل زیر، کلیدها را به صورت دستی اضافه کنید:

  1. یک راز اضافه کنید : به منوی تنظیمات در Google AI Studio بروید و بخش رازها را پیدا کنید.
  2. کلید خود را ذخیره کنید : کلیدهای API یا توکن‌های مخفی خود را اینجا اضافه کنید.
  3. دسترسی در کد : عامل می‌تواند کد سمت سرور بنویسد که به این اسرار به صورت ایمن (معمولاً از طریق متغیرهای محیطی) دسترسی پیدا کند و تضمین کند که آنها هرگز در معرض مرورگر سمت کلاینت قرار نمی‌گیرند.

در صورت نیاز، عامل همچنین کارتی را در چت نشان می‌دهد که از شما می‌خواهد هر زمان که به یک راز جدید نیاز باشد یا وقتی یک کلید جدید در متغیرهای env پروژه شناسایی شود، کلیدها را اضافه کنید.

راه‌اندازی OAuth

یکی از کاربردهای کلیدی مدیریت اسرار، تنظیم OAuth برای اتصال به وب‌سایت‌ها یا برنامه‌های دیگر است. هنگامی که درخواست شما شامل دستورالعمل‌هایی در مورد اتصال به یک برنامه شخص ثالث است که نیاز به احراز هویت OAuth دارد، عامل دستورالعمل‌هایی در مورد نحوه تنظیم OAuth برای آن برنامه ارائه می‌دهد. این دستورالعمل‌ها شامل URLهای فراخوانی لازم برای پیکربندی برنامه OAuth شما خواهند بود. همچنین می‌توانید URLهای فراخوانی را در بخش Integrations در پنل تنظیمات پیدا کنید.

ساخت تجربیات چند نفره

زمان اجرای کامل، ویژگی‌های همکاری در لحظه (real-time) را فراهم می‌کند.

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

مثال : > "این را به یک بازی چند نفره تبدیل کنید که بازیکنان بتوانند مکان‌نمای یکدیگر را ببینند."

نکاتی برای آزمایش برنامه‌های چند نفره

شما می‌توانید قبل از استقرار برنامه خود، حالت چند نفره را به دو روش آزمایش کنید.

  1. برنامه خود را در حالت ساخت (Build) در Google AI Studio در چندین تب باز کنید. هنگام توسعه در حالت ساخت (Build)، برنامه شما در یک کانتینر توسعه (dev container) قرار دارد. باز کردن برنامه در چندین تب به شما امکان می‌دهد چندین بازیکن را با استفاده از برنامه خود شبیه‌سازی کنید.
  2. برنامه را با استفاده از منوی اشتراک‌گذاری در بالا سمت راست با دیگران به اشتراک بگذارید. سپس از طریق تب «یکپارچه‌سازی‌ها» در منوی اشتراک‌گذاری ، از طریق «نشانی اینترنتی مشترک» (Shared URL) از برنامه با بازیکنانی که برنامه خود را با آنها به اشتراک گذاشته‌اید، استفاده کنید.

بهترین شیوه‌ها

  • امنیت اسرار : همیشه از مدیر اسرار برای کلیدهای حساس استفاده کنید. هرگز آنها را در فایل‌های خود به صورت کد ثابت قرار ندهید.
  • تفکیک دغدغه‌ها : منطق رابط کاربری خود را در چارچوب سمت کلاینت (React/Angular) و منطق/مدیریت داده‌های تجاری خود را در سمت سرور نگه دارید.
  • مدیریت خطا : اطمینان حاصل کنید که کد سمت سرور شما به طور قوی خطاهای ناشی از فراخوانی‌های API خارجی را مدیریت می‌کند تا از خرابی برنامه جلوگیری شود.

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