الدردشة مع فريق Gemini Code Assist للأفراد

ملاحظة: إذا كنت تعمل في مؤسسة أو تريد الحصول على المزيد من المزايا على مستوى الفريق، ننصحك باستخدام Gemini Code Assist Standard أو Enterprise.

يوضّح هذا المستند كيف يمكنك استخدام Gemini Code Assist، وهي أداة تعاون مستندة إلى الذكاء الاصطناعي في بيئة التطوير المتكاملة (IDE)، لمساعدتك في تنفيذ ما يلي في VS Code أو IntelliJ وبيئات تطوير متكاملة أخرى متوافقة من JetBrains:

• تلقّي إرشادات لمساعدتك في حلّ المشاكل في الرموز البرمجية
• إنشاء رمز لمشروعك
• يمكنك إدارة سياق مشروعك من خلال تحديد الملفات والمجلدات.
• إنشاء أوامر وقواعد مخصّصة

هذا المستند مخصّص للمطوّرين من جميع مستويات المهارات. يفترض هذا الدليل أنّ لديك معرفة عملية ببرنامج VS Code أو IntelliJ وغيرهما من بيئات التطوير المتكاملة المتوافقة من JetBrains. يمكنك أيضًا استخدام Gemini في "استوديو Android".

ملاحظة: يكون سلوك إنشاء الرموز البرمجية وإكمالها وتحويلها غير حتمي عند استخدامها في الوقت نفسه مع مكوّنات إضافية أخرى تنفّذ الاختصارات نفسها و/أو تستخدم واجهة برمجة التطبيقات نفسها لمعالجة هذه الإجراءات.

قبل البدء

VS Code

1. إعداد Gemini Code Assist للأفراد أو Gemini Code Assist Standard أو Gemini Code Assist Enterprise إذا لم يسبق لك إجراء ذلك

2. قبل اختبار إمكانات Gemini Code Assist في ملف الرمز البرمجي، تأكَّد من أنّ لغة البرمجة في ملفك متوافقة. لمزيد من المعلومات حول لغات الترميز المتوافقة، يُرجى الاطّلاع على لغات الترميز المتوافقة.

3. إذا كنت تفضّل استخدام بيئة التطوير المتكاملة (IDE) من خلال خادم وكيل، يمكنك الاطّلاع على اتصالات الشبكة في Visual Studio Code.

IntelliJ

1. إعداد Gemini Code Assist للأفراد أو Gemini Code Assist Standard أو Gemini Code Assist Enterprise إذا لم يسبق لك إجراء ذلك

2. قبل اختبار إمكانات Gemini Code Assist في ملف الرمز البرمجي، تأكَّد من أنّ لغة البرمجة في ملفك متوافقة. لمزيد من المعلومات حول لغات الترميز المتوافقة، يُرجى الاطّلاع على لغات الترميز المتوافقة.

3. إذا كنت تفضّل استخدام بيئة التطوير المتكاملة (IDE) من خلال خادم وكيل، راجِع مقالة خادم وكيل HTTP.

استخدام محادثة Gemini Code Assist لشرح الرمز البرمجي

في هذا القسم، تطلب من Gemini Code Assist تقديم شرح للرمز البرمجي الحالي.

VS Code

للحصول على شرح للرمز، اتّبِع الخطوات التالية:

1. افتح ملف الرمز.

2. في شريط الأنشطة الخاص ببيئة التطوير المتكاملة (IDE)، انقر على spark Gemini Code Assist.

3. في لوحة Gemini Code Assist، أدخِل الطلب Explain this code to me وانقر على send إرسال.

   يستخدم Gemini Code Assist الرمز البرمجي في ملف الرمز البرمجي كمرجع لطلبك، ويردّ عليك بتفسير للرمز البرمجي.

   للإشارة إلى جزء معيّن من الرمز بدلاً من الرمز بأكمله في الملف، يمكنك اختيار الجزء في ملف الرمز ثم الطلب من Gemini Code Assist.

IntelliJ

للحصول على شرح للرمز، اتّبِع الخطوات التالية:

1. في بيئة التطوير المتكاملة، افتح ملف الرمز البرمجي.

2. في نافذة أداة Gemini Code Assist، أدخِل الطلب Explain this code to me وانقر على إرسال.

يستخدم Gemini Code Assist الرمز البرمجي في ملف الرمز البرمجي كمرجع لطلبك، ويردّ عليك بتفسير للرمز البرمجي.

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

