تجربة Gemini في Firebase ضمن Firebase Studio

يقدّم "Gemini في Firebase" ضمن Firebase Studio مساعدة مستندة إلى الذكاء الاصطناعي لتبسيط عملية كتابة الرموز البرمجية، وذلك بشكل مضمّن في أداة تعديل الرموز البرمجية ومن خلال واجهة سطر الأوامر (CLI) وباستخدام الدردشة. يمكن أن يقدّم Gemini في Firebase اقتراحات بشأن الرموز البرمجية، وينشئ رموزًا برمجية، ويشرح مفاهيم الرموز البرمجية، ويعدّل ملفات المشاريع، وينفّذ أوامر المحطة الطرفية، ويفسّر نتائج الأوامر.

بدون الحاجة إلى إعداد أي شيء، يمكنك بدء استخدام Gemini في Firebase على الفور:

• الدردشة مع Gemini في Firebase
• الحصول على مساعدة مضمّنة باستخدام "Gemini في Firebase"
• الدردشة مع Gemini باستخدام Gemini CLI

يُرجى العِلم أنّ ميزة إكمال الرموز البرمجية المضمّنة وفهرسة قاعدة الرموز البرمجية تكونان مفعّلتَين تلقائيًا. كيفية تعديل إعداداتهم

تتوفّر ميزة "Gemini في Firebase" عندما تكون في وضع العرض Code. يمكنك استخدامها مع التطبيقات التي تبدأها في Firebase Studio والتطبيقات التي تستوردها إلى Firebase Studio والتطبيقات التي أنشأها App Prototyping agent.

الدردشة مع Gemini في Firebase

Firebase Studio يسهّل سير عمل التطوير من خلال محادثة مستندة إلى الذكاء الاصطناعي.

بدء محادثة

1. افتح مساحة عمل أو أنشئها في Firebase Studio.

2. انقر على sparkGemini في أسفل مساحة العمل.

3. ابدأ المحادثة مع Gemini.

4. (اختياري) أرسِل طلبًا متعدد الوسائط إلى Gemini من خلال النقر على إرفاق واختَر أحد الخيارات التالية:

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

5. (اختياري) غيِّر الوضع الذي يستخدمه Gemini للردّ على الطلبات:

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

6. (اختياري) أضِف مفتاح Gemini API الخاص بك واختَر نموذج Gemini مختلفًا. يمكنك الاطّلاع على مزيد من المعلومات في مقالة استخدام مفتاحك الخاص: استخدام نماذج Gemini أخرى في المحادثة.

7. (اختياري) يمكنك تخصيص طريقة مساعدة Gemini في Firebase لك من خلال تعديل إعداداته وإضافة ملفات قواعد الذكاء الاصطناعي. مزيد من المعلومات

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

• تعديل الملفات: يمكن Gemini إضافة ميزة أو إصلاح خطأ أو إعادة تصميم الرمز. عندما تقترح Gemini تغييرات على ملف، سيظهر لك خياران:

  • تعديل الملف: يمكنك تعديل الملف مباشرةً باستخدام التغييرات المقترَحة من Gemini.
  • مراجعة التغييرات: فتح التغييرات المقترَحة في نافذة أخرى لمراجعتها قبل تطبيقها

• تشغيل أوامر الوحدة الطرفية: يمكن Gemini تشغيل أوامر مثل تثبيت التبعيات أو بدء خادم تطوير. قد يقترح هذه الأوامر بنفسه، أو يمكنك أن تطلب من Gemini تنفيذها. بعد أن تقترح Gemini أمرًا، يظهر الزر تشغيل أمر الوحدة الطرفية. انقر عليه لتنفيذ الأمر في وحدة طرفية ضمن Firebase Studio. ستنفّذ Gemini الأمر وتفسّر النتائج لك في نافذة المحادثة، كما ستساعدك في تحديد الخطوات التالية.

إكمال المهام المعقّدة من خلال المحادثة

يمكن أن يساعدك Gemini في Firebase في إكمال مهام تطوير معقّدة، مثل:

