توضّح هذه الصفحة كيفية استخدام "وضع الإنشاء" في Google AI Studio لإنشاء تطبيقات (أو كتابة رمز برمجي) ونشرها بسرعة، وذلك لاختبار أحدث إمكانات Gemini، مثل nano banana وLive API.
البدء
ابدأ الترميز باستخدام Vibe في وضع الإنشاء في Google AI Studio. يمكنك البدء في إنشاء التطبيق بعدّة طرق:
- البدء بطلب: في "وضع الإنشاء"، استخدِم مربّع الإدخال لإدخال وصف لما تريد إنشاءه. اختَر "شرائح الذكاء الاصطناعي" لإضافة ميزات معيّنة، مثل إنشاء الصور أو بيانات "خرائط Google"، إلى طلبك. يمكنك حتى قول ما تريد باستخدام زر تحويل الكلام إلى نص.
- زر "ضربة حظ": إذا كنت بحاجة إلى استلهام أفكار إبداعية، استخدِم زر "ضربة حظ"، وسينشئ Gemini طلبًا يتضمّن فكرة مشروع لمساعدتك في البدء.
- إنشاء ريمكس لمشروع من "معرض التطبيقات": افتح مشروعًا من معرض التطبيقات وانقر على نسخ التطبيق.
بعد تشغيل الطلب، سيتم إنشاء الرمز والملفات اللازمة، وستظهر معاينة مباشرة لتطبيقك على الجانب الأيسر.
ما الذي يتم إنشاؤه؟
عند تنفيذ طلبك، ينشئ AI Studio تطبيق ويب. وبشكل تلقائي، سينشئ تطبيق ويب باستخدام React، ولكن يمكنك اختيار إنشاء تطبيق Angular في قائمة الإعدادات. يمكنك الاطّلاع على الرمز الذي يتم إنشاؤه من خلال اختيار علامة التبويب الرمز في جزء المعاينة على اليسار.
في ما يلي الملفات التي يجب الانتباه إليها:
- geminiService.ts: يحتوي هذا الملف على المنطق الرئيسي لتطبيقك، بدءًا من إنشاء الطلبات إلى استدعاء Gemini API وتحليل ردوده. يمكنك تعديل الطلب الأساسي في هذا الملف أو تعديل أي وظيفة من وظائف المكوّن مباشرةً أو من خلال التفاعل مع Gemini في وضع "إنشاء". يُرجى العِلم أنّ الرمز البرمجي في هذا الملف يستخدم GenAI TS SDK للتفاعل مع واجهة Gemini API.
مواصلة التطوير
بعد أن ينشئ Google AI Studio الرمز الأولي لتطبيق الويب، يتوفّر لك خياران أساسيان لمتابعة مشروعك: الإنشاء في AI Studio أو التطوير خارجيًا.
إنشاء التطبيقات في Google AI Studio
يمكنك مواصلة تحسين تطبيقك وتوسيع نطاقه مباشرةً ضمن بيئة Google AI Studio باتّباع الخطوات التالية:
- التكرار مع Gemini: استخدِم لوحة المحادثة في وضع الإنشاء لطلب إجراء تعديلات أو إضافة ميزات جديدة أو تغيير الأسلوب من Gemini. على سبيل المثال، يمكنك أن تطلب "إضافة زر لتنبيه المستخدم" أو "تغيير نظام الألوان إلى الأزرق والأبيض".
- تعديل الرمز مباشرةً: افتح علامة التبويب "الرمز" في لوحة المعاينة لإجراء تعديلات مباشرة. يمكنك حفظ مشروعك في GitHub للاستفادة من ميزة التحكّم في الإصدار أثناء التطوير.
التطوير خارجيًا
بالنسبة إلى مهام العمل الأكثر تقدّمًا، يمكنك تصدير الرمز والعمل في البيئة المفضّلة لديك باتّباع الخطوات التالية:
- التنزيل والتطوير على الجهاز: يمكنك تصدير الرمز البرمجي الذي تم إنشاؤه كـ ملف ZIP واستيراده إلى محرّر الرموز البرمجية. يتيح لك ذلك استخدام الأدوات المألوفة وأنظمة الإنشاء وممارسات التحكّم في الإصدارات المحلية لمواصلة الإنشاء بعد النموذج الأوّلي.
- إرسال إلى GitHub: يمكنك دمج الرمز البرمجي مع عمليات التطوير والنشر الحالية من خلال إرساله إلى مستودع GitHub.
الميزات الرئيسية
يتضمّن Google AI Studio عدة ميزات لجعل عملية الإنشاء سهلة ومرئية:
- وضع التعليقات التوضيحية: بدلاً من كتابة الرمز البرمجي لتغيير مظهر تطبيقك، يتيح لك "وضع التعليقات التوضيحية" تمييز أي جزء من واجهة مستخدم تطبيقك ووصف التغيير الذي تريده. على سبيل المثال، يمكنك اختيار أحد المكوّنات وكتابة "اجعل هذا الزر باللون الأزرق" أو "حرِّك هذه الصورة لتنزلق من اليسار". عند النقر على إضافة إلى المحادثة، يتم إنشاء طلب يتضمّن لقطة شاشة للتطبيق الذي تمت إضافة التعليقات التوضيحية إليه.
- مشاركة تطبيقك: يمكنك مشاركة تطبيقاتك مع الآخرين للتعاون أو عرض عملك.
- معرض التطبيقات: يوفّر "معرض التطبيقات" مكتبة مرئية لأفكار المشاريع. يمكنك تصفّح إمكانات Gemini ومعاينة التطبيقات على الفور، وإنشاء ريمكسات منها لتناسب احتياجاتك.
نشر تطبيقك أو أرشفته
بعد أن يصبح تطبيقك جاهزًا، يمكنك نشره مباشرةً من AI Studio. تشمل خيارات النشر ما يلي:
- Google Cloud Run: يمكنك نشر تطبيقك كخدمة قابلة للتوسيع. يُرجى العِلم أنّه قد يتم تطبيق أسعار Google Cloud Run استنادًا إلى الاستخدام.
- GitHub: يمكنك تصدير مشروعك إلى مستودع GitHub لدمجه في مهام العمل الحالية الخاصة بالتطوير والنشر.
القيود
يوضّح هذا القسم القيود المهمة عند استخدام "وضع الإنشاء" في Google AI Studio.
أمان مفتاح واجهة برمجة التطبيقات وإمكانية الوصول إليه
- يمكن لأي مستخدم الاطّلاع على الرمز البرمجي للتطبيقات المشترَكة. لا تستخدِم مفتاح واجهة برمجة التطبيقات الحقيقي مباشرةً في رمز تطبيقك.
- تستخدم التطبيقات تلقائيًا عنصرًا نائبًا (مثل process.env.GEMINI_API_KEY) لمفتاح واجهة برمجة التطبيقات. عندما يشغّل مستخدم تطبيقك المشترَك ضمن AI Studio، يعمل AI Studio كخادم وكيل، ويستبدل العنصر النائب بمفتاح واجهة برمجة التطبيقات الخاص بالمستخدم النهائي، ما يضمن بقاء مفتاحك خاصًا.
ظهور التطبيق ومشاركته
- يتم تخزين التطبيقات في Google Drive وتتضمّن نموذج الأذونات الخاص به، ما يعني أنّها تكون خاصة بشكل تلقائي.
- أذونات المشاركة: عند مشاركة تطبيق مع مستخدمين آخرين:
- يمكن للمستخدمين المشاركين الاطّلاع على الرمز البرمجي وإنشاء نسخة من التطبيق لاستخدامها.
- في حال منح إذن التعديل، يمكن للمستخدمين المشاركين تعديل رمز التطبيق.
النشر خارج AI Studio
- على الرغم من أنّه يمكنك نشر تطبيقك على Cloud Run للحصول على عنوان URL عام، سيستخدم هذا الإعداد مفتاح واجهة برمجة التطبيقات لجميع طلبات Gemini API التي يرسلها المستخدمون.
- يتم تشغيل تطبيقات JavaScript من جهة العميل، لذا احرص على أن تقتصر أذونات مفاتيح واجهة برمجة التطبيقات على الحد الأدنى من الأذونات لمنع تسرُّب البيانات أو إساءة استخدامها. على سبيل المثال، قد يتمكّن المستخدمون من الوصول إلى "متاجر" أخرى في "بحث الملفات" من المشروع نفسه من خلال هذه الآلية.
- النشر الخارجي الآمن: لتشغيل تطبيق بأمان خارج AI Studio (مثلاً، بعد تنزيل ملف ZIP)، عليك نقل المنطق الذي يستخدم مفتاح واجهة برمجة التطبيقات إلى أحد المكوّنات من جهة الخادم لمنع عرض المفتاح للمستخدمين النهائيين. هذا الإعداد غير مطلوب إذا كنت تنشر باستخدام Cloud Run.
- تحذير بشأن تعرُّض المفتاح: لا يُنصح بشدة باستبدال العنصر النائب بمفتاح API حقيقي في بيئة من جهة العميل، لأنّ المفتاح سيصبح مرئيًا لأي مستخدم.
الأدوات والميزات المتوافقة
- استيراد التطبيقات المطوَّرة محليًا: لا يمكنك حاليًا تطوير التطبيقات محليًا باستخدام أدوات خارجية واستيرادها إلى AI Studio.
الخطوات التالية:
- يمكنك الاطّلاع على ما أنشأه الآخرون واستلهام الأفكار من خلال إعادة مزج مشروع حالي في معرض التطبيقات.
- يمكنك الاطّلاع على قائمة التشغيل على YouTube التي تتضمّن مجموعة من البرامج التعليمية حول الترميز باستخدام الذكاء الاصطناعي في AI Studio لمساعدتك على البدء.