عندما يقدّم لك Gemini Code Assist رمزًا برمجيًا في رده، يمكنك اختيار الخيارات التالية المدرَجة في نهاية الرد:

• الإدراج عند المؤشر: يدرج هذا الخيار الرمز الذي تم إنشاؤه في ملفك الحالي عند موضع المؤشر الحالي.

• الإدراج في ملف جديد: يفتح ملفًا جديدًا ويدرج الرمز البرمجي الذي تم إنشاؤه في الملف الجديد.

  

تتوفّر هذه الخيارات عندما تحدّد ميزة "مساعد الترميز" في Gemini اللغة المستخدَمة في جزء الرمز، وعندما تكون هذه اللغة متوافقة مع بيئة التطوير المتكاملة (IDE) الحالية.

عرض سجلّ طلبات البحث

إذا أردت إعادة استخدام طلباتك السابقة، يمكنك العثور عليها في سجلّ الطلبات في نافذة أداة Gemini Code Assist من خلال النقر على schedule عرض سجلّ الطلبات.

إنشاء محادثات متعدّدة

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

VS Code

1. لإضافة محادثة جديدة، انقر على إضافة محادثة جديدة وأدخِل طلبك في حقل النص. بعد إدخال الطلب، ينشئ Gemini Code Assist المحادثة الجديدة.
2. للوصول إلى محادثتك السابقة، انقر على السجلّ استئناف المحادثة السابقة. ستظهر قائمة بمحادثاتك. اختَر المحادثة التي تريد الاطّلاع عليها.
3. لحذف سلسلة محادثات، انقر على متابعة المحادثة السابقة، ثم انقر على حذف حذف بجانب المحادثة التي تريد حذفها.

IntelliJ

لا تتوفّر هذه الميزة حاليًا في Gemini Code Assist لـ IntelliJ وبيئات التطوير المتكاملة الأخرى المتوافقة من JetBrains.

مسح سجلّ الدردشات

يستخدم Gemini Code Assist سجلّ المحادثات للحصول على سياق إضافي عند الردّ على طلباتك. إذا لم يعُد سجلّ المحادثات ذا صلة بك، يمكنك محو سجلّ المحادثات.

إدارة المحادثة

يمكنك إدارة إعدادات الدردشة في Gemini Code Assist باتّباع الخطوات التالية:

ضبط الانتقال التلقائي للأعلى أو للأسفل

VS Code

بشكل تلقائي، يتنقّل Gemini Code Assist تلقائيًا بين محادثاتك. لإيقاف هذا السلوك، نفِّذ المهام التالية:

1. انتقِل إلى الإعدادات > الإضافات > Gemini Code Assist.

2. ابحث عن الإعداد التمرير التلقائي وأزِل العلامة من المربّع.

IntelliJ

هذه الميزة غير متاحة في Gemini Code Assist لـ IntelliJ وبيئات التطوير المتكاملة الأخرى من JetBrains.

إيقاف المحادثة الجارية

VS Code

يمكنك إيقاف الردّ على المحادثة الجارية من خلال الضغط على إيقاف إيقاف:

IntelliJ

يمكنك إيقاف الردّ على المحادثة الجارية من خلال الضغط على إيقاف إيقاف:

حذف أزواج الطلبات والردود

لحذف طلبك وردّ Gemini Code Assist على هذا الطلب، اتّبِع الخطوات التالية:

VS Code

هذه الميزة غير متاحة في Gemini Code Assist for VS Code.

IntelliJ

1. في جزء المحادثة، مرِّر المؤشر فوق الطلب الذي تريد إزالته.

2. انقر على حذف.

   

3. عندما يُطلب منك تأكيد ما إذا كنت تريد حذف زوج الطلب والاستجابة، انقر على حذف. بخلاف ذلك، انقر على إلغاء لإلغاء العملية.

   تتم إزالة طلبك وردّ Gemini Code Assist من سجلّ المحادثات.

ضبط جزء المعاينة

يكون الإعداد "جزء المعاينة" مفعّلاً تلقائيًا في محادثة Gemini Code Assist. عند تفعيل هذا الإعداد، ستعرض معاينة كتلة الرمز البرمجي في محادثة Gemini Code Assist أول 6 أسطر من الرمز البرمجي. يمكنك توسيع مجموعات الرموز وتصغيرها.

لتغيير الإعداد التلقائي، يُرجى تنفيذ المهام التالية:

VS Code

