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

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

البدء

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

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

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

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

عند تنفيذ طلبك، ينشئ AI Studio تطبيقًا كاملاً. بشكل تلقائي، تنشئ هذه الأداة بيئة متكاملة يمكن أن تشمل ما يلي:

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

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

العميل Antigravity

وكيل 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 ومعاينة التطبيقات على الفور، وإعادة مزجها لتصبح من تصميمك.

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

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

  • ‫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.

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

ما هي ميزة "إنشاء التطبيقات" في AI Studio؟

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

لماذا يستدعي Build واجهة Gemini API من الرمز البرمجي من جهة العميل؟

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

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

لا تستخدِم مفتاح واجهة برمجة تطبيقات حقيقيًا في تطبيقك، بل استخدِم قيمة عنصر نائب بدلاً من ذلك. يتم ضبط process.env.GEMINI_API_KEY على قيمة عنصر نائب يمكنك استخدامها. عندما يستخدم مستخدم آخر تطبيقك، يرسل AI Studio طلبات إلى واجهة Gemini API بالنيابة عنك، ويستبدل قيمة العنصر النائب بمفتاح واجهة برمجة التطبيقات الخاص بالمستخدم (وليس مفتاحك). لا تستخدِم مفتاح واجهة برمجة تطبيقات حقيقيًا في تطبيقك، لأنّ الرمز البرمجي يظهر لأي شخص يمكنه عرض تطبيقك.

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

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

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

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

هل يمكنني تطوير تطبيقات على الجهاز باستخدام أدواتي الخاصة ثم مشاركتها هنا؟

هذه الوظيفة غير متاحة بعد. يسرّنا أن نتيح المزيد من حالات استخدام التطبيقات في المستقبل. يُرجى تقديم ملاحظاتك إذا كان لديك أي أفكار محدّدة.

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

تطبيقات 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 مع تطبيقاتي؟

يتيح لك دمج GitHub في AI Studio إنشاء مستودع لعملك وإضافة آخر التغييرات التي أجريتها. لا نتيح حاليًا سحب التغييرات عن بُعد.

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

هذه الميزة غير متاحة بعد، ولكنّها ستصبح متاحة قريبًا.

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

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

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

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

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

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

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

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

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

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