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

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

البدء

ابدأ البرمجة الوصفية في وضع الإنشاء في Google AI Studio. يمكنك البدء في الإنشاء بعدّة طرق:

  • البدء بطلب: في "وضع الإنشاء"، استخدِم مربّع الإدخال لإدخال وصف لما تريد إنشاءه. اختَر "شرائح الذكاء الاصطناعي" لإضافة ميزات معيّنة، مثل إنشاء الصور أو بيانات "خرائط Google"، إلى طلبك. يمكنك حتى قول ما تريد باستخدام زر تحويل الكلام إلى نص.
  • زر "ضربة حظ": إذا كنت بحاجة إلى استلهام أفكار إبداعية، استخدِم زر "ضربة حظ"، وسينشئ Gemini طلبًا يتضمّن فكرة مشروع لمساعدتك في البدء.
  • إنشاء ريمكس لمشروع من المعرض: افتح مشروعًا من معرض التطبيقات وانقر على نسخ التطبيق.
  • استيراد مشروع من GitHub: في "وضع الإنشاء"، انقر على الاستيراد من GitHub من قائمة إضافة ملفات (رمز +) في مربّع إدخال الطلب لاستيراد الرمز البرمجي الحالي.

بعد تشغيل الطلب، سيتم إنشاء الرمز والملفات اللازمة، وستظهر معاينة مباشرة لتطبيقك على الجانب الأيسر.

ما الذي يتم إنشاؤه؟

عند تشغيل طلبك، ينشئ AI Studio تطبيقًا كاملاً. يمكنك اختيار إنشاء تطبيق ويب أو تطبيق Android أصلي باستخدام أداة اختيار المنصة.

بالنسبة إلى تطبيقات الويب (الإعداد التلقائي)، ينشئ AI Studio بيئة متكاملة تتضمّن ما يلي:

  • من جهة العميل: واجهة أمامية للويب (React هي الواجهة التلقائية).
  • من جهة الخادم: بيئة تشغيل Node.js تتيح إجراء طلبات آمنة إلى واجهة برمجة التطبيقات، وإنشاء اتصالات بقواعد البيانات، واستخدام حِزم npm.

بالنسبة إلى تطبيقات Android، ينشئ AI Studio مشروع Kotlin وJetpack Compose يمكنك معاينته في محاكي مستند إلى المتصفّح وتثبيته على جهاز فعلي ونشره على "متجر Google Play" لاختباره. مزيد من المعلومات حول إنشاء تطبيقات Android

يمكنك الاطّلاع على الرمز الذي يتم إنشاؤه من خلال اختيار علامة التبويب الرمز في جزء المعاينة على اليسار. يدير Antigravity Agent بذكاء ملفات متعددة في حزمة التطبيقات، ما يضمن نشر التغييرات بشكل صحيح.

The Antigravity Agent

وكيل Antigravity هو وظيفة الذكاء الاصطناعي الرئيسية في Google Antigravity، وتعمل المكوّنات الأساسية لوحدة التحكّم بالوكيل الآن على تشغيل تجربة "وضع الإنشاء" في Google AI Studio. وهو يتجاوز مجرد إنشاء الرموز البرمجية البسيطة من خلال الحفاظ على سياق مشروعك بأكمله وإدارة ملفات متعددة وفهم التعليمات المعقدة لإنشاء تطبيقات قوية ومتكاملة.

تشمل الإمكانات الرئيسية ما يلي:

  • إدراك السياق: يحافظ على سياق الطلبات السابقة وحالات الملفات.
  • إدارة الملفات المتعددة: تتعامل مع الاعتماديات في ملفات متعددة.
  • التنفيذ الذي تم التحقّق منه: يتحقّق من تحديثات الرموز البرمجية للحدّ من الهلوسات.

إمكانات الحزمة الكاملة

