توضّح هذه الصفحة كيفية استخدام 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 يمكنك معاينته في محاكي مستند إلى المتصفّح وتثبيته على جهاز فعلي، ونشره على "متجر Play" لإجراء الاختبار. مزيد من المعلومات حول إنشاء تطبيقات Android apps.
يمكنك الاطّلاع على الرمز البرمجي الذي يتم إنشاؤه من خلال النقر على علامة التبويب الرمز في لوحة المعاينة على الجانب الأيسر. يدير وكيل Antigravity بذكاء ملفات متعدّدة على مستوى حزمتك، ما يضمن نشر التغييرات بشكل صحيح.
وكيل Antigravity
وكيل Antigravity هو وظيفة الذكاء الاصطناعي الرئيسية في Google Antigravity، وتعمل الآن المكوّنات الأساسية لحزمة الوكيل على تشغيل تجربة "وضع الإنشاء" في Google AI Studio. يتجاوز هذا الوكيل مجرد إنشاء الرموز البرمجية من خلال الحفاظ على سياق مشروعك بالكامل وإدارة ملفات متعدّدة وفهم التعليمات المعقّدة لإنشاء تطبيقات قوية وكاملة.
تشمل الإمكانات الرئيسية ما يلي:
- الوعي بالسياق: يحافظ على سياق الطلبات السابقة وحالات الملفات.
- إدارة ملفات متعدّدة: يعالج التبعيات على مستوى ملفات متعدّدة.
- التنفيذ الذي تم التحقّق منه: يتحقّق من تعديلات الرمز البرمجي للحدّ من الهلوسات.
إمكانات الحزمة الكاملة
يطلق Google AI Studio قوة النظام المتكامل الحديث للويب، ما يتيح لك إنشاء أكثر من مجرد نماذج أولية من جهة العميل.
- وقت التشغيل من جهة الخادم وnpm: استخدِم المكتبة الواسعة لحِزم npm. سيحدّد الوكيل الحِزم ويثبّتها تلقائيًا حسب الحاجة لتطبيقك (مثل مكتبات معيّنة لتصوّر البيانات أو برامج واجهة برمجة التطبيقات من جهة العميل). يمكنك أيضًا طلب حِزم معيّنة إذا أردت ذلك.
- إدارة الأسرار: يمكنك تخزين مفاتيح واجهة برمجة التطبيقات والأسرار بشكل آمن في قائمة الإعدادات. يمكن الوصول إلى هذه العناصر في الرمز البرمجي من جهة الخادم، ما يحميها من العرض من جهة العميل.
- تعدد اللاعبين: يمكنك إنشاء تجارب تعاونية في الوقت الفعلي مباشرةً في AI Studio. يدير وقت التشغيل من جهة الخادم الحالة والاتصالات اللازمة لتفاعل المستخدمين معًا.
- Firebase Firestore وFirebase Authentication: يمكنك توفير Firebase وإعداده تلقائيًا، بما في ذلك قاعدة بيانات Firestore (تخزين البيانات المستمر) و Firebase Authentication (عمليات تسجيل الدخول، وتحديدًا "تسجيل الدخول باستخدام Google"). يتولّى الوكيل عملية الإعداد بالكامل ويكتب حتى الرمز البرمجي في تطبيقك لهذه الخدمات.
- عمليات الدمج مع Google Workspace: يمكنك ربط تطبيقك بواجهات برمجة تطبيقات Google Workspace ، مثل Gmail و"جداول بيانات Google" و"مستندات Google" وGoogle Drive و"تقويم Google" وغير ذلك. يتولّى AI Studio جميع إعدادات OAuth تلقائيًا.
مزيد من المعلومات حول تطوير تطبيقات الحزمة الكاملة
تطبيقات Android
يمكنك أيضًا إنشاء تطبيقات Android أصلية باستخدام Kotlin وJetpack Compose. يمكنك معاينة تطبيقك في محاكي Android مستند إلى المتصفّح وتثبيته على جهاز فعلي باستخدام ADB في المتصفّح ونشره على "متجر Play" لإجراء الاختبار الداخلي.
مزيد من المعلومات حول إنشاء تطبيقات Android
متابعة الإنشاء
بعد أن ينشئ Google AI Studio الرمز البرمجي الأوّلي لتطبيقك، يمكنك مواصلة تحسينه:
الإنشاء في Google AI Studio
- التكرار باستخدام Gemini: استخدِم لوحة المحادثة في وضع الإنشاء لطلب إجراء تعديلات أو إضافة ميزات جديدة أو تغيير التصميم من Gemini.
- تعديل الرمز البرمجي مباشرةً: افتح علامة التبويب "الرمز" في لوحة المعاينة لإجراء تعديلات مباشرة.
التطوير خارجيًا
بالنسبة إلى مهام العمل الأكثر تقدّمًا، يمكنك تصدير الرمز البرمجي والعمل في البيئة المفضّلة لديك:
- التنزيل والتطوير محليًا: يمكنك تصدير الرمز البرمجي الذي تم إنشاؤه كـ ملف ZIP واستيراده إلى أداة تعديل الرموز البرمجية.
- النشر على GitHub: يمكنك دمج الرمز البرمجي مع عمليات التطوير الحالية و عمليات النشر من خلال نشره على مستودع GitHub.
الميزات الرئيسية
يتضمّن 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: تم حظر الوصول عند استخدام عنوان URL الذي تمت مشاركته، قد يرجع ذلك إلى أحد الأسباب التالية:
- إضافات المتصفّح: قد تحظر إضافات الخصوصية، مثل Privacy Badger، التطبيق. عليك إيقاف الإضافة لتجنُّب الخطأ.
- مشاكل في الإنشاء: قد تكون هناك مشاكل في الرمز البرمجي الحالي. اطلب من الوكيل "إصلاح أي مشاكل في الإنشاء في الرمز البرمجي الحالي"، ثم أعد مشاركة عنوان URL.
الأسئلة الشائعة
ما هو "وضع الإنشاء" في AI Studio؟
"وضع الإنشاء" في AI Studio هو منصة مصمّمة لنقلك من طلب بسيط إلى تطبيق مستنِد إلى الذكاء الاصطناعي وجاهز للإنتاج باستخدام Gemini. يمكنك وصف ما تريد إنشاءه باستخدام طلب، وسينشئ Gemini تطبيقًا لك. يمكنك أيضًا استكشاف المعرض للاطّلاع على الإمكانات المتاحة باستخدام Gemini API وإعادة مزج التطبيقات لتخصيصها.
كيف يتعامل "وضع الإنشاء" مع مفتاح Gemini API؟
عند إنشاء تطبيق يستخدم Gemini API، يضبط AI Studio تلقائيًا مفتاح Gemini API كسرّ من جهة الخادم. يتم إجراء طلبات Gemini API الخاصة بتطبيقك من الرمز البرمجي من جهة الخادم باستخدام هذا المفتاح، لذا لا يتم عرضه مطلقًا في المتصفّح. يمكنك الاطّلاع على مفتاح واجهة برمجة التطبيقات في لوحة الأسرار في "الإعدادات".
هل يتم عرض مفتاح واجهة برمجة التطبيقات عند مشاركة التطبيقات؟
لا، يتم تخزين مفتاح واجهة برمجة التطبيقات كسرّ من جهة الخادم ولا يتم تضمينه مطلقًا في الرمز البرمجي من جهة العميل. عند مشاركة تطبيقك، يمكن للمستخدمين الآخرين استخدامه، ولكن لا يمكنهم الاطّلاع على مفتاح واجهة برمجة التطبيقات.
عند مشاركة تطبيقاتك مع الآخرين، يتم احتساب طلبات واجهة برمجة التطبيقات ضمن حدود الاستخدام. قد يتم فرض رسوم إذا كنت تستخدم نماذج مدفوعة. سيُعلمك AI Studio مسبقًا أثناء الإعداد وقبل المشاركة إذا كان تطبيقك قد يتكبّد تكاليف.
مَن يمكنه الاطّلاع على تطبيقاتي؟
يكون تطبيقك خاصًا بشكل تلقائي. يمكنك مشاركة تطبيقك مع مستخدمين آخرين للسماح لهم باستخدامه. يمكن للمستخدمين الذين تشارك معهم تطبيقك الاطّلاع على الرمز البرمجي ونسخه لأغراضهم الخاصة. إذا شاركت تطبيقك مع إذن التعديل، يمكن للمستخدمين الآخرين تعديل الرمز البرمجي لتطبيقك.
هل يمكنني تشغيل التطبيقات خارج AI Studio؟
نعم. يمكنك نشر تطبيقك على
Cloud Run من AI Studio، ما
يمنح تطبيقك عنوان URL علنيًا مع إعداد مفتاح واجهة برمجة التطبيقات بشكل آمن في
بيئة الخادم من جهة الخادم. يمكنك أيضًا تنزيل تطبيقك كملف ZIP واستضافته في مكان آخر، ولكن عليك ضبط متغيّر البيئة GEMINI_API_KEY في بيئة الاستضافة. بما أنّ طلبات Gemini API يتم إجراؤها من الرمز البرمجي من جهة الخادم، يظل مفتاحك آمنًا.
لمزيد من المعلومات حول خيارات النشر، راجِع النشر من Google AI Studio.
هل يمكنني تطوير التطبيقات محليًا باستخدام أدواتي الخاصة ثم مشاركتها هنا؟
هذه الوظيفة غير متاحة بعد. نحن متحمّسون لتوفير المزيد من حالات الاستخدام للتطبيقات في المستقبل. يُرجى تقديم ملاحظاتك إذا كان لديك أي شيء محدّد في ذهنك.
كيف يمكنني استخدام قاعدة بيانات أو مساحة تخزين أخرى مع تطبيقاتي؟
تطبيقات AI Studio هي تطبيقات عادية يتم تشغيلها في حاوية Cloud Run. يمكنك استخدام أي حلّ تخزين يمكنك الاتصال به عبر شبكة، طالما لا يوجد جدار حماية يمنع الوصول من نطاق IP ديناميكي.
نحن نعمل على إضافة دعم مباشر لمساحة التخزين في المستقبل، وسيصبح بإمكانك ضبطها مباشرةً في AI Studio.
كيف يمكنني الوصول إلى الميكروفون وكاميرا الويب وواجهات برمجة تطبيقات Navigator الأخرى؟
لضمان علم المشاهدين باستخدام التطبيق لكاميرا الويب أو الأجهزة الأخرى
، نطلب إقرارًا إضافيًا قبل أن يتمكّن التطبيق من الوصول إلى
واجهات برمجة تطبيقات Navigator هذه.
يمكن لمُنشئي التطبيقات إضافة طلبات الأذونات هذه إلى ملف metadata.json الخاص بتطبيقهم. على سبيل المثال:
{
"name": "My app",
"requestFramePermissions": [
"microphone",
"camera",
"display-capture",
"geolocation",
"bluetooth",
"clipboard-read",
"serial",
"usb"
]
}
القيم المسموح بها لـ requestFramePermissions هي مجموعة فرعية من الـ
ميزات العادية التي تتحكّم فيها السياسة.
كيف يمكنني استخدام GitHub مع تطبيقاتي؟
يتيح لك التكامل مع GitHub في AI Studio استيراد مشروع حالي من GitHub لبدء الإنشاء، أو تصدير مشروعك إلى مستودع GitHub وإجراء آخر التغييرات.
هل يمكنني منح مستخدمين آخرين إذن تعديل تطبيقي؟
هذه الميزة غير متاحة بعد، ولكن ستُتاح قريبًا.
لماذا تم وضع علامة على تطبيقي بسبب انتهاك السياسة؟
لدينا أنظمة تراجع التطبيقات تلقائيًا للتأكّد من امتثالها لسياساتنا. إذا تبيّن لنا أنّ تطبيقًا يخالف سياساتنا، ستتم إزالته من AI Studio. يمكن أن تشمل انتهاكات السياسة، على سبيل المثال لا الحصر، ما يلي:
- التطبيقات التي تحتوي على برامج ضارة أو تصيّد احتيالي أو انتحال هوية
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة صور الاعتداء الجنسي على الأطفال
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة التحرّش
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة خطاب الكراهية
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة الاتجار بالبشر
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة المحتوى الجنسي الفاضح
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة العنف والمشاهد الدموية
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة المحتوى الضار أو الخطير
إذا تم وضع علامة على تطبيقك بسبب انتهاك السياسة، وكنت تعتقد أنّ ذلك حدث عن طريق الخطأ، يمكنك إرسال طلب بإعادة النظر. قد تؤدي الانتهاكات المتكرّرة لسياساتنا إلى إنهاء إمكانية وصولك إلى AI Studio.
ما هي مسؤولياتي بصفتي مطوّر تطبيقات؟
للتذكير، بصفتك مالك تطبيقك، تقع على عاتقك مسؤولية سلوكه وجميع البيانات التي يعالجها. يشمل ذلك ما يلي:
- الامتثال للقوانين وحقوق الأطراف الثالثة: يجب التأكّد من امتثال تطبيقك لجميع القوانين واللوائح السارية وعدم انتهاك حقوق الآخرين، بما في ذلك حقوق الملكية الفكرية وحقوق الخصوصية.
- مراقبة المحتوى: قد تنطبق بنود إضافية على الخدمات الأخرى التي يستخدمها تطبيقك. على سبيل المثال، تتطلب بنود خدمة Google Cloud، السارية على Firestore، من العملاء الذين يستضيفون محتوًى تابعًا لجهة خارجية نشر سياسات تحدّد المحتوى المحظور (مثل المحتوى غير القانوني) ومراقبة هذا المحتوى غير القانوني.
- التنفيذ الآمن: يجب تنفيذ الضمانات وأدوات الإشراف اللازمة لمنع إساءة استخدام تطبيقك.
يُرجى العِلم بقيود الاستخدام في بنود الخدمة.
ما هي البنود التي تنطبق على التطبيقات في "معرض التطبيقات" في AI Studio؟
تنطبق بنود الخدمة الإضافية الخاصة بـ Gemini API على استخدام التطبيقات المعروضة في "معرض التطبيقات" في AI Studio، ما لم يُنص على خلاف ذلك.
الخطوات التالية
- تطوير تطبيقات الحزمة الكاملة (الويب)
- إنشاء تطبيقات Android
- الاطّلاع على أمثلة في معرض التطبيقات.