توضّح هذه الصفحة كيفية استخدام Google AI Studio لإنشاء (أو "كتابة رمز برمجي") التطبيقات ونشرها بسرعة، وذلك لاختبار أحدث إمكانات Gemini، مثل Nano Banana وLive API. يتيح لك Google AI Studio الآن استخدام وقت تشغيل متكامل، ما يتيح لك إنشاء تطبيقات قوية تتضمّن منطقًا من جهة الخادم، وإدارة آمنة للأسرار، وإمكانية استخدام حِزم npm، وكل ذلك من خلال مطالبات باللغة الطبيعية.
البدء
ابدأ البرمجة الوصفية في وضع الإنشاء في Google AI Studio. يمكنك البدء في إنشاء التطبيق بعدة طرق:
- البدء بطلب: في "وضع الإنشاء"، استخدِم مربّع الإدخال لإدخال وصف لما تريد إنشاءه. اختَر "شرائح الذكاء الاصطناعي" لإضافة ميزات معيّنة، مثل إنشاء الصور أو بيانات "خرائط Google"، إلى طلبك. يمكنك حتى قول ما تريد باستخدام زر "تحويل الصوت إلى نص".
- زر "ضربة حظ": إذا كنت بحاجة إلى أفكار إبداعية، استخدِم زر "ضربة حظ"، وسينشئ Gemini طلبًا يتضمّن فكرة مشروع لمساعدتك في البدء.
- إنشاء ريمكس لمشروع من المعرض: افتح مشروعًا من معرض التطبيقات وانقر على نسخ التطبيق.
بعد تشغيل الطلب، سيتم إنشاء الرمز والملفات اللازمة، وستظهر معاينة مباشرة لتطبيقك على الجانب الأيسر.
ما الذي يتم إنشاؤه؟
عند تنفيذ طلبك، ينشئ "استوديو الذكاء الاصطناعي" تطبيقًا كاملاً. بشكل تلقائي، تنشئ هذه الأداة بيئة متكاملة يمكن أن تشمل ما يلي:
- من جهة العميل: واجهة أمامية للويب (React هي الواجهة التلقائية).
- من جهة الخادم: وقت تشغيل Node.js يتيح إجراء طلبات آمنة إلى واجهة برمجة التطبيقات، وإنشاء اتصالات بقواعد البيانات، واستخدام حِزم npm.
يمكنك الاطّلاع على الرمز الذي يتم إنشاؤه من خلال اختيار علامة التبويب الرمز في جزء المعاينة الأيسر. يدير Antigravity Agent بذكاء ملفات متعددة في حزمة التطبيقات، ما يضمن نشر التغييرات بشكل صحيح.
The Antigravity Agent
وكيل Antigravity هو وظيفة الذكاء الاصطناعي الرئيسية في Google Antigravity، وتعمل المكوّنات الأساسية لأداة الوكيل الآن على تشغيل تجربة "وضع الإنشاء" في Google AI Studio. وهو يتجاوز مجرد إنشاء الرموز البرمجية البسيطة، إذ يحافظ على سياق مشروعك بأكمله، ويدير ملفات متعددة، ويفهم التعليمات المعقدة لإنشاء تطبيقات قوية ومتكاملة.
تشمل الإمكانات الرئيسية ما يلي:
- الوعي بالسياق: يحافظ على سياق الطلبات السابقة وحالات الملفات.
- إدارة الملفات المتعددة: تتعامل مع التبعيات في ملفات متعددة.
- التنفيذ الذي تم التحقّق منه: يتحقّق من تعديلات الرمز البرمجي للحدّ من الهلوسات.
إمكانات الحزمة الكاملة
تتيح لك أداة Google AI Studio الاستفادة من إمكانات منظومة الويب الحديثة، ما يسمح لك بإنشاء نماذج أولية تتجاوز تلك التي يتم إنشاؤها من جهة العميل.
- وقت التشغيل من جهة الخادم وnpm: يمكنك استخدام مكتبة npm الواسعة من الحِزم. سيحدّد الوكيل الحِزم ويثبّتها تلقائيًا حسب الحاجة لتطبيقك (مثل مكتبات معيّنة لتصوّر البيانات أو برامج واجهة برمجة التطبيقات). يمكنك أيضًا طلب حِزم معيّنة إذا أردت ذلك.
- إدارة الأسرار: يمكنك تخزين مفاتيح وأسرار واجهة برمجة التطبيقات بشكل آمن في قائمة الإعدادات. ويمكن الوصول إلى هذه البيانات في الرمز البرمجي من جهة الخادم، ما يحافظ على أمانها من التعرّض لها من جهة العميل.
- اللعب المتعدّد: يمكنك إنشاء تجارب تعاونية في الوقت الفعلي مباشرةً ضمن AI Studio. يدير وقت التشغيل من جهة الخادم الحالة وعمليات الربط المطلوبة لكي يتفاعل المستخدمون معًا.
- دمج Firebase: يمكنك توفير Firebase وإعداده تلقائيًا، بما في ذلك قاعدة بيانات Firestore (تخزين البيانات الدائم) و مصادقة Firebase (عمليات تسجيل الدخول، وتحديدًا "تسجيل الدخول باستخدام حساب Google"). يتولّى الوكيل عملية الإعداد بأكملها، بل ويكتب الرمز في تطبيقك لهذه الخدمات.
مزيد من المعلومات عن تطوير تطبيقات متكاملة
مواصلة الإنشاء
بعد أن ينشئ Google AI Studio الرمز الأولي لتطبيقك، يمكنك مواصلة تحسينه باتّباع الخطوات التالية:
إنشاء التطبيقات في Google AI Studio
- التكرار مع Gemini: استخدِم لوحة المحادثة في وضع الإنشاء لـ اسأل Gemini لإجراء تعديلات أو إضافة ميزات جديدة أو تغيير الأسلوب.
- تعديل الرمز مباشرةً: افتح علامة التبويب "الرمز" في لوحة المعاينة لإجراء تعديلات مباشرة.
التطوير خارجيًا
بالنسبة إلى مهام العمل الأكثر تقدّمًا، يمكنك تصدير الرمز والعمل في البيئة المفضّلة لديك باتّباع الخطوات التالية:
- التنزيل والتطوير على الجهاز: يمكنك تصدير الرمز الذي تم إنشاؤه كـ ملف ZIP واستيراده إلى أداة تعديل الرموز.
- إرسال إلى GitHub: يمكنك دمج الرمز مع عمليات التطوير والنشر الحالية من خلال إرساله إلى مستودع GitHub.
الميزات الرئيسية
يتضمّن Google AI Studio عدة ميزات لجعل عملية الإنشاء سهلة ومرئية:
- إنشاء تطبيقات متكاملة وتكرارها: يمكنك إنشاء تطبيقات متكاملة من خلال تقديم طلب بسيط وتكرارها من خلال الدردشة أو وضع التعليقات التوضيحية. يتيح لك وضع التعليقات التوضيحية تمييز أي جزء من واجهة مستخدم تطبيقك ووصف التغيير المطلوب.
- مشاركة تطبيقك ونشره: يمكنك مشاركة إبداعاتك مع الآخرين للتعاون أو عرض عملك. بعد ذلك، عندما يصبح تطبيقك جاهزًا، يمكنك نشره على Cloud Run.
- معرض التطبيقات: يوفّر معرض التطبيقات مكتبة مرئية لأفكار المشاريع. يمكنك استعراض إمكانات Gemini ومعاينة التطبيقات على الفور، وإعادة مزجها لتصبح من تصميمك.
إنشاء تطبيقات ذات حزمة كاملة وتكرارها: نبذة سريعة عن إتاحة وقت التشغيل، والتكرار باستخدام وضع التعليق التوضيحي المشاركة والنشر: مشاركة تطبيقك في AI Studio أو نشره على Cloud Run استكشاف معرض التطبيقات
نشر تطبيقك أو أرشفته
بعد أن يصبح تطبيقك جاهزًا، يمكنك نشره باتّباع الخطوات التالية:
- Google Cloud Run: يمكنك نشر تطبيقك كخدمة قابلة للتوسّع. قد يتم تطبيق أسعار Google Cloud Run استنادًا إلى الاستخدام.
- GitHub: لتصدير مشروعك إلى مستودع GitHub
القيود
يسرد هذا القسم القيود الحالية لوضع الإنشاء في Google AI Studio.
أمان مفتاح واجهة برمجة التطبيقات
- من جهة العميل: لا تستخدِم مفاتيح واجهة برمجة التطبيقات الحقيقية مباشرةً في الرمز البرمجي من جهة العميل.
- من جهة الخادم: استخدِم ميزة "إدارة الأسرار" للتعامل مع المفاتيح الحسّاسة بأمان في وقت التشغيل من جهة الخادم.
النشر خارج Google AI Studio
- على الرغم من أنّه يمكنك نشر تطبيقك على Cloud Run باستخدام عنوان URL متاح للجميع، سيستخدم هذا الإعداد مفتاح واجهة برمجة التطبيقات لجميع طلبات Gemini API التي يرسلها المستخدمون.
- يتم تشغيل تطبيقات JavaScript من جهة العميل، لذا احرص على أن تقتصر أذونات مفاتيح واجهة برمجة التطبيقات على الحد الأدنى من الأذونات لمنع تسرُّب البيانات أو إساءة استخدامها. على سبيل المثال، قد يتمكّن المستخدمون من الوصول إلى "متاجر" أخرى في "بحث الملفات" من المشروع نفسه من خلال هذه الآلية.
- النشر الخارجي الآمن: لتشغيل تطبيق بأمان خارج AI Studio (مثلاً، بعد تنزيل ملف ZIP)، يجب نقل المنطق الذي يستخدم مفتاح واجهة برمجة التطبيقات إلى مكوّن من جهة الخادم لمنع عرض المفتاح للمستخدمين النهائيين. لا يلزم ذلك إذا كنت تنشر باستخدام Cloud Run.
- تحذير بشأن عرض المفتاح: لا يُنصح بشدة باستبدال العنصر النائب بمفتاح API حقيقي في بيئة من جهة العميل، لأنّ المفتاح سيصبح مرئيًا لأي مستخدم.
حدث خطأ أثناء مشاركة التطبيقات
إذا شاركت تطبيقك وواجه المستخدم النهائي الخطأ 403 Access Restricted عند استخدام عنوان URL المشترَك، قد يرجع ذلك إلى أحد الأسباب التالية:
- إضافات المتصفّح: قد تحظر إضافات الخصوصية، مثل Privacy Badger، التطبيق. أوقِف الإضافة لتجنُّب الخطأ.
- مشاكل في الإصدار: قد تكون هناك مشاكل في الرمز الحالي. اطلب من الوكيل "حلّ أي مشاكل في الإصدار باستخدام الرمز الحالي"، ثم أعد مشاركة عنوان URL.
الخطوات التالية
- تطوير تطبيقات الحزمة الكاملة
- يمكنك الاطّلاع على أمثلة في معرض التطبيقات.