ضبط Gemini في Firebase ضمن مساحات العمل

تسهّل Firebase Studio سير عمل التطوير من خلال ميزات الرموز البرمجية المستنِدة إلى الذكاء الاصطناعي التالية:

• اقتراحات لإكمال الرمز البرمجي أثناء الكتابة

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

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

• المساعدة في الرموز المضمّنة

يمكنك تخصيص طريقة مساعدة "Gemini في Firebase" لك من خلال تعديل إعداداته وإضافة ملفات قواعد الذكاء الاصطناعي:

• ضبط إعدادات إكمال الرمز
• ضبط إعدادات فهرسة قاعدة الرموز
• تخصيص التعليمات الخاصة بـ Gemini باستخدام ملف قواعد الذكاء الاصطناعي
• استبعاد الملفات من Gemini التي تحتوي على .aiexclude ملفات
• استخدام مفتاحك الخاص: استخدام نماذج Gemini أخرى في المحادثة
• تعديل طريقة اقتراح Gemini لتغييرات الرموز البرمجية أو تطبيقها

استخدام Gemini في Firebase في مساحة عملك

استخدِم Gemini في Firebase لتعزيز إنتاجيتك في كتابة الرموز البرمجية من خلال لوحة الدردشة أو نافذة الأوامر أو المساعدة في الرموز البرمجية المضمّنة.

1. استخدِم إما المحادثة أو المساعدة في كتابة الرمز البرمجي المضمّن في مساحة العمل:

   • لاستخدام المحادثة، انقر على شرارة Gemini في أسفل مساحة العمل المفتوحة.

   • لاستخدام Gemini CLI، افتح الوحدة الطرفية وأدخِل gemini لواجهة Gemini CLI، أو استخدِم الأمر gemini -p لاستخدام Gemini CLI في الوضع غير التفاعلي.

   • لاستخدام ميزة "المساعدة في كتابة الرمز المضمّن"، ابدأ بكتابة الرمز واضغط على Tab لقبول الاقتراحات.

2. يُرجى العِلم أنّ الخيارَين التاليَين مفعّلان تلقائيًا:

   • اقتراحات أثناء الكتابة، ما يوفّر إكمال الرمز البرمجي المضمّن
   • فهرسة قاعدة الرموز، ما يتيح تخصيصًا أفضل وردودًا أكثر فائدة

   لتغيير هذه الخيارات في إعدادات مساحة العمل في المستقبل، اتّبِع الخطوات التالية:

   • لتعديل إعدادات إكمال الرمز، راجِع مقالة تعديل إعدادات إكمال الرمز.
   • لتعديل إعدادات فهرسة الرموز البرمجية، اطّلِع على تعديل إعدادات فهرسة الرموز البرمجية.

   يمكنك أيضًا استبعاد ملفات وأدلة معيّنة من فهرسة الذكاء الاصطناعي. اطّلِع على استبعاد الملفات من Gemini باستخدام ملفات .aiexclude.

اختصارات Gemini في Firebase

لفتح محادثة بسرعة مع Gemini، اضغط على Ctrl+Shift+Space (أو Cmd+Shift+Space على جهاز MacOS).

لعرض أوامر Gemini من لوحة الأوامر:

1. افتح لوحة الأوامر بالضغط على Ctrl+Shift+P (أو Cmd+Shift+P على نظام التشغيل MacOS).

2. ابحث عن Gemini.

   تظهر قائمة بأوامر 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. انقر على علامة التبويب مساحة العمل، ثم ابحث عن الإعداد Firebase Studio > الذكاء الاصطناعي > تفعيل الإكمال المضمّن.

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

ضبط إعدادات فهرسة قاعدة الرموز

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

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

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

• إذا كنت تستخدم ملف settings.json، اضبط "IDX.aI.enableCodebaseIndexing" على 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. انقر على Firebase Studio > الذكاء الاصطناعي: تفعيل فهرسة قاعدة الرموز.

  4. لإيقاف فهرسة الرموز البرمجية، ألغِ اختيار الذكاء الاصطناعي: تفعيل فهرسة قاعدة الرموز البرمجية. عليك تعديل إعدادات فهرسة الرموز لكل مساحة عمل.

تخصيص التعليمات الخاصة بـ Gemini باستخدام ملف قواعد الذكاء الاصطناعي

يمكنك إضافة معلومات السياق وطلبات النظام من خلال إنشاء ملف قواعد الذكاء الاصطناعي:

• يستخدم Gemini CLI GEMINI.md فقط.
• يعطي Gemini في Firebase الأولوية .idx/airules.md، ولكن سيستخدم GEMINI.md إذا لم يكن .idx/airules.md متوفّرًا.

يستخدم Gemini في Firebase قواعدك كتعليمات وسياق للنظام، ويخصّص ردوده وفقًا لحالة الاستخدام.

استخدِم ملف قواعد الذكاء الاصطناعي لمشاركة الطلبات المخصّصة وأفضل الممارسات وحتى السياق المهم حول مشروعك مع Gemini لتحقيق أهداف مثل:

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

إنشاء ملف قواعد الذكاء الاصطناعي واختباره