1. في بيئة التطوير المتكاملة (IDE)، انتقِل إلى الإعدادات > الإضافات > Gemini Code Assist.

2. ابحث عن إعداد عرض مجموعة الرموز التلقائي.

3. اختر أحد الخيارات التالية:

   • موسّع: يتم تلقائيًا توسيع جميع مجموعات الرموز في ردود Gemini Code Assist على المحادثات.

   • المعاينة: تعرض الأسطر الستة الأولى فقط من الرمز في مجموعة الرموز. عليك توسيع مجموعة الرموز في ردّ Gemini Code Assist ضمن المحادثة للاطّلاع على بقية الرمز. وهذا هو الإعداد الافتراضي.

   • تصغير: يتم تلقائيًا تصغير جميع مجموعات الرموز في ردود المحادثة في Gemini Code Assist.

   عند إعادة تحميل بيئة التطوير المتكاملة، سيتم تطبيق الإعداد الجديد.

IntelliJ

هذه الميزة غير متاحة في Gemini Code Assist for IntelliJ وبيئات التطوير المتكاملة الأخرى من JetBrains.

إرسال طلب إلى Gemini Code Assist باستخدام الرمز البرمجي المحدّد من خلال المحادثة

يمكن لـ "مساعد الترميز من Gemini" تنفيذ المهام أو الإجابة عن أسئلتك استنادًا إلى الرمز الذي تحدّده. للحصول على رمز برمجي تم إنشاؤه استنادًا إلى طلب يتضمّن رمزًا برمجيًا محدّدًا، اتّبِع الخطوات التالية:

VS Code

1. في شريط الأنشطة، انقر على spark Gemini Code Assist لفتح لوحة Gemini Code Assist.

2. في ملف الرمز، اختَر مجموعة من الرموز.

3. في حقل النص في لوحة Gemini Code Assist، أدخِل طلبًا للرمز المحدّد.

   على سبيل المثال، اختَر دالة في الرمز وأدخِل الطلب Write a unit test for this function.

   يستخدم Gemini الرمز الذي اخترته كمرجع ويردّ على طلبك.

IntelliJ

1. في شريط الأنشطة، انقر على spark Gemini Code Assist لفتح نافذة أداة Gemini Code Assist.

2. في ملف الرمز، اختَر مجموعة من الرموز.

3. في حقل النص ضمن نافذة أداة Gemini Code Assist، أدخِل طلبًا للرمز المحدّد.

   على سبيل المثال، اختَر دالة في الرمز وأدخِل الطلب Write a unit test for this function.

   يستخدم Gemini Code Assist الرمز الذي اخترته كمرجع ويستجيب لطلبك.

إضافة مقتطفات الرمز المحدّدة إلى السياق

يمكنك اختيار مقتطفات من الرموز البرمجية وإرفاقها وتوجيه Gemini Code Assist للتركيز عليها. يتيح اختيار مقتطفات من الرمز البرمجي إجراء تحليل منفصل لمقاطع أصغر من الرمز البرمجي بدلاً من الملفات بأكملها.

عند اختيار مقتطف رمز في ملف الرمز، يمكنك توجيه Gemini Code Assist لإضافة مقتطف الرمز إلى لوحة السياق.

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

في هذا القسم، يمكنك إضافة مقتطف رمز محدّد إلى السياق والحصول على شرح حول مقتطف الرمز من Gemini Code Assist:

VS Code

1. في ملف الرمز، اختَر مقتطف رمز.

2. في حقل نص "الدردشة" في Gemini Code Assist، انقر على إضافة إلى سياق الدردشة.

   يضيف Gemini Code Assist مقتطف الرمز المحدّد إلى "لوحة السياق".

3. في حقل نص Gemini Code Assist Chat، أدخِل الطلب what does this code do?.

   يردّ Gemini Code Assist على طلبك استنادًا إلى مقتطف الرمز الذي اخترته في "لوحة السياق".

IntelliJ

هذه الميزة غير متاحة في Gemini Code Assist لـ IntelliJ وبيئات التطوير المتكاملة الأخرى من JetBrains.

إرسال طلب إلى Gemini Code Assist باستخدام ناتج الوحدة الطرفية المحدّد من خلال المحادثة

يمكن لـ "مساعد Gemini للرموز البرمجية" تنفيذ مهام أو الإجابة عن أسئلتك استنادًا إلى ناتج الوحدة الطرفية المحدّد. للحصول على شرح لناتج معيّن من نافذة الأوامر، اتّبِع الخطوات التالية:

