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

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

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

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

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

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

• إذا كنت تستخدم ملف 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 يفهرس الرمز. يؤدي فهرسة الرمز إلى توفير نتائج أكثر فائدة عند استخدام المساعدة المستندة إلى الذكاء الاصطناعي في المحادثات أو داخل السطر.

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

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

• إذا كنت تستخدم ملف 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 في Firebase" باستخدام ملف قواعد الذكاء الاصطناعي

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

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

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

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

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

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

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

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

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

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 في المساعدة المضمّنة للملفات المشمولة بالطرق التالية:

• المساعدة في 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 2.5) أو أي نموذج Gemini يمكنك الوصول إليه.

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

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

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

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

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

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

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

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

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

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

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

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

• جرِّب Gemini في Firebase.