لإنشاء ملف قواعد الذكاء الاصطناعي واختباره، اتّبِع الخطوات التالية:

1. أنشئ ملفًا جديدًا في ~/GEMINI.md (لـ Gemini CLI) أو .idx/airules.md (لـ "Gemini في Firebase") في مساحة عملك على Firebase Studio. يمكنك استخدام أحد الخيارات التالية:

   • من المستكشف (Ctrl+Shift+E)، انقر بزر الماوس الأيمن على الدليل الرئيسي واختَر ملف جديد. أدخِل اسمًا للملف واضغط على Enter.
   • من نافذة الوحدة الطرفية، استخدِم محرِّر النصوص المفضّل لديك لفتح GEMINI.md أو .idx/airules.md.

2. أضِف المحتوى إلى الملف. يمكنك إضافة معلومات حول الشخصية التي يجب أن تستخدمها Gemini (مثل "أنت مطوّر خبير ومساعد مفيد يعرف كل شيء عن Next.js")، ومعايير الترميز والمحادثة، وسياق حول المشروع. اطّلِع على المثال التالي لمعرفة مثال على ملف قواعد الذكاء الاصطناعي.

3. احفظ الملف وافتح Gemini CLI أو Gemini في Firebase.

4. لبدء استخدام قواعد الذكاء الاصطناعي، يمكنك اتّخاذ أحد الإجراءات التالية:

   • أعِد إنشاء مساحة العمل من خلال إعادة تحميل الصفحة. بعد إعادة الإنشاء، سيستخدم Gemini ملف القواعد داخل المحادثة. من المفترض أن تظهر التغييرات في ملف قواعد الذكاء الاصطناعي على الفور.
   • إذا كنت لا تريد إعادة إنشاء مساحة العمل، يمكنك أن تطلب من Gemini load GEMINI.md أو load airules.md. في حال إجراء تغييرات على الملف خلال الجلسة الحالية، قد تحتاج إلى إعادة طلب Gemini لتحميل ملف القواعد مرة أخرى.

5. طرح أسئلة حول الرمز البرمجي تستجيب Gemini باستخدام المعلومات التي أدرجتها في ملف القواعد كسياق.

مثال

في ما يلي مثال أساسي على ملف قواعد يمكنك استخدامه في لعبة عادية تم تطويرها باستخدام Next.js:

# Persona

You are an expert developer proficient in both front- and back-end development
with a deep understanding of Node.js, Next.js, React, and Tailwind CSS. You
create clear, concise, documented, and readable TypeScript code.

You are very experienced with Google Cloud and Firebase services and how
you might integrate them effectively.

# Coding-specific guidelines

- Prefer TypeScript and its conventions.
- Ensure code is accessible (for example, alt tags in HTML).
- You are an excellent troubleshooter. When analyzing errors, consider them
  thoroughly and in context of the code they affect.
- Do not add boilerplate or placeholder code. If valid code requires more
  information from the user, ask for it before proceeding.
- After adding dependencies, run `npm i` to install them.
- Enforce browser compatibility. Do not use frameworks/code that are not
  supported by the following browsers: Chrome, Safari, Firefox.
