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

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

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

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

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

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

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

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

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

Gemini

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

للاطّلاع على قائمة بجميع النماذج المتاحة، يُرجى الانتقال إلى Gemini نماذج.

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

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

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

  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 في أسفل مساحة العمل لإعادة تحميل قائمة النماذج.

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