VS Code

1. في بيئة التطوير المتكاملة (IDE)، افتح المحطة الطرفية (عرض > المحطة الطرفية).

2. اختَر أي ناتج من الوحدة الطرفية.

3. انقر بزر الماوس الأيمن على ناتج الوحدة الطرفية المحدّد، ثم انقر على Gemini Code Assist: إضافة إلى سياق المحادثة.

   يضيف Gemini Code Assist ناتج وحدة التحكّم إلى "لوحة السياق".

4. في حقل نص Gemini Code Assist Chat، أدخِل الطلب what does this do?.

   يستجيب Gemini Code Assist لطلبك استنادًا إلى ناتج الوحدة الطرفية الذي اخترته في "لوحة السياق".

IntelliJ

هذه الميزة غير متاحة في Gemini Code Assist لـ IntelliJ وبيئات التطوير المتكاملة الأخرى من JetBrains.

تحديد الملفات والمجلدات في سياق مساحة العمل

يمكنك تحديد ملفات أو مجلدات في مساحة عملك ليستخدمها Gemini Code Assist كسياق. عند تحديد مجلد، يستخدم Gemini Code Assist الملفات الموجودة في المجلد بالإضافة إلى الملفات الموجودة في المجلدات الفرعية كسياق.

ملاحظة: عند تضمين مجلد، يختار Gemini Code Assist ما يصل إلى أول 100 ملف يعثر عليه داخل المجلد ومجلداته الفرعية. إذا كنت بحاجة إلى أن يكون النموذج على دراية بقاعدة الرموز البرمجية بما يتجاوز هذا الحدّ، يمكنك الاستفادة من تخصيص الرموز البرمجية.

VS Code

لتحديد ملفات أو مجلدات في طلب الدردشة، اكتب @ واختَر الملف أو المجلد الذي تريد تحديده.

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

1. في شريط الأنشطة، انقر على spark Gemini Code Assist.

2. في جزء Gemini Code Assist، أدخِل الطلب Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 واضغط على Enter (في نظامَي التشغيل Windows وLinux) أو Return (في نظام التشغيل macOS) أو Tab. يمكنك أيضًا النقر على اسم الملف في القائمة لاختياره. يؤدي النقر على اسم الملف إلى إضافة الملف إلى سياق طلبك وفتحه في بيئة التطوير المتكاملة (IDE).

يستجيب Gemini Code Assist لطلبك أثناء استخدام الملفَين اللذين حدّدتهما كسياق. يتضمّن Gemini Code Assist أيضًا الملفات التي حدّدتها في مصادر السياق.

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

على سبيل المثال: في جزء Gemini Code Assist، أدخِل الطلب How can I improve YOUR_FILE_NAME_1? (بدون الرمز @) واضغط على Enter (في Windows وLinux) أو Return (في macOS).

سيردّ Gemini Code Assist على استفسارك حول الملف الذي حدّدته في طلبك.

ملاحظة: إذا محوت سجلّ المحادثات، لن يستخدم Gemini Code Assist ملفاتك بعد ذلك للحصول على السياق، وعليك إعادة تحديد الملفات في لوحة المحادثة باستخدام الرمز @ إذا أردت طرح المزيد من الاستفسارات حول الملفات.

IntelliJ

لتحديد ملفات أو مجلدات في طلب المحادثة، اكتب @ واختَر الملفات أو المجلدات التي تريد تحديدها.

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

1. في شريط الأنشطة، انقر على spark Gemini Code Assist.

2. في جزء Gemini Code Assist، أدخِل الطلب Explain the difference between @YOUR_FILE_NAME_1 and @YOUR_FILE_NAME_2 واضغط على Enter (في نظامَي التشغيل Windows وLinux) أو Return (في نظام التشغيل macOS) أو Tab. يمكنك أيضًا النقر على اسم الملف في القائمة لاختياره. يؤدي النقر على اسم الملف إلى إضافة الملف إلى سياق طلبك وفتحه في بيئة التطوير المتكاملة (IDE).

يستجيب Gemini Code Assist لطلبك أثناء استخدام الملفَين اللذين حدّدتهما كسياق. يتضمّن Gemini Code Assist أيضًا الملفات التي حدّدتها في مصادر السياق.

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

على سبيل المثال: في جزء Gemini Code Assist، أدخِل الطلب How can I improve YOUR_FILE_NAME_1? (بدون الرمز @) واضغط على Enter (في Windows وLinux) أو Return (في macOS).

