1- مقدمة
نظرة عامة
أين يبدأ تصميم المحتوى باستخدام الذكاء الاصطناعي اليوم؟ بالنسبة إلى معظمنا، يبدأ الأمر بطلب أو نموذج أوّلي بسيط. يوفّر Google AI Studio وضع التصميم الفعّال (يُشار إليه غالبًا باسم "الترميز السريع") الذي يتيح لك تصميم تطبيقات الويب الكاملة واختبارها وإنشاؤها باستخدام ميزة إنشاء الرموز البرمجية المستندة إلى نماذج Gemini.
في هذا الدرس التطبيقي حول الترميز، ستنشئ تطبيقًا تعاونيًا للمهام باستخدام قاعدة بيانات Firestore للتخزين المستمر ومصادقة Firebase لتسجيل دخول المستخدمين. سيضبط وكيل AI Studio جميع خدمات الخلفية ويكتب رمز التفاعل مع الواجهة الأمامية وقاعدة البيانات. بعد تحسين التطبيق، ستنشره مباشرةً على Cloud Run بنقرة واحدة.
الإجراءات التي ستنفذّها
- اطلب من Google AI Studio إنشاء نموذج أوّلي لتطبيق ويب تعاوني لقائمة المهام.
- اضبط عملية التكامل مع Firebase وفعِّلها لتوفير قاعدة بيانات Firestore وإعداد ميزة "تسجيل الدخول باستخدام حساب Google".
- اختبِر التطبيق في وضع الحماية التفاعلي للمعاينة.
- انشر التطبيق على Cloud Run مباشرةً من واجهة مستخدم Google AI Studio.
أهداف الدورة التعليمية
- كيفية استخدام وضع التصميم في Google AI Studio لإنشاء نموذج أوّلي بسرعة لخدمة كاملة باستخدام اللغة الطبيعية
- كيفية ضبط عمليات التكامل مع Firebase Firestore و"مصادقة Firebase" تلقائيًا في Google AI Studio
- كيفية نشر تطبيق AI Studio كحاوية بلا خادم على Cloud Run
- كيفية فحص سجلات قاعدة البيانات وحالة الأمان داخل "وحدة تحكّم Firebase"
2. إعداد المشروع
قبل تشغيل AI Studio، تحقَّق من حالة حسابك والمتطلبات الأساسية.
حساب Google ومعلومات الطبقة
- إذا لم يكن لديك حساب حاليًا، يمكنك إنشاء حساب على Google.
- ملاحظة: استخدِم حسابًا شخصيًا على Google في هذا المختبر إن أمكن. قد تفرض الحسابات الجماعية أو حسابات المؤسسات أو الحسابات التعليمية سياسات Workspace التي توقف الميزات التجريبية أو عمليات التكامل مع السحابة الإلكترونية.
- راجِع تفاصيل الفوترة لعمليات النشر:
- طبقة Google Cloud Starter: تتيح نشر ما يصل إلى تطبيقَين كاملَين في منطقة محدّدة بدون أي تكلفة، بدون إنشاء حساب فوترة كامل على Google Cloud.
- عملية النشر العادية: تتصل بمشروع حالي مدفوع على Google Cloud وتوسّع حدود التخزين وموارد وحدة المعالجة المركزية وواجهات برمجة التطبيقات.
3. إنشاء تطبيق للمهام في وضع التصميم في AI Studio
لننشئ هيكل التطبيق ونطلب من مساعد الذكاء الاصطناعي للرموز البرمجية إنشاء طبقتَي الأمان والمثابرة.
- انتقِل إلى لوحة التطبيقات في Google AI Studio وانقر على تطبيق جديد.
- في مربّع طلب المحادثة، أدخِل وصفًا لتطبيق المهام:
Build a collaborative to-do list application using Firebase as a backend. Users must be able to securely sign in using Google Sign-In, view their personal tasks, add new task items, toggle status as completed, and delete tasks. The database must isolate tasks so users can only view and modify their own records. - انقر على تصميم لبدء عملية إنشاء التطبيق.
عندما يدرك وكيل AI Studio الحاجة إلى مساحة تخزين في قاعدة البيانات وتسجيل دخول آمن للمستخدم، يبدأ تدفق الإعداد التلقائي لـ Firebase.
- بعد دقيقة واحدة تقريبًا، تظهر بطاقة تكامل تفعيل Firebase في مساحة العمل.
- انقر على الزر تفعيل Firebase للتأكيد وقبول بنود الخدمة.
- سينفّذ الوكيل عملية الإعداد في الخلفية. الخيارات المتقدمة:
- يتم توفير مثيل قاعدة بيانات Firestore.
- يتم تفعيل "مصادقة Firebase" مع تفعيل ميزة "تسجيل الدخول باستخدام حساب Google".
- يتم إعداد حساب خدمة (مثل إنشاء
src/lib/firebase.tsالذي يحتوي على بيانات اعتماد واجهة برمجة التطبيقات). - تتم إضافة
firestore.rulesالتي تحتوي على حدود الأمان التلقائية (قواعد عزل المستخدم).
4. الاختبار والتكرار
قبل تشغيل الخدمة، عليك إجراء عمليات التحقق من الصحة في المعاينة التفاعلية.
- افتح جزء المعاينة داخل Google AI Studio.
- انقر على الزر "تسجيل الدخول" لبدء عملية المصادقة في وضع الحماية باستخدام ميزة "تسجيل الدخول باستخدام حساب Google".
- ملاحظة حول إصلاح الأخطاء: أثناء الإنشاء أو الاختبار، قد تواجه أحيانًا مشاكل في وقت التشغيل أو أخطاء في التجميع أو حالات تعذّر الحصول على إذن Firestore بسبب عدم تطابق قواعد الأمان. في حال حدوث ذلك، يعرض AI Studio زر إصلاح في المحادثة، ما يتيح لك أن تطلب من الوكيل تشخيص المشكلة وإصلاحها تلقائيًا.

