ضبط إعدادات Gemini ضمن مساحات العمل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Gemini اختصارًا

لفتح محادثة بسرعة مع 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، انقر على التبديل إلى "الرمز" لفتح عرض Code.

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

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

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

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

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

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

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

• لتعديل الإعدادات في مساحة عمل Firebase Studio، اتّبِع الخطوات التالية:

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

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

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

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

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

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

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

يمنح Gemini الأولوية .idx/airules.md، ولكن سيستخدم GEMINI.md إذا لم يكن .idx/airules.md متوفّرًا.

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

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

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

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

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

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

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

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

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

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

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

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

   سيتم استخدام Gemini (حسب ترتيب الأولوية) .idx/airules.md أو GEMINI.md أو .gemini/styleguide.md أو AGENTS.md أو cursorrules.

مثال

في ما يلي مثال أساسي لملف قواعد يمكنك استخدامه مع لعبة عادية تم تطويرها باستخدام 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. يمكنك الاختيار من بين النموذج المضمّن أو النماذج التي تم ضبطها في نافذة المحادثة أو أي نموذج Gemini يمكنك الوصول إليه.

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

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

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

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

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

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

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

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

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

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

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

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

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

• جرِّب Gemini.