سيردّ Gemini Code Assist على استفسارك حول الملف الذي حدّدته في طلبك.

ملاحظة: إذا محوت سجلّ المحادثات، لن يستخدم Gemini Code Assist ملفاتك بعد ذلك للحصول على السياق، وعليك إعادة تحديد الملفات أو المجلدات في لوحة المحادثة باستخدام الرمز @ إذا أردت طرح المزيد من الاستفسارات حول الملفات.

إدارة الملفات والمجلدات في "الدرج السياقي"

بعد تحديد ملف أو مجلد لاستخدامه كسياق لطلباتك في Gemini Code Assist، يتم وضع هذه الملفات والمجلدات في درج السياق، حيث يمكنك عرضها وإزالتها من سياق الطلب.

لإدارة الملفات والمجلدات في "درج السياق"، نفِّذ المهام التالية:

VS Code

ملاحظة: لن تحتفظ المحادثات التي تم إنشاؤها باستخدام Gemini Code Assist for VS Code قبل الإصدار 2.34.0 بالسياق المحفوظ ولن تعرضه في "لوحة السياق". وقد يؤدي ذلك إلى حدوث مشاكل في عرض السياق الصحيح في المحادثة. لإنشاء سياق المحادثات والاحتفاظ به، ننصحك بمحو المحادثات قبل استخدام هذا الإصدار.

1. في شريط الأنشطة الخاص ببيئة التطوير المتكاملة (IDE)، انقر على spark Gemini Code Assist.

2. لعرض الملفات والمجلدات في "درج السياق"، انقر على عناصر السياق.

   

3. لإزالة عناصر من "اللوحة الجانبية"، انقر على close إزالة.

IntelliJ

1. في شريط الأنشطة، انقر على spark Gemini Code Assist.

2. لعرض الملفات والمجلدات في "درج السياق"، انقر على السياق.

   

3. لإزالة ملفات ومجلدات من "الدرج السياقي"، انقر على close إزالة.

استبعاد الملفات من السياق المحلي

تستبعد ميزة "مساعد الترميز" من Gemini تلقائيًا الملفات من الاستخدام المحلي في سياق إكمال الرمز البرمجي وإنشائه وتحويله والمحادثة إذا تم تحديد الملفات في ملف .aiexclude أو .gitignore.

لمعرفة كيفية استبعاد الملفات من الاستخدام المحلي، اطّلِع على استبعاد الملفات من استخدام Gemini Code Assist.

الرجوع إلى نقطة حفظ في المحادثة

بعد تطبيق التغييرات التي ينشئها Gemini Code Assist استنادًا إلى طلبك، يمكنك اختيار إعادة ملفات الرمز المعدَّل إلى نقطة حفظ معيّنة، ما يؤدي إلى إعادة جميع التغييرات التي تم تطبيقها على ملفات الرمز.

عند الرجوع إلى نقطة حفظ، لا يتم الرجوع إلى التغييرات اليدوية التي أجريتها على ملفات الرمز.

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

VS Code

في لوحة محادثة Gemini Code Assist، انقر على الرجوع إلى نقطة التحقّق. يؤدي هذا الإجراء إلى إعادة ملف الرمز إلى حالة نقطة التحقّق قبل إجراء التعديلات.

IntelliJ

هذه الميزة غير متاحة في Gemini Code Assist for IntelliJ وبيئات التطوير المتكاملة الأخرى من JetBrains.

عرض اختلافات الرموز

معاينة

هذا المنتج أو الميزة في مرحلة تجريبية. تتوفّر المنتجات والميزات التي هي في مرحلة المعاينة "كما هي".

يقترح Gemini Code Assist بشكل تلقائي تغييرات على الرمز البرمجي باستخدام مقارنة بين الرموز. يمكنك تشغيل هذا الاختلاف في أي وقت تطلب فيه من Gemini Code Assist إجراء تغييرات على الرمز البرمجي.

في هذا القسم، يمكنك الطلب من Gemini Code Assist تحسين ملف الرمز البرمجي، وعرض الفرق في ملف الرمز البرمجي، وقبول التغييرات أو رفضها حسب ما تفضّله.

VS Code

1. بعد فتح ملف الرمز البرمجي، اطلب من Gemini Code Assist optimize this file. إذا أردت تحسين عدة ملفات ومجلدات، اطلب من Gemini Code Assist optimize @FILE1 and @FILE2.

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

