كتابة الرموز البرمجية باستخدام ميزة Gemini Code Assist للأفراد

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

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

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

إذا كنت تستخدم Gemini Code Assist Enterprise، يمكنك الاستفادة من ميزة تخصيص الرمز البرمجي، التي تتيح لك الحصول على اقتراحات رموز برمجية استنادًا إلى قاعدة الرموز البرمجية الخاصة بمؤسستك مباشرةً من Gemini Code Assist Enterprise. كيفية ضبط إعدادات تخصيص الرمز

هذا المستند مخصّص للمطوّرين من جميع مستويات المهارات. يفترض هذا الدليل أنّ لديك معرفة عملية ببرنامج 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 لإنشاء رمز باستخدام طلب المثال Function to create a Cloud Storage bucket داخل ملف الرمز. يمكنك أيضًا اختيار جزء من الرمز ثم طلب المساعدة من Gemini Code Assist من خلال ميزة الدردشة، وتلقّي اقتراحات الرموز وقبولها أو رفضها أثناء الترميز.

إرسال طلب إلى Gemini Code Assist لتحويل الرمز البرمجي

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

VS Code

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

2. في القائمة، باستخدام الأمر /generate، أدخِل /generate function to create a Cloud Storage bucket ثم اضغط على Enter (في نظام التشغيل Windows وLinux) أو Return (في نظام التشغيل macOS).

   

   ينشئ Gemini Code Assist الرمز البرمجي استنادًا إلى طلبك في عرض مقارنة.

   

3. اختياري: لقبول هذه التغييرات، انقر على قبول.

IntelliJ

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

2. في القائمة، باستخدام الأمر /generate، أدخِل /generate function to create a Cloud Storage bucket ثم اضغط على Enter (في نظامَي التشغيل Windows وLinux) أو Return (في نظام التشغيل macOS).

   

   ينشئ Gemini Code Assist الرمز البرمجي استنادًا إلى طلبك في عرض مقارنة.

   

3. اختياري: لقبول هذه التغييرات، انقر على قبول التغييرات.

   يمكنك استخدام أوامر تحويل الرموز البرمجية التالية في بيئة التطوير المتكاملة:

   • /fix: لإصلاح المشاكل أو الأخطاء في الرمز مثال: /fix potential NullPointerExceptions in my code
   • /generate: لإنشاء رمز برمجي مثال: /generate a function to get the current time
   • /doc: أضِف مستندات إلى الرمز البرمجي. مثال: /doc this function
   • /simplify: تبسيط الرمز البرمجي مثال: /simplify if statement in this code

إرسال طلب إلى Gemini Code Assist في ملف رمز باستخدام تعليق

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

VS Code

1. في سطر جديد، أدخِل التعليق Function to create a Cloud Storage bucket، ثم اضغط على Enter (في نظامَي التشغيل Windows وLinux) أو Return (في نظام التشغيل macOS).

2. لإنشاء الرمز، اضغط على Control+Enter (في نظامَي التشغيل Windows وLinux) أو Control+Return (في نظام التشغيل macOS).

   بجانب نص الطلب في ملف الرمز البرمجي، ينشئ Gemini Code Assist الرمز البرمجي في شكل نص شبحي.

3. اختياري: لقبول الرمز الذي تم إنشاؤه، اضغط على Tab.

IntelliJ

1. في ملف الرمز، أدخِل التعليق Function to create a Cloud Storage bucket في سطر جديد.

2. لإنشاء رمز، اضغط على Alt+G (في أجهزة Windows وLinux) أو Option+G (في أجهزة macOS). يمكنك بدلاً من ذلك النقر بزر الماوس الأيمن بجانب التعليق واختيار إنشاء الرمز.

   ينشئ Gemini Code Assist الرمز البرمجي أسفل تعليقك في شكل نص شبحي.

3. اختياري: لقبول الرمز الذي تم إنشاؤه، اضغط على Tab.

اختياري: تغيير اختصار لوحة المفاتيح لإنشاء الرمز

إذا كان اختصار لوحة المفاتيح التلقائي لإنشاء الرمز لا يعمل كما هو موضّح في القسم السابق، يمكنك تغيير اختصار لوحة المفاتيح.

الحصول على عمليات إكمال الرموز البرمجية

أثناء كتابة الرمز البرمجي، يقترح Gemini Code Assist رموزًا مضمّنة، تُعرف أيضًا باسم إكمال الرمز البرمجي، ويمكنك قبولها أو تجاهلها. للحصول على إكمال الرموز، اتّبِع الخطوات التالية:

VS Code

1. في ملف الرمز البرمجي، ابدأ بكتابة دالة في سطر جديد. على سبيل المثال، إذا كنت في ملف Python، اكتب def.

   يقترح Gemini Code Assist الرموز البرمجية في شكل نص شبحي.

2. لقبول اقتراح الرمز البرمجي من Gemini Code Assist، اضغط على Tab. بخلاف ذلك، لتجاهل الاقتراح، اضغط على Esc أو واصِل كتابة الرمز.

IntelliJ

1. في ملف الرمز البرمجي، ابدأ بكتابة دالة في سطر جديد. على سبيل المثال، إذا كنت في ملف Python، اكتب def.

   يقترح Gemini Code Assist الرمز البرمجي في شكل اقتراح مضمّن.

2. لقبول اقتراح الرمز البرمجي من Gemini Code Assist، اضغط على Tab. بخلاف ذلك، لتجاهل الاقتراح، اضغط على Esc أو واصِل كتابة الرمز.

3. اختياري: إذا كنت تفضّل استخدام مفتاح اختصار مختلف لقبول الاقتراح المضمّن، مرِّر المؤشر فوق الاقتراح المضمّن وانقر على القائمة المنسدلة Tab التي تظهر. بعد ذلك، اختَر الاختصار المفضّل لديك أو انقر على مخصّص لإدخال اختصارك الخاص.

   