تتيح لك أداة Google AI Studio الاستفادة من إمكانات منظومة الويب المتكاملة الحديثة، ما يتيح لك إنشاء نماذج أولية تتجاوز تلك التي تعمل على جهة العميل.

  • وقت التشغيل من جهة الخادم وnpm: يمكنك استخدام المكتبة الواسعة لحِزم npm. سيحدّد الوكيل الحِزم ويثبّتها تلقائيًا حسب الحاجة لتطبيقك (مثل مكتبات معيّنة لتصوّر البيانات أو برامج واجهة برمجة التطبيقات). يمكنك أيضًا طلب حِزم معيّنة إذا أردت ذلك.
  • إدارة الأسرار: يمكنك تخزين مفاتيح وأسرار واجهة برمجة التطبيقات بشكل آمن في قائمة الإعدادات. ويمكن الوصول إليها في الرمز البرمجي من جهة الخادم، ما يحافظ على أمانها من التعرّض لها من جهة العميل.
  • اللعب المتعدّد: يمكنك إنشاء تجارب تعاونية في الوقت الفعلي مباشرةً ضمن AI Studio. يدير وقت التشغيل من جهة الخادم الحالة وعمليات الربط اللازمة لتفاعل المستخدمين معًا.
  • Firebase Firestore ومصادقة Firebase: يتم تلقائيًا توفير وإعداد Firebase، بما في ذلك قاعدة بيانات Firestore (تخزين البيانات الدائم) ومصادقة Firebase (عمليات تسجيل الدخول، وتحديدًا "تسجيل الدخول باستخدام Google"). يتولّى الوكيل عملية الإعداد بأكملها، بل ويكتب الرمز البرمجي في تطبيقك لهذه الخدمات.
  • عمليات الدمج مع Google Workspace: يمكنك ربط تطبيقك بواجهات برمجة التطبيقات الخاصة بـ Google Workspace، مثل Gmail و"جداول بيانات Google" و"مستندات Google" وDrive و"تقويم Google" وغيرها. يتولّى AI Studio إعدادات OAuth تلقائيًا.

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

تطبيقات Android

يمكنك أيضًا إنشاء تطبيقات Android أصلية باستخدام Kotlin وJetpack Compose. يمكنك معاينة تطبيقك في محاكي Android مستند إلى المتصفّح، وتثبيته على جهاز فعلي باستخدام "جسر تصحيح أخطاء Android" (ADB) في المتصفّح، ونشره على "متجر Google Play" لإجراء اختبار داخلي.

مزيد من المعلومات حول إنشاء تطبيقات Android

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

بعد أن ينشئ Google AI Studio الرمز الأوّلي لتطبيقك، يمكنك مواصلة تحسينه باتّباع الخطوات التالية:

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

  • التكرار باستخدام Gemini: استخدِم لوحة المحادثة في وضع الإنشاء لطلب إجراء تعديلات أو إضافة ميزات جديدة أو تغيير الأسلوب من Gemini.
  • تعديل الرمز مباشرةً: افتح علامة التبويب "الرمز" في لوحة المعاينة لإجراء تعديلات مباشرة.

التطوير خارجيًا

بالنسبة إلى مهام العمل الأكثر تقدّمًا، يمكنك مزامنة الرمز أو تصديره للعمل في البيئة المفضّلة لديك:

  • المزامنة مع GitHub: اربط تطبيقك بمستودع GitHub لتفعيل المزامنة في الاتجاهين. يمكنك إرسال التغييرات التي تم إنشاؤها في AI Studio مباشرةً إلى المستودع باستخدام رسائل الالتزام التي تم إنشاؤها باستخدام الذكاء الاصطناعي، أو سحب التغييرات التي تم إجراؤها محليًا في بيئة التطوير المتكاملة أو من قِبل أعضاء الفريق إلى AI Studio. يمكنك إدارة حالة المزامنة في أي وقت من خلال علامة التبويب GitHub في "الإعدادات".
  • تنزيل التعليمات البرمجية وتطويرها محليًا: يمكنك تصدير التعليمات البرمجية التي تم إنشاؤها كـ ملف ZIP واستيرادها إلى أداة تعديل الرموز.