2. في ملف الرمز، انقر على check_small قبول أو close_small رفض.

   

3. إذا اقترح Gemini Code Assist تغييرات متعددة في ملفات الرموز البرمجية، انقر على عرض فوق الاقتراح، ثم انقر على التالي أو السابق للتنقّل بين الاقتراحات الأخرى.

4. إذا كنت تريد قبول كل التغييرات المقترَحة أو رفضها، انقر على قبول الملف أو رفض الملف.

   

5. يمكنك أيضًا استخدام "المعاينة السريعة" في رد الطلب لقبول أو رفض جميع الاقتراحات في ملفات رموز متعددة.

   

IntelliJ

1. بعد فتح ملف الرمز البرمجي، اطلب من Gemini Code Assist optimize this file. إذا أردت تحسين عدة ملفات ومجلدات، اطلب من Gemini Code Assist optimize @FILE1 and @FILE2.

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

2. في ردّ المحادثة، انقر على check_smallقبول التغييرات.

   

تغيير إعدادات عرض الاختلافات

VS Code

يمكنك تغيير هذا الإعداد لعرض نافذة منفصلة لعرض الاختلافات في بيئة التطوير المتكاملة (IDE) باتّباع الخطوات التالية:

1. في شريط الأنشطة، انتقِل إلى الإعدادات الإعدادات > الإعدادات.

2. في علامة التبويب المستخدم ضمن الإعدادات، انتقِل إلى الإضافات > Gemini Code Assist.

3. انتقِل إلى الإعداد Geminicodeassist > Chat: Change View.

4. في القائمة المنسدلة، حدِّد أحد الخيارات التالية:

   • الاقتراحات المضمّنة (مفعّلة تلقائيًا): تغييرات الرموز البرمجية المعروضة في ملف الرمز البرمجي
   • عرض الاختلافات التلقائي: يفتح ملفًا جديدًا يتضمّن تغييرات الرمز جنبًا إلى جنب.

IntelliJ

لا تتوفّر هذه الميزة حاليًا في Gemini Code Assist لـ IntelliJ وبيئات التطوير المتكاملة الأخرى المتوافقة من JetBrains.

إنشاء طلبات مخصّصة

يوفّر Gemini Code Assist تلقائيًا أوامر مثل /generate لـ VS Code وإنشاء الرمز لـ IntelliJ و غيرها من بيئات تطوير JetBrains المتكاملة المتوافقة. يمكنك أيضًا إنشاء أوامر مخصّصة لمساعدتك في إنجاز المهام المتكرّرة بشكل أسرع في بيئة التطوير المتكاملة.

في هذا القسم، ستنشئ أمرًا مخصّصًا باسم add-comments يضيف تعليقات إلى الرمز في ملف الرمز. في IntelliJ وبيئات تطوير JetBrains المتكاملة الأخرى المتوافقة، يمكنك إنشاء الأمر المخصّص وحفظه وتنفيذه من "مكتبة الطلبات" ومن الطلب داخل المحرّر.

VS Code

1. في ملف الرمز البرمجي، اضغط على Control+I (في نظامَي التشغيل Windows وLinux) أو Command+I (في نظام التشغيل macOS) لفتح قائمة الاختيار السريع في Gemini Code Assist.

2. في القائمة، ابحث عن الإعدادات المفضّلة: فتح الإعدادات (واجهة المستخدم) واختَرها.

3. في حقل إعدادات البحث، أدخِل Geminicodeassist: Custom Commands.

4. في مربّع الأوامر المخصّصة، انقر على إضافة عنصر.

5. في الحقل العنصر، أدخِل add-comments كاسم للأمر.

6. في حقل القيمة، أدخِل add comments to all functions without comments in my code كطلب.

7. انقر على موافق.

يمكنك الآن استخدام الأمر المخصّص add-comments في بيئة التطوير المتكاملة (IDE). يظهر الأمر في قائمة الأوامر ضمن قائمة Quick Pick في Gemini Code Assist (Control+I لنظامَي التشغيل Windows وLinux أو Command+I لنظام التشغيل macOS).

IntelliJ

1. في بيئة التطوير المتكاملة (IDE)، انتقِل إلى الإعدادات > الأدوات > Gemini > مكتبة الطلبات.

   

2. في نافذة مكتبة الطلبات، انقر على add إضافة.

3. أدخِل اسمًا للأمر المخصّص add-comments.

4. في مربّع النص ضمن "مكتبة الطلبات"، أدخِل الطلب: Add comments to all functions without comments in this code.

