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

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

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

التعرّف على كيفية استخدام Gemini لخدمات Google Cloud لبياناتك والحالات التي يتم فيها ذلك

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

هذا المستند مخصّص للمطوّرين من جميع مستويات المهارات. يفترض هذا الدليل أنّك لديك معرفة عملية باستخدام VS Code أو IntelliJ وأدوات IDE الأخرى المتوافقة من JetBrains. يمكنك أيضًا استكشاف ميزة Gemini Code Assist في Cloud Shell وCloud Workstations إذا كنت تفضّل ذلك.

قبل البدء

VS Code IntelliJ
  1. قبل اختبار إمكانات ميزة "مساعدة ترميز Gemini" فيملف الترميز، تأكَّد من توفّر لغة الترميز في ملفك. لمزيد من المعلومات حول لغات الترميز المتوافقة، يُرجى الاطّلاع على لغات الترميز المتوافقة.
  2. إذا كنت تفضّل استخدام حزمة تطوير البرامج المتكاملة (IDE) من خلال خادم وكيل، اطّلِع على مقالة اتصالات الشبكة في Visual Studio Code.

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

  2. إذا كنت تفضّل استخدام IDE من خلال خادم وكيل، اطّلِع على الخادم الوكيل HTTP.

الدردشة مع Gemini Code Assist

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

VS Code IntelliJ

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

  1. افتح ملف الرمز البرمجي.

  2. في شريط النشاط في بيئة تطوير البرامج المتكاملة، انقر على spark Gemini Code Assist.

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

    يستخدم Gemini الرمز البرمجي في ملف الرموز البرمجية كمرجع ل طلبك ويردّ بشرح لرمزك البرمجي.

    للإشارة إلى مجموعة محددة من الرموز بدلاً من كل الرموز في الملف، يمكنك اختيار المجموعة في ملف الرموز البرمجية ثم توجيه Gemini.

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

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

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

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

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

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

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

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

    يعرض Gemini إجراءات الرموز البرمجية في نهاية استجابة الرمز البرمجي الذي تم إنشاؤه.

تتوفّر هذه الخيارات عندما يحدِّد Gemini Code Assist اللغة المستخدَمة في مجموعة الرموز البرمجية، وما إذا كانت هذه اللغة متوافقة مع IDE الحالي.

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

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

سجلّ طلبات البحث في Gemini في نافذة الأداة

إعادة ضبط سجلّ المحادثات

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

VS Code IntelliJ

في لوحة Gemini Code Assist، انقر على delete إعادة ضبط المحادثة.

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

زر لمحو سجلّ المحادثات في نافذة أداة Gemini

إنشاء رمز باستخدام طلبات

توضّح لك الأقسام التالية كيفية استخدام ميزة "مساعدة الرموز البرمجية" في Gemini ل إنشاء رمز باستخدام مثال الطلب Function to create a Cloud Storage bucket داخل ملف الرمز البرمجي. يمكنك أيضًا اختيار جزء من الرمز البرمجي ثم طلب المساعدة من ميزة "مساعدة Gemini في الترميز" من خلال ميزة الدردشة، وتلقّي اقتراحات الرموز البرمجية وقبولها أو رفضها أثناء كتابة الرموز.

VS Code IntelliJ

طلب مساعدة من Gemini Code Assist في تحويل الرموز البرمجية

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

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

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

    تُنشئ ميزة Gemini Code Assist الرمز باستخدام الأمر /generate.

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

    تفتح ميزة Gemini Code Assist عرضًا للاختلافات لعرض الرمز الذي تم إنشاؤه.

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

طلب ميزة Gemini Code Assist في ملف رمز برمجي يتضمّن تعليقًا

يمكنك أيضًا طلب مساعدة Gemini في ملف الرمز البرمجي باستخدام تعليق باتّباع الخطوات التالية:

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

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

    بجانب نص الطلب في ملف الرمز، ينشئ "مساعِد الرموز البرمجية" في Gemini الرمز البرمجي في شكل نص غير مرئي.

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