- When creating user documentation (README files, user guides), adhere to the
  Google developer documentation style guide
  (https://developers.google.com/style).

# Overall guidelines

- Assume that the user is a junior developer.
- Always think through problems step-by-step.

# Project context

- This product is a web-based strategy game with a marine life theme.
- Intended audience: casual game players between the ages of 17 and 100.

استبعاد الملفات من Gemini التي تحتوي على .aiexclude ملف

يمكنك التحكّم في الملفات التي يجب إخفاؤها في قاعدة الرموز البرمجية عن Gemini من خلال تضمين ملفات .aiexclude في مشروعك. يتيح لك ذلك التحكّم بدقة في سياق المشروع الذي تشاركه مع Gemini.

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

لن تتم فهرسة الملفات التي يغطيها .aiexclude من خلال Gemini عند تفعيل فهرسة قاعدة الرموز. بالإضافة إلى ذلك، سيؤثّر .aiexclude في المساعدة المضمّنة للملفات المشمولة بالطرق التالية:

• المساعدة في Chat: لن يتمكّن Gemini من الإجابة عن الأسئلة أو تقديم اقتراحات بشأن الملفات التي يشملها .aiexclude.
• إكمال الرمز: لن تتوفّر اقتراحات لإكمال الرمز عند تعديل الملفات التي تم تجاهلها.
• المساعدة المضمّنة: سيصبح بإمكانك إنشاء رموز برمجية جديدة، ولكن لن تتمكّن من تعديل الرموز البرمجية الحالية عند تعديل الملفات المشمولة.

قد تتوافق بيئات التطوير الأخرى، مثل استوديو Android، مع ملفات .aiexclude.

كيفية كتابة ملفات .aiexclude

يتبع ملف .aiexclude بنية الجملة نفسها التي يتبعها ملف .gitignore، مع الاختلافات التالية:

• يؤدي ملف .aiexclude فارغ إلى حظر جميع الملفات في الدليل وجميع المجلدات الفرعية. هذا هو نفسه ملف يحتوي على **/*.
• لا تتوافق ملفات .aiexclude مع النفي (إضافة البادئة ! إلى الأنماط).

أمثلة

في ما يلي بعض الأمثلة على إعدادات ملف .aiexclude:

• حظر جميع الملفات التي تحمل الاسم apikeys.txt في الدليل الذي يحتوي على الملف .aiexclude أو في أي دليل فرعي منه:

  apikeys.txt
  

• حظر جميع الملفات التي تحمل امتداد الملف .key في الدليل الذي يحتوي على الملف .aiexclude أو في أي دليل فرعي منه:

  *.key
  

• حظر الملف apikeys.txt فقط في الدليل نفسه الذي يتضمّن .aiexclude، وليس أي أدلة فرعية:

  /apikeys.txt
  

• حظر جميع الملفات في الدليل my/sensitive/dir وجميع الأدلة الفرعية يجب أن يكون المسار مرتبطًا بالدليل الذي يحتوي على الملف .aiexclude:

  my/sensitive/dir/
  

استخدام نماذج Gemini أخرى في المحادثة

يمكنك ضبط نموذج Gemini الذي يستخدمه Gemini في Firebase. يمكنك الاختيار من بين النموذج المضمّن أو النماذج التي تم ضبطها في نافذة المحادثة أو أي نموذج Gemini يمكنك الوصول إليه.

للحصول على قائمة بجميع الطُرز المتاحة، اطّلِع على Geminiالطُرز.

لضبط المفتاح واختيار نموذج Gemini مختلف، اتّبِع الخطوات التالية:

1. في مساحة العمل المفتوحة، انقر على spark Gemini في أسفل مساحة العمل (أو علامة التبويب Gemini).

2. من نافذة محادثة "Gemini في Firebase"، انقر على إعدادات الذكاء الاصطناعي. تظهر إعدادات المستخدم.

3. في الحقل IDX > الذكاء الاصطناعي: مفتاح واجهة برمجة التطبيقات Gemini، أدخِل Gemini API مفتاحك.

4. من القائمة المنسدلة IDX > الذكاء الاصطناعي: مقدّم النموذج، اختَر Gemini API.

يمكنك الآن اختيار أي من نماذج Gemini التي تم ضبطها مسبقًا في المحادثة.

لضبط إعدادات طراز Gemini غير مدرَج في القائمة المنسدلة، اتّبِع الخطوات التالية:

1. حدِّد طراز Gemini الذي تريد استخدامه في المحادثة من القائمة في طُرز Gemini. على سبيل المثال، يمكنك إدخال gemini-3-pro-preview لاستخدام Gemini 3 Pro نموذج المعاينة.

2. من نافذة المحادثة في Gemini في Firebase، انقر على أداة اختيار النموذج، ثم اختَر معرّف النموذج المخصّص. سيتم فتح إعدادات المستخدم.

3. انسخ اسم النموذج الذي اخترته في الحقل IDX > الذكاء الاصطناعي: نموذج Gemini.

4. أغلِق نافذة المحادثة، ثم أعِد فتحها من خلال النقر على شرارة Gemini في أسفل مساحة العمل لتحديث قائمة النماذج.

تخصيص Gemini CLI

• الإعدادات: يمكنك إنشاء ملف .gemini/settings.json لتغيير المظهر، وتفعيل ميزة جمع إحصاءات الاستخدام أو إيقافها، وتعديل الأدوات التي يمكن أن يصل إليها Gemini CLI، وضبط ميزة إنشاء نقاط التحقّق، وغير ذلك الكثير.
• الإعدادات: راجِع مستندات Gemini CLI للحصول على مزيد من المعلومات حول كيفية تعديل الإعدادات.
• متغيرات البيئة: يحمّل Gemini CLI تلقائيًا متغيرات البيئة من ملف .env. هذا هو المكان الذي يجب تخزين GEMINI_API_KEY فيه (إجراء مطلوب)، ويمكنك أيضًا تضمين Gemini النموذج الذي تريد استخدامه، وGoogle Cloud معرّف المشروع، وغير ذلك.
• التعليمات: لضبط السياق الذي يستخدمه Gemini CLI عند اتّباع التعليمات، أنشئ ملف GEMINI.md. يتيح لك ذلك تقديم تعليمات خاصة بالمشروع أو أدلة أسلوب الترميز أو معلومات أساسية ذات صلة إلى Gemini، ما يجعل ردوده أكثر تخصيصًا ودقة لتلبية احتياجاتك. يُرجى العِلم أنّ إنشاء هذا الملف سيقدّم التعليمات نفسها إلى Gemini في Firebase، ما لم تنشئ ملف .idx/airules.md أيضًا (في هذه الحالة، سيستخدم Gemini CLI GEMINI.md وسيستخدم Gemini في Firebase airules.md).

راجِع مستندات Gemini CLI للحصول على مزيد من المعلومات حول كيفية تعديل الإعدادات ومتغيرات البيئة والتعليمات.

الخطوات التالية

• جرِّب Gemini في Firebase.