5. ضَع علامة في مربّع الاختيار العرض في الطلب داخل المحرّر إذا لم يكن محدّدًا.

6. انقر على حسنًا لحفظ الأمر المخصّص في "مكتبة الطلبات".

7. في ملف الرمز، ميِّز الرمز الذي تريد تعديله.

8. انقر بزر الماوس الأيمن على الرمز المميّز وانتقِل إلى Gemini > مكتبة الطلبات، ثم اختَر الأمر المخصّص add-comments.

   ينفّذ Gemini Code Assist الأمر add-comments ويضيف تعليقات إلى الرمز المحدّد.

يمكنك أيضًا استدعاء الأمر المخصّص باستخدام الطلب داخل المحرّر من خلال تنفيذ المهام التالية:

1. في ملف التعليمات البرمجية، حدِّد التعليمات البرمجية التي تريد تعديلها، ثم اضغط على Alt+\ (في نظامَي التشغيل Windows وLinux) أو Cmd+\ (في نظام التشغيل macOS) لفتح قائمة الوصول السريع إلى Gemini Code Assist.

2. في القائمة، اختَر الأمر المخصّص add-comments.

   ينفّذ Gemini Code Assist الأمر add-comments ويضيف تعليقات إلى الرمز المحدّد.

إنشاء قواعد

يمكنك إنشاء قواعد ليتّبعها Gemini Code Assist، ويتم تضمين هذه القواعد في كل طلب محادثة تدخله.

تتيح لك القواعد في Gemini تحديد إعداداتك المفضّلة، مثل:

• نمط الترميز
• تنسيقات الإخراج
• حزمة التكنولوجيا
• اللغة

على سبيل المثال، يمكنك إنشاء قاعدة مثل "قدِّم لي دائمًا ردودًا موجزة بلغة Kotlin".

VS Code

1. في ملف الرمز البرمجي، اضغط على Control+I (في نظامَي التشغيل Windows وLinux) أو Command+I (في نظام التشغيل macOS) لفتح قائمة الاختيار السريع في Gemini Code Assist.

2. في القائمة، ابحث عن الإعدادات المفضّلة: فتح الإعدادات (واجهة المستخدم) واختَرها.

3. في حقل إعدادات البحث، أدخِل Geminicodeassist: Rules.

4. في حقل النص، أدخِل قاعدة مثل: Always generate unit tests when creating a new function. يمكنك أيضًا إضافة قاعدة واحدة أو أكثر تتضمّن أسطرًا متعددة في حقل النص.

   بعد إضافة قواعد في إعدادات "القواعد"، يأخذ Gemini Code Assist القاعدة في الاعتبار لكل طلب أو استفسار ترسله.

   لإزالة القاعدة، احذف المحتوى من حقل النص "القواعد".

IntelliJ

ملاحظة: لا يتم استخدام القواعد في وضع "الوكيل".

1. لإنشاء قاعدة، انتقِل إلى الإعدادات > الأدوات > Gemini > مكتبة الطلبات > القواعد، ثم عدِّل النص في المحرّر.

2. لضبط نطاق القاعدة، اختَر IDE أو المشروع من القائمة المنسدلة النطاق.

   • قواعد IDE خاصة بك ويمكن استخدامها في مشاريع متعددة.
   • يمكن مشاركة القواعد على مستوى المشروع بين أعضاء الفريق الذين يعملون على المشروع نفسه.

   لمشاركة الطلبات مع الفريق، يجب إضافة مجلد .idea إلى نظام التحكّم بالإصدارات.

المشاكل المعروفة

يوضّح هذا القسم المشاكل المعروفة في Gemini Code Assist:

VS Code

• قد يتم اقتطاع ردود Chat عندما تتضمّن نسخة معدَّلة من ملف كبير مفتوح

  لحلّ هذه المشكلة، حدِّد جزءًا أصغر من الرمز وأدرِج توجيهًا إضافيًا في طلب الدردشة، مثل only output the selected code.

• Vim: لا يمكن قبول اقتراحات إنشاء الرموز البرمجية أو رفضها إلا في وضع الإدراج

  عند استخدام مكوّن Vim الإضافي في الوضع العادي، لا يمكنك قبول اقتراحات الرموز أو رفضها.

  لحلّ هذه المشكلة، اضغط على i للدخول إلى وضع الإدراج، ثم اضغط على Tab لقبول الاقتراح.

