توضّح هذه الصفحة كيفية استخدام Google AI Studio لإنشاء التطبيقات ونشرها بسرعة (أو "البرمجة الوصفية") التي تختبر أحدث إمكانات Gemini، مثل Nano Banana وLive API. يتيح لك Google AI Studio الآن استخدام وقت تشغيل كامل المكدس، ما يسمح لك بإنشاء تطبيقات قوية تتضمّن منطقًا من جهة الخادم، وإدارة آمنة للبيانات السرية ودعم حزمة npm، وكل ذلك من خلال طلبات باللغة الطبيعية.
البدء
ابدأ البرمجة الوصفية في وضع "الإنشاء" في Google AI Studio. يمكنك بدء الإنشاء بعدة طرق:
- ابدأ بطلب: في وضع "الإنشاء"، استخدِم مربّع الإدخال لإدخال وصف لما تريد إنشاؤه. انقر على "شرائح الذكاء الاصطناعي" لإضافة ميزات معيّنة، مثل إنشاء الصور أو بيانات "خرائط Google"، إلى طلبك. يمكنك حتى التحدث بما تريد باستخدام زر تحويل الكلام إلى نص.
- زر "ضربة حظ": إذا كنت بحاجة إلى إطلاق العنان لإبداعك، استخدِم زر "ضربة حظ"، وسينشئ Gemini طلبًا يتضمّن فكرة مشروع لمساعدتك في البدء.
- إعادة مزج مشروع من المعرض: افتح مشروعًا من معرض التطبيقات وانقر على نسخ التطبيق.
بعد تشغيل الطلب، ستظهر لك التعليمات البرمجية والملفات اللازمة التي يتم إنشاؤها، مع معاينة مباشرة لتطبيقك تظهر على الجانب الأيسر.
ما الذي يتم إنشاؤه؟
عند تشغيل طلبك، ينشئ AI Studio تطبيقًا كاملاً. ينشئ بشكل تلقائي بيئة كاملة المكدس يمكن أن تشمل ما يلي:
- من جهة العميل: واجهة أمامية للويب (React هي الواجهة التلقائية).
- من جهة الخادم: وقت تشغيل Node.js يتيح إجراء طلبات آمنة من واجهة برمجة التطبيقات، الاتصال بقواعد البيانات واستخدام حزمة npm.
يمكنك عرض الرمز الذي يتم إنشاؤه من خلال النقر على علامة التبويب الرمز في لوحة المعاينة على الجانب الأيسر. يدير برنامج Antigravity بذكاء ملفات متعدّدة على مستوى مكدسك، ما يضمن نشر التغييرات بشكل صحيح.
برنامج 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.
- تحذير بشأن عرض المفتاح: يُنصح بشدة بعدم استبدال العنصر النائب بمفتاح واجهة برمجة تطبيقات حقيقي في بيئة من جهة العميل، لأنّ المفتاح سيصبح مرئيًا لأي مستخدم.
حدث خطأ أثناء مشاركة التطبيقات
إذا شاركت تطبيقك وواجه المستخدم النهائي الخطأ 403 تم حظر الوصول عند استخدام عنوان URL الذي تمت مشاركته، قد يرجع ذلك إلى أحد الأسباب التالية:
- إضافات المتصفّح: قد تحظر إضافات الخصوصية، مثل Privacy Badger، التطبيق. يمكنك إيقاف الإضافة لتجنُّب الخطأ.
- مشاكل في الإنشاء: قد تكون هناك مشاكل في الرمز الحالي. اطلب من البرنامج "إصلاح أي مشاكل في الإنشاء في الرمز الحالي"، ثم أعِد مشاركة عنوان URL.
الأسئلة الشائعة
ما هو وضع "الإنشاء" في AI Studio؟
وضع "الإنشاء" في AI Studio هو منصة مصمّمة لنقلك من طلب بسيط إلى تطبيق مستنِد إلى الذكاء الاصطناعي وجاهز للاستخدام في مرحلة الإنتاج باستخدام Gemini. صِف ما تريد إنشاؤه باستخدام طلب، وسينشئ Gemini تطبيقًا لك. يمكنك أيضًا استكشاف معرضنا للاطّلاع على الإمكانات المتاحة باستخدام Gemini API وإعادة مزج التطبيقات لتخصيصها.
لماذا يطلب وضع "الإنشاء" بيانات من 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 الأخرى؟
لضمان علم المشاهدين باستخدام التطبيق لكاميرا الويب أو الأجهزة الأخرى
، نطلب إقرارًا إضافيًا قبل أن يتمكّن التطبيق من الوصول إلى
واجهات برمجة تطبيقات Navigator هذه.
يمكن لمطوّري التطبيقات إضافة طلبات الأذونات هذه إلى ملف metadata.json الخاص بتطبيقهم. على سبيل المثال:
{
"name": "My app",
"requestFramePermissions": [
"microphone",
"camera",
"display-capture",
"geolocation",
"bluetooth",
"clipboard-read",
"serial",
"usb"
]
}
القيم المسموح بها لـ requestFramePermissions هي مجموعة فرعية من الـ
ميزات العادية التي تتحكّم فيها السياسة.
كيف يمكنني استخدام GitHub مع تطبيقاتي؟
يتيح لك التكامل مع GitHub في AI Studio إنشاء مستودع لعملك وإرسال أحدث التغييرات. لا نتيح حاليًا جلب التغييرات عن بُعد.
هل يمكنني منح مستخدمين آخرين إذن تعديل تطبيقي؟
هذه الميزة غير متاحة بعد، ولكنّها ستُتاح قريبًا.
لماذا تم وضع علامة على تطبيقي بسبب انتهاك السياسة؟
لدينا أنظمة تراجع التطبيقات تلقائيًا للتأكّد من امتثالها لسياساتنا. إذا تبيّن لنا أنّ أحد التطبيقات يخالف سياساتنا، ستتم إزالته من AI Studio. يمكن أن تشمل انتهاكات السياسة، على سبيل المثال لا الحصر، ما يلي:
- التطبيقات التي تحتوي على برامج ضارة أو تصيّد احتيالي أو انتحال هوية
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة صور الاعتداء الجنسي على الأطفال
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة التحرّش
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة الكلام الذي يحضّ على الكراهية
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة الاتجار بالبشر
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة المحتوى الجنسي الفاضح
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة المحتوى العنيف والدموي
- التطبيقات التي تعرض أو توزع محتوًى يخالف سياسة المحتوى الضار أو الخطير
إذا تم وضع علامة على تطبيقك بسبب انتهاك السياسة، وكنت تعتقد أنّه تم ذلك عن طريق الخطأ، يمكنك إرسال طلب بإعادة النظر. قد تؤدي الانتهاكات المتكرّرة لسياساتنا إلى إنهاء إمكانية وصولك إلى AI Studio.
ما هي مسؤولياتي بصفتي مطوّر تطبيقات؟
للتذكير، بصفتك مالك تطبيقك، أنت مسؤول عن سلوكه وجميع البيانات التي يعالجها. يشمل ذلك ما يلي:
- الامتثال للقانون وحقوق الطرف الثالث: يجب التأكّد من امتثال تطبيقك لجميع القوانين واللوائح السارية وعدم انتهاك حقوق الآخرين، بما في ذلك حقوق الملكية الفكرية وحقوق الخصوصية.
- مراقبة المحتوى: قد تنطبق بنود إضافية على الخدمات الأخرى التي يستخدمها تطبيقك. على سبيل المثال، تتطلب بنود خدمة Google Cloud، السارية على Firestore، من العملاء الذين يستضيفون محتوى تابعًا لجهة خارجية نشر سياسات تحدّد المحتوى المحظور (مثل المحتوى غير القانوني) ورصد هذا المحتوى غير القانوني.
- التنفيذ الآمن: يجب تنفيذ الضمانات وأدوات الإشراف اللازمة لمنع إساءة استخدام تطبيقك.
يُرجى العِلم بقيود الاستخدام في بنود الخدمة.
ما هي البنود السارية على التطبيقات في معرض التطبيقات في AI Studio؟
تنطبق بنود الخدمة الإضافية الخاصة بـ Gemini API على استخدام التطبيقات المعروضة في معرض التطبيقات في AI Studio، ما لم يُنص على خلاف ذلك.
الخطوات التالية
- تطوير التطبيقات كاملة المكدس
- يمكنك الاطّلاع على أمثلة في معرض التطبيقات.