الميزات الأساسية

يتضمّن Google AI Studio عدة ميزات لجعل عملية الإنشاء سهلة ومرئية:

  • إنشاء تطبيقات متكاملة وتكرارها: يمكنك إنشاء تطبيقات متكاملة من خلال تقديم طلب بسيط، ثم تكرارها من خلال الدردشة أو وضع التعليقات التوضيحية. يتيح لك وضع التعليق التوضيحي تمييز أي جزء من واجهة مستخدم تطبيقك ووصف التغيير المطلوب.
  • مشاركة تطبيقك ونشره: يمكنك مشاركة إبداعاتك مع الآخرين للتعاون أو عرض عملك. عند المشاركة، يتم احتساب طلبات البيانات من واجهة برمجة التطبيقات ضمن حدود الاستخدام. قد يتم تحصيل رسوم منك إذا استخدمت نماذج مدفوعة. بعد ذلك، عندما يصبح تطبيقك جاهزًا، يمكنك نشره على Cloud Run.
  • معرض التطبيقات: يوفّر "معرض التطبيقات" مكتبة مرئية لأفكار المشاريع. يمكنك استعراض إمكانات Gemini ومعاينة التطبيقات على الفور وإعادة مزجها لتخصيصها.

نشر تطبيقك أو أرشفته

بعد أن يصبح تطبيقك جاهزًا، يمكنك نشره باتّباع الخطوات التالية:

  • ‫Cloud Run: يمكنك نشر تطبيقك كخدمة قابلة للتوسيع. قد يتم تطبيق أسعار Google Cloud Run استنادًا إلى الاستخدام. لمزيد من المعلومات حول عملية النشر، يمكنك الاطّلاع على النشر من Google AI Studio.

  • ‫GitHub: يمكنك مزامنة مشروعك مع مستودع GitHub جديد أو حالي لإدارة الرموز المصدر أو التعاون مع أعضاء الفريق.

القيود

يسرد هذا القسم القيود الحالية لوضع الإنشاء في Google AI Studio.

إدارة مفتاح واجهة برمجة التطبيقات

عند إنشاء تطبيق جديد يستخدم Gemini API، يضبط AI Studio تلقائيًا مفتاح Gemini API كبيانات سرية في بيئة التطبيق من جهة الخادم. يمكنك الاطّلاع على هذا المفتاح وإدارته في لوحة الأسرار.

  • الإعداد التلقائي: يتم إعداد GEMINI_API_KEY تلقائيًا، ولا تحتاج إلى ضبط الإعدادات يدويًا لبدء الإنشاء.
  • من جهة الخادم فقط: يتم إدخال مفاتيح واجهة برمجة التطبيقات في وقت التشغيل من جهة الخادم، ولا يتم تضمينها مطلقًا في الرمز البرمجي من جهة العميل.
  • التطبيقات الحالية: بالنسبة إلى التطبيقات التي تم إنشاؤها قبل 14 مايو 2026، سيقوم الوكيل تلقائيًا بترقية عملية الدمج مع Gemini API إلى الطريقة المقترَحة من جهة الخادم في المرة التالية التي تعدّل فيها ميزات Gemini في التطبيق.

النشر خارج Google AI Studio

  • ‫Cloud Run: عند النشر إلى Cloud Run من AI Studio، يتم تضمين مفتاح واجهة برمجة التطبيقات بشكل آمن في بيئة من جهة الخادم. سيستخدم التطبيق الذي تم نشره مفتاح واجهة برمجة التطبيقات لجميع طلبات المستخدمين إلى Gemini API.
  • تنزيل ملف ZIP: إذا نزّلت تطبيقك كملف ZIP لتشغيله في مكان آخر، عليك إعداد GEMINI_API_KEYمتغير البيئة في بيئة الاستضافة. بما أنّ طلبات Gemini API التي يرسلها تطبيقك تتم من رمز من جهة الخادم، لن يتم عرض المفتاح للمستخدمين النهائيين.