• Vim: سلوك غير متسق عند الضغط على Esc لإغلاق الاقتراحات

  عند الضغط على Esc، يتم إغلاق كل من بيئة التطوير المتكاملة واقتراحات Gemini Code Assist. يختلف هذا السلوك عن السلوك غير المتوافق مع Vim، حيث يؤدي الضغط على Esc إلى إعادة تشغيل Gemini Code Assist.

• تستمر محاولات تسجيل الدخول في تجاوز الوقت المحدّد

  إذا استمرّت محاولات تسجيل الدخول في الانتهاء قبل الوقت المحدّد، حاوِل إضافة إعداد cloudcode.beta.forceOobLogin إلى ملف settings.json:

   "cloudcode.beta.forceOobLogin": true
  

• لا تظهر التحذيرات بشأن تلاوة الترخيص في الجلسات اللاحقة

  إذا لم تكن تحذيرات تلاوة الترخيص مستمرة في جميع الجلسات، يُرجى الرجوع إلى السجلّات الدائمة:

  1. انقر على عرض > الإخراج.

  2. انقر على Gemini Code Assist - الاقتباسات.

• مشاكل في الاتصال في نافذة إخراج Gemini Code Assist

  إذا ظهر لك خطأ في الاتصال أو مشاكل أخرى متعلّقة بالاتصال في نافذة إخراج Gemini Code Assist، جرِّب ما يلي:

  • اضبط جدار الحماية للسماح بالوصول إلى oauth2.googleapis.com وcloudaicompanion.googleapis.com.

  • اضبط جدار الحماية للسماح بالاتصال عبر HTTP/2 الذي يستخدمه gRPC.

  يمكنك استخدام أداة grpc-health-probe لاختبار الاتصال. يؤدي إجراء عملية تحقّق ناجحة إلى ظهور الناتج التالي:

  $ grpc-health-probe -addr cloudaicompanion.googleapis.com:443 -tls error: this server does not implement the grpc health protocol (grpc.health.v1.Health): GRPC target method can't be resolved

  يؤدي إجراء عملية تحقّق غير ناجحة إلى ظهور النتيجة التالية:

  timeout: failed to connect service "cloudaicompanion.googleapis.com:443" within 1s

  للحصول على مزيد من التفاصيل، نفِّذ ما يلي قبل grpc-health-probe:

  export GRPC_GO_LOG_SEVERITY_LEVEL=info
  

IntelliJ

لا توجد مشاكل معروفة في Gemini Code Assist for IntelliJ وبيئات التطوير المتكاملة الأخرى المتوافقة من JetBrains.

تقديم تعليقات

لتقديم ملاحظات حول تجربتك، اتّبِع الخطوات التالية:

VS Code

1. يمكنك تقديم الملاحظات بإحدى الطريقتَين التاليتَين:

   • في شريط الحالة، انقر على spark Gemini Code Assist، ثم انقر على إرسال ملاحظات في قائمة الاختيار السريع.
   • افتح لوحة الأوامر (‎Ctrl/Command + Shift + P)، ثم اختَر Gemini Code Assist: إرسال ملاحظات.

2. في النموذج، املأ الحقلَين العنوان والتعليقات.

3. في نموذج ملاحظات حول Gemini Code Assist، اختَر خيارًا من القائمتَين المنسدلتَين فئة الملاحظات والنوع.

4. اكتب وصفًا مفصّلاً لتجربتك في حقل التعليق.

5. يُرجى التأكّد من تضمين سجلّات Gemini Code Assist في تقرير الملاحظات. يتم تحديد هذا الخيار تلقائيًا.

6. ضَع علامة في أي من الخيارات الأخرى أو أزِلها، حسب ما تفضّله.

7. انقر على إرسال ملاحظات.

IntelliJ

1. في شريط الحالة، انقر على spark Gemini Code Assist.

2. بعد إرسال طلب إلى Gemini Code Assist في المحادثة، إذا لم تكن راضيًا عن الردّ، انقر على thumb_down ملاحظات سلبية، ثم اختَر تقديم ملاحظات.

3. في حقل النص في أعلى النموذج، أدخِل ملاحظاتك.

4. إذا أردت مشاركة سجلات Gemini Code Assist، تأكَّد من اختيار ملفات السجلّ.

5. انقر على إرسال ملاحظات.

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

• كيف يستخدم "Gemini في Google Cloud" بياناتك؟
• مزيد من المعلومات حول أسعار Gemini Code Assist Standard وEnterprise