طلب مساعدة من Gemini Code Assist باستخدام الرمز المحدّد من خلال المحادثة

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

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

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

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

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

    يكتب Gemini اختبار وحدة لدالة محدّدة.

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

طلب مساعدة من Gemini Code Assist في تحويل الرموز البرمجية

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

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

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

    وظيفة إنشاء تحويل الرموز البرمجية في IntelliJ Gemini Code Assist

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

    عرض الاختلافات في تحويل الرموز البرمجية في IntelliJ 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 في ملف رمز برمجي يتضمّن تعليقًا

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

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

    تُنشئ ميزة "مساعدة ترميز Gemini" الرمز البرمجي أسفل تعليقك في شكل نص غير مرئي.

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

طلب مساعدة من Gemini Code Assist باستخدام الرمز المحدّد من خلال المحادثة

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

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

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

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

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

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

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

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

VS Code IntelliJ

  1. في بيئة تطوير البرامج المتكاملة، انقر على ملف (لنظام التشغيل Windows وLinux) أو رمز (لنظام التشغيل MacOS)، ثم انتقِل إلى الإعدادات > اختصارات لوحة المفاتيح.

  2. في قائمة اختصارات لوحة المفاتيح، انتقِل إلى أن تعثر على Gemini Code Assist: Generate code (مساعدة في إنشاء الرمز).

  3. انقر على Gemini Code Assist: Generate Code (مساعدة Gemini في إنشاء الرموز البرمجية)، ثم انقر على edit Change Keybinding (تغيير ربط المفاتيح).

  4. في مربّع الحوار الذي يظهر، أدخِل الاختصار الذي تريده.

  5. اضغط على Enter (لنظام التشغيل Windows وLinux) أو Return (لنظام التشغيل MacOS).

    يمكنك الآن استخدام اختصار لوحة المفاتيح الذي تم تعيينه حديثًا لإنشاء رمز باستخدام ميزة "مساعدة الرموز البرمجية" في Gemini.

لمزيد من المعلومات حول تغيير الاختصارات في بيئة تطوير البرامج المتكاملة، يُرجى الاطّلاع على تعيينات المفاتيح في Visual Studio Code.

  1. انتقِل إلى settings إعدادات IDE والمشروع > الإعدادات > مخطّط المفاتيح > مساعدة Gemini Code.

  2. انقر بزر الماوس الأيمن على Gemini Code Assist واختَر إضافة اختصار لوحة مفاتيح.

  3. أدخِل اختصار لوحة المفاتيح المفضّل لديك، ثم انقر على حسنًا.

  4. انقر بزر الماوس الأيمن على Gemini Code Assist واختَر إزالة Alt+G (لنظام التشغيل Windows وLinux)، أو إزالة Option+G (لنظام التشغيل macOS).

يمكنك الآن استخدام اختصار لوحة المفاتيح الجديد لإنشاء رمز في ملف رمز.

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

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

VS Code IntelliJ

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

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

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

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

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

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

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

    يوفّر تطبيق Gemini قائمة منسدلة لتغيير اختصارك لقبول اقتراح مضمّن.

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

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

VS Code IntelliJ

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

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

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

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

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

زر إكمال الرموز البرمجية في Gemini في شريط حالة IntelliJ

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

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

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

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

VS Code IntelliJ

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

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

    يظهر رمز مصباح الإجراءات الذكية بعد اختيار مجموعة من الرموز البرمجية في VS Code.

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

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

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

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

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

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

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

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

VS Code IntelliJ

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

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

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

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

    خيار تحويل الرموز البرمجية لإصلاحها باستخدام Gemini في IDE

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

طلب ملفات معيّنة في مساحة العمل مع معرفة قاعدة البيانات المحلية

