إعداد Gemini في Firebase ضمن مساحات العمل

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

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

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

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

• مساعدة بشأن الرموز البرمجية المضمّنة

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

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

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

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

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

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

   • لاستخدام ميزة المساعدة في الرموز المضمّنة: ابدأ بكتابة الرمز واضغط على 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 ميزة إكمال الرمز البرمجي المستندة إلى الذكاء الاصطناعي التي تتوقّع الرمز البرمجي وتملأه تلقائيًا في أي ملف مفتوح فور بدء typing.

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

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

• إذا كنت تستخدم ملفًا بتنسيق 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 > الذكاء الاصطناعي (AI) > تفعيل الميزة "إكمال الكلمات" في النص.

  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. اختَر علامة التبويب مساحة العمل، ثم ابحث عن الإعداد Firebase Studio > الذكاء الاصطناعي (AI) > تفعيل الميزة "إكمال الترجمة أثناء الكتابة".

  3. انقر على Firebase Studio > الذكاء الاصطناعي: تفعيل فهرسة قاعدة البيانات.

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

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

يمكنك إضافة معلومات السياق وطلبات النظام من خلال إنشاء ملف قواعد الذكاء الاصطناعي (.idx/airules.md). يستخدم Gemini في Firebase قواعدك كتعليمات النظام والسياق، ما يضمن تخصيص ردود Gemini لتلبية حالة الاستخدام.

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

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

تستخدم Gemini القواعد التي تضبطها في المحادثة.

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

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

1. أنشئ ملفًا جديدًا في .idx/airules.md في مساحة عمل Firebase Studio (في الدليل نفسه الذي يتضمّن ملف dev.nix). يمكنك استخدام أحد الخيارات التالية:

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

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

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

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

   • أعِد إنشاء مساحة العمل من خلال إعادة تحميل الصفحة. بعد إعادة الإنشاء، ستستخدم خدمة Gemini في Firebase ملف القواعد ضمن المحادثة. من المفترض أن تظهر التغييرات التي يتم إجراؤها على ملف قواعد الذكاء الاصطناعي في المحادثة على الفور.
   • إذا كنت لا تريد إعادة إنشاء مساحة العمل، يمكنك أن تطلب من العميل Gemini استخدام المحادثة مع العميل 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 في المساعدة المضمّنة للملفات المشمولة بالتأمين بالطرق التالية:

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

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

كيفية كتابة ملفات .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 chat. يمكنك اختيار النموذج المُدمَج أو نماذج تم ضبطها في نافذة المحادثة (بما في ذلك نماذج Gemini 2.5) أو أي نموذج Gemini يمكنك الوصول إليه.

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

لضبط مفتاحك واختيار طراز Gemini مختلف:

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

2. في نافذة المحادثة مع Gemini في Firebase، انقر على القائمة المنسدلة لاختيار اسم الطراز، ثم انقر على رابط مفتاح Gemini API. إعدادات المستخدم تظهر.

3. في الحقل IDX > AI: مفتاح Gemini Api، أدخِل مفتاح Gemini API.

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

لضبط طراز Gemini غير مُدرَج في القائمة المنسدلة:

1. حدِّد نموذج Gemini الذي تريد استخدامه في المحادثة من القائمة في نماذج Gemini. على سبيل المثال، يمكنك إدخال gemini-2.0-flash-lite ل استخدام أحدث طراز ثابت Gemini 2.0 Flash‑Lite.

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

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

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

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

• جرِّب Gemini في Firebase.