• توثيق الرمز البرمجي: يمكن لـ Gemini إنشاء مستندات بالتنسيق المناسب للرمز البرمجي تلقائيًا عند الطلب منه "كتابة مستنداتي".
• كتابة حالات الاختبار: يمكن Gemini تعديل اختبارات الوحدات وإنشاؤها تلقائيًا. إذا طلبت من Gemini "كتابة اختباراتي"، سيبحث Gemini عن ملف اختبار وحدة حالي ويمكنه إضافة الاختبارات الناقصة إلى الملف. إذا لم يعثر على ملفات اختبارات الوحدات الحالية، سينشئ لك اختبار الوحدة لتتمكّن من مراجعته وتكراره وقبوله، ويمكنك حتى أن تطلب من Gemini تنفيذه.
• إدارة التبعيات: يمكنك أن تطلب من Gemini رصد التبعيات الناقصة في الرمز وحلّها مباشرةً من واجهة الدردشة.
• إعادة تصميم الرمز: يمكنك أن تطلب من Gemini إعادة تصميم الرمز نيابةً عنك، مثلاً، استخراج دالة أو إعادة تسمية متغيّر في ملفات متعددة. ستنشئ Gemini قائمة بالتغييرات المقترَحة، وبعد مراجعتها وتطبيقها، يمكنك أن تطلب من Gemini تعديل اختبارات الوحدات وتنفيذها للتحقّق من إعادة تصميم الرمز البرمجي والتأكّد من استمرار اجتياز الاختبارات.
• إنشاء عمليات سير عمل Docker وتنفيذها: إذا فعّلت Docker في مساحة العمل، يمكنك إنشاء حاوية لتطبيقك بسرعة من خلال الطلب من Gemini إنشاء Dockerfile (على سبيل المثال، "أنشئ Dockerfile لتطبيقي"). بعد أن تنشئ Gemini ملف Dockerfile، يمكنها إنشاء الحاوية وتشغيلها نيابةً عنك.
• إجراء اختبارات الوحدات واختبارات الدمج: يمكنك بدء تنفيذ الاختبار من خلال الطلب من Gemini إجراء مجموعات اختبارات معيّنة (على سبيل المثال، "إجراء اختبارات الوحدات" أو "إجراء اختبارات الدمج"). سينفّذ Gemini الأمر المناسب لمشروعك (على سبيل المثال، npm test أو أمرًا محدّدًا لتشغيل الاختبار) وسيعرض نتائج الاختبار ضمن واجهة المحادثة.

استخدام الأوامر التي تبدأ بشرطة مائلة في المحادثة

يمكنك توجيه Gemini في Firebase Chat بشأن الناتج الذي يقدّمه باستخدام أوامر الشرطة المائلة، وهي اختصارات تبدأ بشرطة مائلة للأمام (/). أدخِل / في بداية طلبك في Gemini Chat واختَر الإجراء الذي تريده من قائمة أوامر الشرطة المائلة المتاحة.

للاطّلاع على قائمة كاملة بالأوامر التي تبدأ بشرطة مائلة، اكتب / في المحادثة.

على سبيل المثال، /generate متبوعًا بوصف موجز لما تريد، هو اختصار طلب لإنشاء مقتطفات من الرمز البرمجي.

في ما يلي مثال على نتيجة تنفيذ /generate css for a black background:

body {
  background-color: black;
}

/* This CSS code sets the background color of the <body> element to black. This will make the background of the entire web page black. */

إدارة سجلّ المحادثات

يمكنك إبقاء المواضيع المختلفة منفصلة في محادثاتك مع Gemini في Firebase من خلال بدء سلاسل محادثات مختلفة. يمكنك بعد ذلك الرجوع إلى سلاسل المحادثات السابقة استنادًا إلى الموضوع.

لبدء محادثة جديدة، اتّبِع الخطوات التالية:

1. انقر على محادثة جديدة في شريط عناوين المحادثة.

2. أدخِل طلبك.

للانتقال إلى سلسلة محادثات أخرى، اتّبِع الخطوات التالية:

1. انقر على المحادثات الأخيرة في شريط عنوان المحادثة.

2. اختَر سلسلة المحادثات التي تريد الوصول إليها.

3. يمكنك مواصلة سلسلة المحادثات هذه أو الرجوع إلى المحادثات السابقة باستخدام Gemini.