تساعدك ميزة "الوعي بقاعدة البيانات المحلية" من خلال تقديم اقتراحات رموز برمجية عالية الجودة صحيحة نحويًا ومفيدة من الناحية الدلالية ضمن السياق الأوسع لقاعدة بياناتك، وذلك عند تحديد ملفات لاستخدامها كسياق في ميزة "مساعدة الرموز البرمجية" من Gemini.

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

تحديد الملفات التي تتضمّن معلومات عن قاعدة البيانات المحلية

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

  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. يمكنك أيضًا النقر على اسم الملف في القائمة لاختياره. يؤدي النقر على اسم الملف إلى إضافة الملف إلى سياق الطلب وفتحه في بيئة تطوير البرامج المتكاملة.

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

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

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

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

اختياري: استبعاد الملفات من السياق باستخدام ملف ‎ .aiexclude

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

  • لا يحظر ملف .aiexclude فارغ أو غير موجود أي ملفات في دليله وجميع الأدلة الفرعية.
  • لا يتيح ملف .aiexclude استخدام النفي، حيث تُضيف علامة exclamation point (!) إلى أنماطك.
  • يتطابق ملف .aiexclude بشكلٍ شره مع الحرف *. وسيؤدي ذلك إلى مطابقة بطريقة عشوائية في الأدلة والملفات. لا يصنِّف ملف .aiexclude هذا الملفّات أو المجلدات على أنّها ** أو *.

لا يمكن حاليًا تحميل أكثر من ملف .aiexclude واحد. لضبط ملف .aiexclude، أنشئ ملفًا بعنوان .aiexclude في جذر مجلد مساحة العمل.

أمثلة

توضّح الأمثلة التالية كيفية ضبط ملف .aiexclude:

  • يمكنك حظر جميع الملفات التي تحمل الاسم apikeys.txt في دليل مساحة العمل أو تحته باتّباع الخطوات التالية:

    apikeys.txt

  • حظر جميع الملفات التي تحتوي على امتداد الملف .key في مجلّد مساحة العمل أو تحته:

    *.key

  • يمكنك حظر ملف apikeys.txt فقط في الدليل نفسه الذي يتضمّن ملف .aiexclude، وليس أي أدلة فرعية:

    /apikeys.txt

  • حظر جميع الملفات في الدليل my/sensitive/dir وجميع الأدلة الفرعية يجب أن يكون المسار نسبيًا للدليل الجذر في مساحة العمل.

    my/sensitive/dir/*

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

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

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

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

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

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

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

    لم تعُد ميزة "مساعدة الرموز البرمجية في Gemini" تقترح عليك رمزًا يتطابق مع المصادر المُستشهد بها.

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

يوضّح هذا القسم المشاكل المعروفة في ميزة "مساعدة في الترميز" في Gemini:

VS Code IntelliJ

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

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

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

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

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

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

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

  • تنتهي مهلة محاولات تسجيل الدخول باستمرار

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

     "cloudcode.beta.forceOobLogin": true

  • عدم استمرار التحذيرات بشأن قراءة الترخيص في الجلسات

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

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

    2. انقر على Gemini Code Assist - Citations (مساعدة Gemini في الترميز - الإحالات).

  • مشاكل الاتصال في نافذة مخرجات 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

ما مِن مشاكل معروفة في ميزة "مساعدة ترميز Gemini" لـ IntelliJ وأدوات تطوير البرامج المتكاملة (IDE) الأخرى المتوافقة من JetBrains.

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

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

VS Code IntelliJ

  1. في شريط الحالة، انقر على spark Gemini Code Assist، ثمّ اختَر إرسال ملاحظات في قائمة خيار سريع.

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

  3. إذا أردت مشاركة سجلات Skaffold أو AI Companion، احرص على اختيار إرسال سجلات Skaffold أو إرسال سجلات AI Companion.

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

  1. في شريط الحالة، انقر على spark Gemini Code المساعدة، ثمّ اختَر إرسال ملاحظات في القائمة.

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

  3. إذا كنت تريد مشاركة سجلّات Gemini Code Assist، احرص على اختيار ملفات السجلّ.

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

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