يتيح لك Google AI Studio الآن تطوير تطبيقات كاملة الميزات، ما يمكّنك من إنشاء تطبيقات تتجاوز النماذج الأولية من جهة العميل. باستخدام وقت تشغيل من جهة الخادم، يمكنك إدارة الأسرار والربط بواجهات برمجة التطبيقات الخارجية وإنشاء تجارب متعددة اللاعبين في الوقت الفعلي.
وقت التشغيل من جهة الخادم
يمكن أن تتضمّن تطبيقات Google AI Studio الآن مكوّنًا من جهة الخادم (Node.js). ويتيح لك هذا ما يلي:
- تنفيذ منطق من جهة الخادم: تنفيذ رمز برمجي لا يجب أن يكون متاحًا للعميل
- الوصول إلى حِزم npm: يمكن Antigravity Agent تثبيت الحِزم واستخدامها من منظومة npm المتكاملة.
- التعامل مع الأسرار: استخدام مفاتيح واجهة برمجة التطبيقات وبيانات الاعتماد بأمان
استخدام حِزم npm
لست بحاجة إلى تشغيل npm install يدويًا. ما عليك سوى أن تطلب من الوكيل إضافة وظيفة تتطلّب حزمة، وسيتولّى الوكيل عملية التثبيت والاستيراد.
مثال: > "استخدِم axios لاسترجاع البيانات من واجهة برمجة التطبيقات الخارجية."
إدارة الأسرار بأمان
باستخدام الرموز من جهة الخادم وإدارة الأسرار، يمكنك الآن إنشاء تطبيقات تتفاعل مع العالم.
- واجهات برمجة التطبيقات التابعة لجهات خارجية: تتيح الربط بخدمات مثل Stripe أو SendGrid أو واجهات برمجة تطبيقات REST مخصّصة.
- قواعد البيانات: يمكنك الربط بقواعد بيانات خارجية (مثل Supabase أو Firebase أو MongoDB Atlas) للاحتفاظ بالبيانات بعد انتهاء الجلسة.
عند إنشاء تطبيقات واقعية، غالبًا ما تحتاج إلى الربط بخدمات خارجية (مثل Twilio أو Slack أو قواعد البيانات) التي تتطلّب مفاتيح واجهة برمجة تطبيقات. يمكنك إضافة المفاتيح يدويًا باتّباع الخطوات التالية:
- إضافة سر: انتقِل إلى قائمة الإعدادات في Google AI Studio وابحث عن قسم "الأسرار".
- تخزين المفتاح: أضِف مفاتيح واجهة برمجة التطبيقات أو الرموز المميزة السرية هنا.
- الوصول في الرمز: يمكن للوكيل كتابة رمز من جهة الخادم يصل إلى هذه الأسرار بشكل آمن (عادةً من خلال متغيرات البيئة)، ما يضمن عدم عرضها مطلقًا في المتصفح من جهة العميل.
عند الحاجة، سيعرض البرنامج أيضًا بطاقة في المحادثة تطلب منك إضافة مفاتيح كلما دعت الحاجة إلى سر جديد أو عند رصد مفتاح جديد في متغيرات البيئة للمشروع.
إعداد OAuth
تتمثّل إحدى حالات الاستخدام الرئيسية لإدارة الأسرار في إعداد OAuth للربط بمواقع إلكترونية أو تطبيقات أخرى. عندما يتضمّن طلبك تعليمات حول الربط بتطبيق تابع لجهة خارجية يتطلّب مصادقة OAuth، سيقدّم لك الوكيل تعليمات حول كيفية إعداد OAuth لهذا التطبيق. ستتضمّن هذه التعليمات عناوين URL اللازمة لإعادة التوجيه من أجل ضبط تطبيق OAuth. يمكنك أيضًا العثور على عناوين URL الخاصة بوظيفة رد الاتصال ضمن عمليات الدمج في لوحة "الإعدادات".
إنشاء تجارب متعدّدة اللاعبين
يتيح وقت التشغيل الكامل الميزات التي تتيح التعاون في الوقت الفعلي.
- الحالة في الوقت الفعلي: يمكنك أن تطلب من "الوكيل" إنشاء ميزات مثل "محادثة مباشرة" أو "لوح معلومات تعاوني" أو "لعبة متعدّدة اللاعبين".
- الجلسات المتزامنة: يدير الخادم الحالة، ما يتيح لعدة مستخدمين التفاعل مع مثيل التطبيق نفسه في الوقت الفعلي.
مثال على الطلب: > "أريد تحويل هذا التصميم إلى لعبة متعددة اللاعبين يمكن فيها للاعبين رؤية مؤشرات بعضهم البعض".
نصائح لاختبار تطبيقات متعددة اللاعبين
يمكنك اختبار وضع اللعب المتعدد بطريقتَين قبل نشر تطبيقك.
- افتح تطبيقك في وضع "البناء" في Google AI Studio في علامات تبويب متعددة. عند التطوير في "وضع الإنشاء"، يكون تطبيقك في حاوية تطوير. سيسمح لك فتح التطبيق في علامات تبويب متعددة بمحاكاة عدة لاعبين يستخدمون تطبيقك.
- شارِك التطبيق مع الآخرين باستخدام قائمة مشاركة في أعلى يسار الشاشة، ثم استخدِم عنوان URL المشترَك من علامة التبويب عمليات الدمج في قائمة مشاركة لاستخدام التطبيق مع اللاعبين الذين شاركت تطبيقك معهم.
أفضل الممارسات
- أمان الأسرار: استخدِم دائمًا "إدارة الأسرار" للمفاتيح الحسّاسة. لا تدرِجها بشكل ثابت في ملفاتك أبدًا.
- فصل الاهتمامات: احتفِظ بمنطق واجهة المستخدم في إطار عمل من جهة العميل (React/Angular) ومنطق الأنشطة التجارية/معالجة البيانات من جهة الخادم.
- معالجة الأخطاء: تأكَّد من أنّ الرمز البرمجي من جهة الخادم يعالج الأخطاء بشكل فعّال الناتجة عن طلبات البيانات من واجهات برمجة التطبيقات الخارجية لمنع تعطُّل التطبيق.