لحذف سلسلة محادثات:

1. انقر على سلسلة المحادثات التي تريد حذفها من المحادثات الأخيرة في شريط عنوان المحادثة.

2. انقر على حذف المحادثة في شريط عنوان المحادثة. أكِّد أنّك تريد حذف سلسلة المحادثات من سجلّ المحادثات.

عرض اقتباسات الرمز في المحادثة

لمساعدتك في التحقّق من صحة اقتراحات الرموز البرمجية، يشارك Firebase Studio معلومات حول المصدر الأصلي والتراخيص المرتبطة به. يمكنك الاطّلاع على سجلّ كامل لاقتباسات الرموز البرمجية من نافذة المحادثة بالنقر على رمز "سجلّ الترخيص" في شريط رأس المحادثة.

لمزيد من المعلومات عن الاقتباسات من الرموز البرمجية من Google، يُرجى الاطّلاع على مقالة المساعدة في إنشاء الرموز البرمجية.

الحصول على مساعدة مضمّنة من Gemini في Firebase

Firebase Studio يعزّز إنتاجيتك من خلال اقتراحات الرموز البرمجية المستندة إلى الذكاء الاصطناعي من Gemini.

يُرجى العِلم أنّ ميزة إكمال الرمز مفعّلة تلقائيًا. كيفية تعديل إعداداته

الحصول على اقتراحات للرموز البرمجية من Gemini في Firebase

تنشئ Gemini كتل كاملة من الرموز البرمجية المحتملة ضمن السطر. لاستخدام ميزة Gemini "المساعدة في كتابة التعليمات البرمجية المضمّنة"، اتّبِع الخطوات التالية:

1. افتح مساحة عمل في Firebase Studio.

2. انتقِل إلى الملف أو سطر الرمز البرمجي الذي تريد الحصول على مساعدة بشأنه واضغط على Ctrl+I (Cmd+I على نظام التشغيل MacOS).

3. أدخِل وصفًا لما تريد، وستحصل على Gemini اقتراح. يمكنك أيضًا استخدام الإجراءات كاختصارات لتوجيه الاقتراحات. على سبيل المثال، أدخِل /fixError للحصول على مساعدة في إصلاح الأخطاء في الرمز المضمّن.

4. اختَر إجراء أيٍّ من الخيارات التالية:

   • للاحتفاظ بالرمز الذي تم إنشاؤه، انقر على قبول.
   • للصق الاقتراح في مكان آخر أو نقله إلى ملف جديد، انقر على الخيار المناسب من القائمة المنسدلة في الزر تجاهل.
   • لإنشاء اقتراح جديد، انقر على إعادة إنشاء.
   • لإزالة الاقتراح تمامًا، انقر على تجاهل.

5. (اختياري) يمكنك تخصيص طريقة مساعدة Gemini في Firebase لك من خلال تعديل إعداداته وإضافة ملفات قواعد الذكاء الاصطناعي. مزيد من المعلومات

عرض طلبات Gemini في Firebase بشكل مضمّن

1. لعرض أوامر Gemini مضمّنة لرمز معيّن، اختَر الرمز الذي تريد الحصول على مساعدة بشأنه وانقر عليه بزر الماوس الأيمن.

2. انقر على sparkGemini من القائمة، ثم اختَر الإجراء الذي تريد تنفيذه.

استخدام ميزة "اقتراحات إكمال الرمز" من Gemini

لمساعدتك في كتابة الرمز البرمجي، يوفّر Firebase Studio ميزة الإكمال التلقائي للرمز البرمجي المستنِد إلى الذكاء الاصطناعي، والتي تتوقّع الرمز البرمجي وتملأه تلقائيًا في أي ملف مفتوح بمجرد البدء في الكتابة.

يُرجى العِلم أنّ ميزة إكمال الرمز مفعّلة تلقائيًا.

لتفعيل ميزة "إكمال الرمز" أو إيقافها، اضبط إعدادات "إكمال الرمز" باستخدام إحدى الطريقتَين التاليتَين:

• إذا كنت تستخدم ملف settings.json، اضبط "IDX.aI.enableInlineCompletion" على true أو false.

