إنشاء تطبيقات في Google AI Studio

توضّح هذه الصفحة كيفية استخدام Google AI Studio لإنشاء (أو "كتابة رمز برمجي سريع") ونشر تطبيقات تختبر أحدث إمكانات Gemini، مثل Nano Banana وLive API. يتيح Google AI Studio الآن استخدام وقت تشغيل كامل المكدس، ما يسمح لك بإنشاء تطبيقات قوية تتضمّن منطقًا من جهة الخادم وإدارة آمنة للأسرار ودعم حِزم npm، وكل ذلك من خلال طلبات باللغة الطبيعية.

البدء

ابدأ الترميز باستخدام Vibe في وضع الإنشاء في 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. يدير وقت التشغيل من جهة الخادم الحالة وعمليات الربط المطلوبة لكي يتفاعل المستخدمون معًا.

مزيد من المعلومات عن تطوير تطبيقات متكاملة

مواصلة الإنشاء

بعد أن ينشئ 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.

الخطوات التالية