حدث خطأ أثناء مشاركة التطبيقات

إذا شاركت تطبيقك وواجه المستخدم النهائي الخطأ 403 Access Restricted عند استخدام عنوان URL الذي تمت مشاركته، قد يرجع ذلك إلى أحد الأسباب التالية:

  • إضافات المتصفّح: قد تحظر إضافات الخصوصية، مثل Privacy Badger، التطبيق. أوقِف الإضافة لتجنُّب حدوث الخطأ.
  • مشاكل في الإصدار: قد تكون هناك مشاكل في الرمز الحالي. اطلب من الوكيل "حلّ أي مشاكل في الإصدار باستخدام الرمز الحالي"، ثم أعِد مشاركة عنوان URL.

الأسئلة الشائعة

ما هي ميزة "إنشاء" في AI Studio؟

‫AI Studio Build هي منصة مصمَّمة لمساعدتك في إنشاء تطبيق مستند إلى الذكاء الاصطناعي وجاهز للنشر باستخدام Gemini، وذلك بدءًا من طلب بسيط. ما عليك سوى وصف ما تريد إنشاءه من خلال طلب، وسينشئ Gemini تطبيقًا لك. يمكنك أيضًا استكشاف معرضنا لمعرفة الإمكانات التي تتيحها Gemini API، وإعادة دمج التطبيقات لتخصيصها.

كيف يتعامل Build مع مفتاح Gemini API؟

عند إنشاء تطبيق يستخدم Gemini API، يضبط AI Studio تلقائيًا مفتاح Gemini API كبيانات سرية من جهة الخادم. يتم إجراء طلبات البيانات من واجهة برمجة التطبيقات Gemini في تطبيقك من رمز من جهة الخادم باستخدام هذا المفتاح، وبالتالي لا يتم عرضه أبدًا في المتصفّح. يمكنك الاطّلاع على مفتاح واجهة برمجة التطبيقات في لوحة الأسرار ضمن "الإعدادات".

هل يتم الكشف عن مفتاح واجهة برمجة التطبيقات عند مشاركة التطبيقات؟

لا، يتم تخزين مفتاح واجهة برمجة التطبيقات كبيانات سرية على الخادم ولا يتم تضمينه أبدًا في الرمز البرمجي من جهة العميل. عند مشاركة تطبيقك، يمكن للمستخدمين الآخرين استخدامه، ولكن لا يمكنهم الاطّلاع على مفتاح واجهة برمجة التطبيقات.

عند مشاركة تطبيقاتك مع الآخرين، يتم احتساب طلبات البيانات من واجهة برمجة التطبيقات ضمن حدود الاستخدام. قد يتم تحصيل رسوم منك إذا استخدمت نماذج مدفوعة. سيُعلمك "استوديو الذكاء الاصطناعي" بذلك أثناء عملية الإعداد وقبل المشاركة إذا كان تطبيقك قد يتكبّد تكاليف.

مَن يمكنه الاطّلاع على تطبيقاتي؟

يكون تطبيقك خاصًا تلقائيًا. يمكنك مشاركة تطبيقك مع مستخدمين آخرين ليتمكّنوا من استخدامه. يمكن للمستخدمين الذين تشارك معهم تطبيقك الاطّلاع على رمزه البرمجي وإنشاء نسخة منه لأغراضهم الخاصة. إذا شاركت تطبيقك مع إذن التعديل، يمكن للمستخدمين الآخرين تعديل رمز تطبيقك.

هل يمكنني تشغيل التطبيقات خارج AI Studio؟