• لتعديل الإعدادات في مساحة عمل Firebase Studio، اتّبِع الخطوات التالية:

  1. انقر على إدارة (في أسفل يمين مساحة العمل)، ثم اختَر الإعدادات، أو اضغط على Ctrl+, (Cmd+, على جهاز Mac).

     إذا كنت تستخدم App Prototyping agent في Prototyper view, click Switch to Code to open Code view.

  2. انقر على علامة التبويب Workspace، ثم ابحث عن الإعداد Firebase Studio > الذكاء الاصطناعي > تفعيل الإكمال المضمّن.

  3. لإيقاف ميزة إكمال الرمز، ألغِ تحديد الخيار تفعيل ميزة إكمال الرمز المضمَّن أثناء الكتابة.

الدردشة مع Gemini باستخدام Gemini CLI

‫Gemini CLI هو وكيل مفتوح المصدر مستند إلى الذكاء الاصطناعي، وهو يتيح لك الاستفادة من إمكانات نماذج Gemini من Google مباشرةً في نافذة الأوامر. يؤدي Gemini CLI مهام مشابهة لمهام "Gemini في Firebase"، ولكن قد تفضّل استخدام Gemini CLI إذا كنت مطوّرًا تقضي وقتًا طويلاً في نافذة الأوامر لتنفيذ مهام مثل إنشاء الرموز البرمجية أو تصحيح الأخطاء أو تنفيذ الأوامر أو إدارة ملفات المشاريع.

بدء استخدام Gemini CLI

للوصول إلى "Gemini CLI" في "Firebase Studio"، اتّبِع الخطوات التالية:

1. التبديل إلى "عرض الرمز": إذا كنت تعمل في Prototyper mode, Switch to Code to open Code view.

2. الوصول إلى نافذة Terminal: افتح قائمة > Terminal > New Terminal.

3. فتح Gemini CLI: في الوحدة الطرفية، أدخِل الأمر التالي:

   gemini
   

4. تخصيص: اختَر مظهرًا ملونًا باستخدام مفاتيح الأسهم على لوحة المفاتيح، ثم اضغط على Enter.

5. المصادقة: إذا طُلب منك ذلك، اختَر طريقة مصادقة. لمزيد من المعلومات حول المصادقة، يُرجى مراجعة المستندات.

في المستقبل، ما عليك سوى إدخال gemini في الوحدة الطرفية للوصول إلى Gemini CLI.

بدلاً من ذلك، يمكنك تشغيل Gemini CLI في الوضع غير التفاعلي، وهو مفيد في كتابة النصوص البرمجية وتنفيذ العمليات آليًا. في هذا الوضع، يتم الخروج من Gemini CLI تلقائيًا بعد تنفيذ الأمر الذي تدخله. لاستخدام هذا الوضع، استخدِم العلامة --prompt أو -p. على سبيل المثال:

gemini -p "Create a markdown file that explains my app's architecture"

استخدام الأوامر مع Gemini CLI

يمكنك الدردشة مع Gemini CLI لطرح أسئلة أو طلبات. يمكنك أن تسأل ما يلي:

• explain [file_name.js]: إذا صادفت رمزًا غير مألوف، استخدِم هذا الأمر لطلب شرح. ما عليك سوى استبدال [file_name.js] بالمسار ذي الصلة أو لصق الرمز مباشرةً في الطلب.
• refactor [code_snippet]: يمكنك تحسين بنية الرمز أو كفاءته من خلال الطلب من Gemini اقتراح تحسينات على إعادة البناء.
• debug "Error: Module not found: 'firebase-admin'": عند مواجهة أخطاء، يمكنك إرسال رسالة الخطأ إلى Gemini للحصول على معلومات وحلول محتملة.
• ‫summarize "Key features of Firebase Realtime Database": يمكن أن يقدّم Gemini بحثًا سريعًا وتلخيصًا موجزًا للمحتوى.

يتيح أيضًا العديد من الأوامر المضمّنة لمساعدتك في إدارة جلستك وتخصيص الواجهة والتحكّم في سلوكها، مثل:

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

راجِع مستندات Gemini CLI للاطّلاع على القائمة الكاملة للأوامر.