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

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

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

• المحادثة مع Gemini.
• الحصول على مساعدة مضمّنة من Gemini.
• المحادثة مع Gemini باستخدام Gemini CLI.

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

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

المحادثة مع Gemini

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

بدء المحادثة

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

2. انقروا على رمز الشرارةGemini في أسفل مساحة العمل.

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

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

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

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

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

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

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

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

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

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

• تشغيل أوامر الوحدة الطرفية: 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. اختاروا رمز الشرارةGemini من القائمة، ثم اختاروا الإجراء الذي تريدون تنفيذه.

استخدام ميزة "الإكمال التلقائي للرموز البرمجية" المقترَحة من Gemini

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

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

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

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

• لتعديل الإعدادات في مساحة عمل Firebase Studio:

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

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

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

  3. لإيقاف ميزة "الإكمال التلقائي للرموز البرمجية"، أزيلوا العلامة من الخيار تفعيل ميزة "الإكمال التلقائي للرموز البرمجية" أثناء الكتابة.

المحادثة مع Gemini باستخدام Gemini CLI

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

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

للوصول إلى Gemini CLI في Firebase Studio:

1. التبديل إلى طريقة عرض الرمز: إذا كنتم تعملون في وضع Prototyper ، التبديل إلى طريقة عرض الرمز لفتح طريقة عرض Code.

2. الوصول إلى الوحدة الطرفية: افتحوا قائمة > الوحدة الطرفية > وحدة طرفية جديدة.

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

   gemini
   

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

5. المصادقة: اختاروا طريقة مصادقة. لتلقّي ترخيص مجاني Gemini Code Assist مع السماح بـ 60 طلبًا للنموذج في الدقيقة و1,000 طلب في اليوم بدون أي تكلفة، اختاروا تسجيل الدخول باستخدام Google. لمزيد من المعلومات عن المصادقة، راجِعوا المستندات.

في المستقبل، ما عليكم سوى إدخال 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 للحصول على قائمة كاملة بالأوامر.