تجربة "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. لإيقاف ميزة إكمال الرمز، عليك إلغاء تحديد الخيار تفعيل ميزة إكمال الرمز المضمَّن أثناء الكتابة.