تجربة "Gemini في Firebase Studio"

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

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

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

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

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

بدء محادثة مع Gemini

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

بدء استخدام المحادثة

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

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

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

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

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

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

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

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

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

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

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

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

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

إكمال المهام المعقّدة باستخدام المحادثة

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

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

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

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

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

على سبيل المثال، /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، يمكنك الإشارة إلى ملفات ومجلدات معيّنة باستخدام الرمز @.

على سبيل المثال، Explain what's contained within the @src/ai directory.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

لمزيد من المعلومات حول الاقتباسات من الرموز البرمجية من Google، يُرجى الاطّلاع على ميزة "المساعدة في الرموز البرمجية" المستنِدة إلى الذكاء الاصطناعي التوليدي.

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

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

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

الحصول على اقتراحات للرموز من "Gemini"

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

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

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

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

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

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

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

عرض Gemini أمر مضمّن

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

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

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

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

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

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

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

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

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

     إذا كنت تستخدم App Prototyping agent في عرض Prototyper، انقر على التبديل إلى "الرمز" لفتح عرض Code.

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

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