نعم. يمكنك نشر تطبيقك على Cloud Run من AI Studio، ما يمنح تطبيقك عنوان URL عامًا مع إعداد مفتاح واجهة برمجة التطبيقات بشكل آمن في بيئة من جهة الخادم. يمكنك أيضًا تنزيل تطبيقك كملف ZIP واستضافته في مكان آخر، ولكن عليك ضبط متغير البيئة GEMINI_API_KEY في بيئة الاستضافة. بما أنّ طلبات البيانات من Gemini API تتم من الرمز البرمجي من جهة الخادم، يظل مفتاحك آمنًا.

لمزيد من المعلومات حول خيارات النشر، يُرجى الاطّلاع على مقالة النشر من Google AI Studio.

هل يمكنني تطوير تطبيقات محليًا باستخدام أدواتي الخاصة ثم مشاركتها هنا؟

نعم. يمكنك ربط تطبيقك في AI Studio بمستودع GitHub لتطويره محليًا باستخدام محرّر الرموز البرمجية أو أدوات واجهة سطر الأوامر المفضّلة لديك، ونقل التغييرات إلى GitHub، ثم استرداد هذه التحديثات مباشرةً إلى AI Studio باستخدام علامة التبويب GitHub في "الإعدادات".

كيف يمكنني استخدام قاعدة بيانات أو مساحة تخزين أخرى مع تطبيقاتي؟

تطبيقات AI Studio هي تطبيقات عادية تعمل في حاوية Cloud Run. يمكنك استخدام أي حل تخزين يمكنك الاتصال به عبر شبكة، طالما لا يوجد جدار حماية يمنع الوصول من نطاق عناوين IP ديناميكي.

نعمل على إضافة ميزة الدعم المباشر للتخزين في المستقبل، وستتمكّن من ضبطها مباشرةً في AI Studio.

للتأكّد من أنّ المشاهدين على دراية باستخدام التطبيق لكاميرا الويب أو الأجهزة الأخرى، نطلب منهم تقديم إقرار إضافي قبل أن يتمكّن التطبيق من الوصول إلى واجهات برمجة التطبيقات Navigator هذه. يمكن لمطوّري التطبيقات إضافة طلبات الأذونات هذه إلى ملف metadata.json الخاص بتطبيقاتهم. على سبيل المثال:

{
  "name": "My app",
  "requestFramePermissions": [
    "microphone",
    "camera",
    "display-capture",
    "geolocation",
    "bluetooth",
    "clipboard-read",
    "serial",
    "usb"
  ]
}

تشكّل القيم المسموح بها في requestFramePermissions مجموعة فرعية من الميزات العادية التي تتحكّم فيها السياسات.

كيف يمكنني استخدام GitHub مع تطبيقاتي؟

يتيح AI Studio مزامنة المحتوى في اتجاهَين مع GitHub:

  • استيراد مستودع: في "وضع الإنشاء"، انقر على الاستيراد من GitHub من قائمة إضافة ملفات (رمز علامة الجمع) في مربّع إدخال الطلب لاستيراد الرموز البرمجية الحالية.
  • ربط مستودع: في "الإعدادات"، افتح علامة التبويب GitHub لإنشاء مستودع GitHub جديد من تطبيقك أو الربط بمستودع حالي.
  • المزامنة في اتجاهَين: يمكنك إرسال التغييرات التي تم إنشاؤها في AI Studio مباشرةً إلى المستودع باستخدام رسائل الالتزام التي تم إنشاؤها باستخدام الذكاء الاصطناعي، أو سحب التغييرات التي تم إجراؤها خارجيًا (مثل تعديلات بيئة التطوير المتكاملة المحلية أو طلبات السحب التي أرسلها أعضاء الفريق) إلى AI Studio.
  • حلّ تعارضات الدمج: إذا تعارضت التغييرات عند المزامنة مع GitHub، يوفّر AI Studio مربّع حوار حلّ التعارضات مع أداة عرض الاختلافات جنبًا إلى جنب، ما يتيح لك مراجعة الاختلافات واختيار ما إذا كنت تريد الاحتفاظ بنسخة AI Studio أو GitHub لكل ملف متضارب.

