إنشاء تطبيقات في 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 بذكاء ملفات متعددة في حزمة التطوير، ما يضمن نشر التغييرات بشكل صحيح.

وكيل Antigravity

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

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

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

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

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

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

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

تطبيقات Android

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

يتكامل AI Studio أيضًا مع Firebase لتطبيقات Android من أجل توفير Firebase AI Logic وفحص التطبيقات من Firebase تلقائيًا (لإجراء طلبات بيانات من واجهة برمجة التطبيقات آمنة من جهة العميل في Gemini API بدون الكشف عن مفاتيح واجهة برمجة التطبيقات الأولية)، بالإضافة إلى Cloud Firestore ومصادقة Firebase.

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

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

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

الإنشاء في Google AI Studio

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

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

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

  • المزامنة مع GitHub: يمكنك ربط تطبيقك بمستودع GitHub لتفعيل المزامنة الثنائية الاتجاه. يمكنك إرسال التغييرات التي تم إجراؤها في AI Studio مباشرةً إلى مستودعك باستخدام رسائل commit من إنشاء الذكاء الاصطناعي، أو سحب التغييرات التي تم إجراؤها محليًا في بيئة التطوير المتكاملة (IDE) أو من قِبل أعضاء الفريق إلى 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 كرمز سرّي في بيئة التطبيق من جهة الخادم. يمكنك الاطّلاع على هذا المفتاح وإدارته في لوحة الرموز السرية.

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

تطبيقات Android

عند إنشاء تطبيقات Android، يستخدم AI Studio Firebase AI Logic و"فحص التطبيقات من Firebase" بدلاً من مفتاح واجهة برمجة تطبيقات أولي، وبالتالي لا يتم تضمين بيانات الاعتماد في حزمة APK مطلقًا.

النشر خارج 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 كرمز سرّي من جهة الخادم. يتم إجراء طلبات بيانات من واجهة برمجة التطبيقات Gemini API في تطبيقك من خلال رمز من جهة الخادم باستخدام هذا المفتاح، لذا لا يتم الكشف عنه مطلقًا في المتصفّح. يمكنك عرض مفتاح واجهة برمجة التطبيقات في لوحة البيانات السرية في الإعدادات. بالنسبة إلى تطبيقات Android، يستخدم AI Studio ميزتَي Firebase AI Logic و"فحص التطبيقات من Firebase" لإجراء طلبات آمنة من جهة العميل بدون تضمين مفتاح واجهة برمجة التطبيقات في الملف الثنائي للتطبيق.

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

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

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

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

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

هل يمكنني تشغيل التطبيقات خارج 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، ما لم يُذكر خلاف ذلك.

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