تجربة 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 باستخدام أوامر الشرطة المائلة، وهي اختصارات مسبوقة بشرطة مائلة للأمام (/). أدخِل / في بداية طلبك في محادثة 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 في Firebase، يمكنك الإشارة إلى ملفات ومجلدات معيّنة باستخدام الرمز @.

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

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

يمكنك فصل المواضيع المختلفة في محادثاتك مع 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 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 للاطّلاع على القائمة الكاملة للأوامر.