- بعد تسجيل الدخول، أضِف عدة مهام (مثل "مراجعة مستندات Cloud Run" و"إكمال الدرس التطبيقي حول الترميز").
- ضَع علامة على بعض المهام كمكتملة واحذف إحداها للتأكّد من أنّ معالِجات جانب العميل وحالات قاعدة البيانات يتم تعديلها بشكل صحيح.
- إذا أردت تغيير التصميم أو السلوك، اطلب من الوكيل ذلك من خلال نافذة المحادثة. مثلاً:
"Could you style the interface using Tailwind CSS, and add a dark mode toggle button?""Show a count of remaining incomplete tasks at the footer of the task list."
- انتظِر إلى أن يعدّل الوكيل قاعدة الرموز البرمجية واطّلِع على متصفّح المعاينة للاطّلاع على التعديلات.
5. النشر على Cloud Run
بعد أن يصبح النموذج الأوّلي جاهزًا، انشره كخدمة عامة على Cloud Run.
- في أعلى يسار Google AI Studio، انقر على الزر نشر لبدء معالج النشر.

- انقر على البدء لضبط مشروعك على Google Cloud.
- تأكَّد من أنّ القائمة المنسدلة مشروع Google Cloud المستهدَف تطابق المشروع الذي ربطته بمساحة عملك.
- سينشئ AI Studio تلقائيًا معرّف خدمة فريدًا لمثيل Cloud Run.
- إذا كانت هذه هي المرة الأولى التي تنشر فيها وكنت تستخدم مَعلمات Google Cloud العادية، قد يُطلب منك تحديد نوع مؤسسة وتقديم تفاصيل الفوترة.
- انقر على نشر التطبيق.
- تحدث خطوات إنشاء الحاوية وتسجيلها ونشر الخدمة في الخلفية. تكتمل هذه العملية عادةً خلال دقيقتَين إلى 4 دقائق.
- عند اكتمال عملية النشر، انسخ عنوان URL للتطبيق الذي تم إنشاؤه وانتقِل إلى رابط التطبيق المباشر في علامة تبويب المتصفّح.
- اختبِر تطبيق الويب المباشر في متصفّحك.
6. الفحص في "وحدة تحكّم Firebase"
ألقِ نظرة على الخيارات المتقدمة لمعرفة كيفية تتبُّع مخططات البيانات والمستخدمين.
- انتقِل إلى "وحدة تحكّم Firebase".
- اختَر مشروعك (الذي يحمل التصنيف
AI Studioأو معرّف مشروعك الذي ربطته يدويًا). - في لوحة التنقّل على يمين الصفحة، انقر على إنشاء > قاعدة بيانات Firestore:
- اطّلِع على مجموعات قاعدة البيانات والمستندات التي أنشأها تطبيقك.
- تأكَّد من أنّ كل مستند يحتوي على معرّف مالك يطابق بيانات اعتماد مصادقة المستخدم النشط.
- انقر على علامة التبويب الأمان في لوحة Firestore لمراجعة توجيهات الأمان التي تم إنشاؤها تلقائيًا والتي تحدّ من أذونات القراءة والكتابة لمالكي المستندات الذين تم التحقّق منهم.
- انتقِل إلى الأمان > المصادقة للاطّلاع على قائمة ببيانات اعتماد المستخدم النشط التي تم ملؤها أثناء اختبارات تسجيل الدخول.
7. تنظيف
لتجنُّب أي رسوم فوترة غير متوقّعة أو لتنظيف موارد مساحة عملك:
- في Google AI Studio، انتقِل إلى صفحة التطبيقات.
- ابحث عن تطبيقك في الشبكة أو القائمة.
- انقر على رمز المهملات لحذف حالة التطبيق وإلغاء نشر الخدمة من Cloud Run.
- إذا نشرت باستخدام مشروع عادي وأردت إيقاف جميع الموارد بالكامل، انتقِل إلى إعدادات المشروع في Google Cloud Console واحذف المشروع الأساسي.
8. الخاتمة
تهانينا! لقد صمّمت تطبيق ويب تعاونيًا كاملًا وطوّرته ونشرته مباشرةً من Google AI Studio.