اختياري: إيقاف ميزة إكمال الرمز

يتم تفعيل ميزة "إكمال الرمز البرمجي" تلقائيًا. إذا أردت إيقاف ميزة إكمال الرمز، اتّبِع الخطوات التالية:

VS Code

1. في بيئة التطوير المتكاملة (IDE)، انقر على Code (الرمز) (في نظام التشغيل macOS) أو File (ملف) (في نظام التشغيل Windows وLinux)، ثم انتقِل إلى Settings (الإعدادات) > Settings (الإعدادات).

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

3. انتقِل للأسفل إلى أن تعثر على قائمة Duet AI: اقتراحات مضمّنة: تفعيل تلقائي، ثم اختَر إيقاف.

   سيؤدي ذلك إلى إيقاف الاقتراحات المضمّنة. سيظل بإمكانك الضغط على Control+Enter (في نظامَي التشغيل Windows وLinux) أو Control+Return (في نظام التشغيل macOS) لتفعيل الاقتراحات المضمّنة يدويًا.

IntelliJ

في شريط الحالة الخاص ببيئة التطوير المتكاملة (IDE)، انقر على spark Gemini Code Assist: نشط، ثم اختَر تفعيل ميزة إكمال الرموز البرمجية المستنِدة إلى الذكاء الاصطناعي.

يؤدي ذلك إلى إيقاف إعداد إكمال الرمز، ولن يقدّم Gemini Code Assist اقتراحات مضمّنة إلى أن تعيد تفعيل الإعداد.

الحصول على اقتراحات أكثر صلة بالموضوع باستخدام سياق المستودع البعيد

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

لاستخدام مستودع بعيد كسياق، اتّبِع الخطوات التالية في محادثة بيئة التطوير المتكاملة:

1. ابدأ طلبك بالرمز @. ستظهر قائمة بالمستودعات البعيدة المتاحة التي تم فهرسة محتواها.
2. اختَر المستودع الذي تريد استخدامه للسياق من القائمة. يمكنك أيضًا البدء في كتابة اسم المستودع لفلترة القائمة.
3. بعد اختيار المستودع، اكتب بقية طلبك.

سيولي Gemini Code Assist بعد ذلك الأولوية للمستودع المحدّد عند إنشاء ردّ.

أمثلة على الطلبات

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

• التعرّف على مستودع
  • @REPOSITORY_NAME What is the overall structure of this repository?
  • @REPOSITORY_NAME I'm a new team member. Can you give me an overview of this repository's purpose and key modules?
• إنشاء الرمز البرمجي وتعديله
  • @REPOSITORY_NAME Implement an authentication function similar to the one in this repository.
  • @REPOSITORY_NAME Refactor the following code to follow the conventions in the selected repository.
  • Use the library-x in @REPOSITORY_A_NAME-A and implement the function-x
• اختبار
  • @UNIT_TEST_FILE_NAME Generate unit tests for module-x based on the examples in the selected file.

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

استخدام الإجراءات الذكية

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

لاستخدام الإجراءات الذكية في الرمز البرمجي، اتّبِع الخطوات التالية:

VS Code

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

2. بجانب مجموعة الرموز المحدّدة، انقر على lightbulb عرض إجراءات الرموز.

   

3. اختَر إجراءً مثل إنشاء اختبارات الوحدات.

   ينشئ Gemini Code Assist ردًا استنادًا إلى الإجراء الذي اخترته.

IntelliJ

1. في ملف الرمز، اختَر سطرًا أو مجموعة أسطر من الرمز.

2. انقر بزر الماوس الأيمن على الرمز المحدّد واختَر إجراءً ذكيًا، مثل إنشاء اختبارات الوحدة.

   سيؤدي اختيار الإجراء الذكي إلى مطالبة ‫Gemini Code Assist تلقائيًا بإنشاء رد على الطلب في نافذة أداة Gemini Code Assist.

استخدام الإصلاح السريع لتحويل الرمز

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

لتطبيق إصلاح سريع في ملف التعليمات البرمجية، اتّبِع الخطوات التالية:

VS Code

1. في ملف الرمز، مرِّر المؤشر فوق سطر الخطأ المتعرّج واختَر إصلاح سريع، ثم اختَر /fix.

   

2. عند تطبيق الإصلاح السريع، يظهر عرض الاختلاف. لقبول هذه التغييرات، انقر على قبول.

IntelliJ

1. في ملف الرمز، انقر على رمز المصباح الأحمر الذي يشير إلى وجود خطأ في الرمز، ثم اختَر الإصلاح باستخدام Gemini.

   

2. عند تطبيق الإصلاح، يظهر عرض مقارنة. لقبول هذه التغييرات، انقر على قبول.

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

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

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

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

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

لمنع اقتراح رمز مطابق للمصادر المقتبسة، اتّبِع الخطوات التالية:

VS Code

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

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

3. انتقِل إلى أسفل الصفحة إلى أن يظهر لك Geminicodeassist > التلاوة: الحد الأقصى لطول الاقتباس.

4. اضبط القيمة على 0.

لم يعُد Gemini Code Assist يقترح عليك رمزًا برمجيًا مطابقًا للمصادر المقتبسة.

IntelliJ

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

2. وسِّع قسم الإعدادات المتقدّمة، ثم ضَع علامة في مربّع الاختيار حظر الاختيارات التي تتطابق مع المصادر الخارجية المقتبسة.

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

لم يعُد Gemini Code Assist يقترح عليك رمزًا برمجيًا مطابقًا للمصادر المقتبسة.

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

يوضّح هذا القسم المشاكل المعروفة في 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