هل يمكنني منح مستخدمين آخرين إذن تعديل تطبيقي؟

لا يتيح AI Studio التعديل التعاوني المباشر في الوقت الفعلي. ومع ذلك، يمكنك التعاون مع زملائك في الفريق من خلال ربط تطبيقك بمستودع GitHub مشترك. يمكن لأعضاء الفريق إرسال التغييرات أو فتح طلبات سحب على GitHub، ويمكنك سحب هذه التحديثات إلى AI Studio.

لماذا تم الإبلاغ عن تطبيقي بسبب انتهاك السياسة؟

لدينا أنظمة تراجع التطبيقات تلقائيًا للتأكّد من امتثالها لسياساتنا. إذا تبيّن لنا أنّ أحد التطبيقات ينتهك سياساتنا، ستتم إزالته من AI Studio. يمكن أن تشمل انتهاكات السياسات، على سبيل المثال لا الحصر، ما يلي:

  • التطبيقات التي تحتوي على برامج ضارة أو تصيّد احتيالي أو انتحال هوية
  • التطبيقات التي تعرض أو توزع محتوًى ينتهك سياسة صور الاعتداء الجنسي على الأطفال
  • التطبيقات التي تعرض أو توزّع محتوًى يخالف سياسة التحرّش
  • التطبيقات التي تعرض أو توزّع محتوًى يخالف سياسة الكلام الذي يحض على الكراهية
  • التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة الاتجار بالبشر
  • التطبيقات التي تعرض أو توزع محتوًى ينتهك سياسة المحتوى الجنسي الفاضح
  • التطبيقات التي تعرض أو توزّع المحتوى العنيف والدموي الذي يخالف السياسة
  • التطبيقات التي تعرض أو توزّع محتوًى ينتهك سياسة المحتوى الضار أو الخطير

إذا تم الإبلاغ عن تطبيقك بسبب انتهاكه سياسةً معينةً، وكنت تعتقد أنّ هذا الإبلاغ غير صحيح، يمكنك إرسال طلب بإعادة النظر. وقد تؤدي الانتهاكات المتكررة لسياساتنا إلى إيقاف إمكانية الوصول إلى AI Studio.

ما هي مسؤولياتي بصفتي مطوّر تطبيقات؟

نذكّرك بأنّك بصفتك مالك التطبيق، تتحمّل مسؤولية سلوكه وجميع البيانات التي يعالجها. يشمل ذلك ما يلي:

  • الامتثال القانوني وحقوق الجهات الخارجية: يجب التأكّد من أنّ تطبيقك يمتثل لجميع القوانين واللوائح التنظيمية السارية ولا ينتهك حقوق الآخرين، بما في ذلك حقوق الملكية الفكرية وحقوق الخصوصية.
  • رصد المحتوى: قد ينطبق الالتزام بالبنود الإضافية على الخدمات الأخرى التي يستخدمها تطبيقك. على سبيل المثال، تتطلّب بنود خدمة Google Cloud السارية على Firestore من العملاء الذين يستضيفون محتوى تابعًا لجهات خارجية نشر سياسات تحدّد المحتوى المحظور (مثل المحتوى غير القانوني) ورصد وجود هذا المحتوى غير القانوني.
  • التنفيذ الآمن: تنفيذ إجراءات الوقاية وأدوات الإشراف اللازمة لمنع إساءة استخدام تطبيقك

يُرجى التعرّف على قيود الاستخدام في "بنود الخدمة".

تنطبق بنود الخدمة الإضافية الخاصة بـ Gemini API على استخدام التطبيقات المعروضة في معرض التطبيقات في AI Studio، ما لم يُذكر خلاف ذلك.

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