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

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

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

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

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

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

ملاحظة مهمة: يوضّح هذا الدليل المحادثة التفاعلية التلقائية في "Gemini". يتم ضبط التطبيقات التي تم إنشاؤها باستخدام App Prototyping agent تلقائيًا على محادثة Prototyper في طريقة عرض Code. لاستخدام محادثة تفاعلية في Gemini بدلاً من ذلك، انقر على + ضمن Gemini، ثم اختَر محادثة جديدة. للعودة إلى محادثة "Prototyper"، انقر على المحادثات الأخيرة، ثم اختَر محادثة Prototyper. للحصول على معلومات حول محادثة Prototyper، يُرجى الاطّلاع على مقالة بدء استخدام App Prototyping agent.

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

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

ملاحظة مهمة: يمكن أن ينشئ Gemini مخرجات تبدو معقولة ولكنّها غير صحيحة من الناحية الواقعية. وقد يقدّم ردودًا تتضمّن معلومات غير دقيقة لا تمثّل وجهة نظر Google. يُرجى التحقّق من صحة جميع النتائج من Gemini قبل استخدامها، وعدم استخدام الرموز البرمجية التي تم إنشاؤها ولم يتم اختبارها في مرحلة الإنتاج. يُرجى عدم إدخال معلومات تكشف الهوية الشخصية أو بيانات المستخدمين في المحادثة.

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

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

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

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. لإيقاف ميزة "إكمال الرمز"، ألغِ تحديد الخيار تفعيل ميزة "إكمال الرمز" المضمّنة أثناء الكتابة.

ملاحظة: للاحتفاظ بهذا الإعداد في جميع مساحات العمل، يمكنك ضبط الإعداد في علامة التبويب المستخدم. يضمن ذلك تطبيق إعداداتك على كل مساحة عمل تصل إليها باستخدام حساب المستخدم الخاص بك. في حال مشاركة مساحة العمل، سيظل عليك ضبط إعدادات Workspace.

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

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

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

ملاحظة: يمكنك التحكّم في الملفات التي تتم فهرستها في Gemini. مزيد من المعلومات في مقالة استبعاد الملفات من Gemini باستخدام ملفات .aiexclude

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

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

• لتعديل الإعدادات في مساحة عمل "Firebase Studio":

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

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

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

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

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

ملاحظة: للاحتفاظ بهذا الإعداد في جميع مساحات العمل، يمكنك ضبط الإعداد في علامة التبويب المستخدم. يضمن ذلك تطبيق إعداداتك على كل مساحة عمل تصل إليها باستخدام حساب المستخدم الخاص بك. في حال مشاركة مساحة العمل، سيظل عليك ضبط إعدادات Workspace.

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

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

يعطي Chat في 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 على الملفات في الدليل الذي يحتوي عليه أو في الأدلة الفرعية.

ملاحظة: يتم تلقائيًا استبعاد الملفات التي تم تجاهلها بواسطة ملفات .gitignore في المستودع، حتى إذا لم تكن مدرَجة في ملف .aiexclude.

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

• المساعدة في المحادثة: لن يتمكّن "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.

ملاحظة مهمة: إعدادات الذكاء الاصطناعي في "Firebase Studio" هي إعدادات المستخدم. وهذا يعني أنّها ستبقى مخصّصة لك على عدة محطات عمل.

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

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

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

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

   ملاحظة: قد يكون هذا الحقل معبأً بالفعل إذا استخدمت App Prototyping agent وأنشأ مشروع Firebase ومفتاح Gemini API لك.

4. من القائمة المنسدلة IDX > AI: Model Provider، اختَر Gemini API.

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

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

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

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

3. انسخ اسم نموذج Gemini الذي اخترته في حقل IDX > AI: Gemini Model.

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

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

• جرِّب Gemini.