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

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

قبل البدء

  1. إعداد Gemini Code Assist من خلال اشتراك Enterprise
  2. إعداد تخصيص رمز Gemini Code Assist

كيفية استخدام ميزة "تخصيص الرمز"

يسرد الجدول التالي طرق استخدام ميزة "تخصيص التعليمات البرمجية" في Gemini Code Assist:

النموذج كيفية تشغيل الميزة ملاحظات ومراجع

المحادثة باللغة الطبيعية

أدخِل طلبًا بلغة طبيعية في نافذة الدردشة الخاصة بـ Gemini Code Assist ضمن بيئة التطوير المتكاملة.

ننصحك باتّباع الخطوات التالية:

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

لمزيد من المعلومات، راجِع المحادثة مع Gemini Code Assist.
إنشاء شفرة في شريط الاختيار السريع في بيئة التطوير المتكاملة (IDE)، اضغط على Command+Enter (في نظام التشغيل macOS) أو Control+Enter، سواء كان لديك رمز برمجي محدّد أم لا. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء رمز باستخدام الطلبات.
رمز التحويل في شريط الاختيار السريع في بيئة التطوير المتكاملة (IDE)، أدخِل /fix، سواء مع تحديد رمز أو بدون تحديد رمز. لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء رمز باستخدام الطلبات.
الإكمال التلقائي يتم تفعيل تخصيص الرمز تلقائيًا، ويقدّم اقتراحات استنادًا إلى ما تكتبه.

ننصحك باتّباع الخطوات التالية:

  • يجب أن يكون مستوى الثقة عاليًا بما يكفي لاقتراح إكمال الرمز. تأكَّد من توفّر قدر كبير من الرموز البرمجية كي يتم استرداد المقتطفات ذات الصلة.
  • تتحقّق ميزة "إكمال الرمز البرمجي" مما إذا كانت لديك المكتبات المطلوبة لاستخدام عناصر معيّنة من الدالة.

لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على عمليات إكمال الرمز.

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

ننصحك باتّباع الخطوات التالية:

  • ويكون ذلك مفيدًا عند العمل على مهمة مرتبطة بشكل كبير بمجموعة معيّنة من الخدمات المصغّرة أو المكتبات أو الوحدات.

لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على اقتراحات أكثر صلة باستخدام سياق المستودع البعيد.

حالات الاستخدام وأمثلة الطلبات

يقدّم الجدول التالي إرشادات وأمثلة حول استخدام تخصيص الرمز في حالات استخدام محدّدة:

حالة الاستخدام اقتراحات ننصح بتجربتها
كتابة رمز جديد

جرِّب ما يلي لإنشاء رمز برمجي في بيئة التطوير المتكاملة أو في محادثة Gemini Code Assist:

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

جرِّب إنشاء رمز باستخدام الطلبات التالية في محادثة Gemini Code Assist:

  • "اكتب دالة رئيسية يتم فيها إنشاء اتصال بـ DATABASE. تضمين عمليات التحقّق من الصحة".
  • اكتب FUNCTION_OR_CLASS ضمن البنية التالية: EXPLAIN_STRUCTURE".

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

  • "جرِّب الأمر /fix لتعديل الرمز البرمجي الذي تم إنشاؤه، مثلاً، أخطاء في الصيغة".
  • "إضافة عمليات الاستيراد الناقصة"
  • "جرِّب /fix على الرمز البرمجي الذي تم إنشاؤه من خلال المحادثة".
تنظيف الرموز البرمجية وتبسيطها وإعادة هيكلتها

جرِّب الطلبات التالية في محادثة Gemini Code Assist:

  • "هل يمكنك دمج IMPORTS_VARIABLES_OR_NOTE_EXPORTED_FUNCTIONS في هذا الملف؟"
  • "كيف يمكنك تبسيط الدالة FUNCTION_NAME؟"
  • "هل يمكن دمج FUNCTION_NAME_1 وFUNCTION_NAME_2 في دالة واحدة؟"
  • "هل يمكنك تضمين بعض المتغيرات في FUNCTION_NAME؟"
  • "هل يمكنك تبسيط تسمية المتغيرات في الدالة FUNCTION_NAME؟"
الوضوح وسهولة القراءة

جرِّب الطلبات التالية في محادثة Gemini Code Assist:

  • "اكتب الدالة FUNCTION_NAME في عدد أقل من أسطر الرمز البرمجي، إذا كان ذلك ممكنًا".
  • "أريد إضافة تعليقات إلى الدالة FUNCTION_NAME".
  • "إزالة المسافات البيضاء غير الضرورية في الدالة FUNCTION_NAME"
  • "نسِّق الدالة FUNCTION_NAME بطريقة مشابهة لبقية الرمز البرمجي".
مراجعة الرموز البرمجية

جرِّب الطلبات التالية في محادثة Gemini Code Assist:

  • "قسِّم الرمز إلى أجزاء واشرح كل جزء باستخدام قاعدة الرموز البرمجية الخاصة بنا".
  • "هل هناك متغيرات أو كلمات رئيسية يمكن أن تكون أقصر وأكثر وضوحًا؟"
  • "هل يمكنك تزويدي برمز مفيد من سياق REPOSITORY_NAME_PACKAGE_MODULE لهذا الرمز؟"
  • "ما رأيك في الدالة FUNCTION_NAME؟"
تصحيح الأخطاء

جرِّب الطلبات التالية في محادثة Gemini Code Assist:

  • "تظهر لي رسالة خطأ عند محاولة تنفيذ الإجراء X أو إضافة Y. لماذا؟"
  • "هل يمكنك رصد خطأ في الدالة FUNCTION_NAME؟"
  • "كيف يمكن إصلاح الدالة FUNCTION_NAME بالنظر إلى رسالة الخطأ هذه؟"
التعلّم وإعداد الموظفين الجدد

جرِّب الطلبات التالية في محادثة Gemini Code Assist:

  • "قسِّم هذا الرمز إلى أجزاء واشرح كل جزء باستخدام قاعدة الرموز البرمجية الخاصة بنا."
  • "كيف يمكنني استدعاء الدالة FUNCTION_NAME؟"
  • "كيف يمكنني تشغيل الدالة الرئيسية في بيئة ENVIRONMENT_NAME؟"
  • "ما هو التحسين الفني الرئيسي الذي يمكننا إجراؤه لجعل هذا الرمز البرمجي أكثر فعالية؟"
  • "أريد معرفة كيفية تنفيذ FUNCTION_OR_CLASS_NAME لتحقيق نتائج أفضل مع إضافة وصف لهذا العنصر"، مثل "أريد معرفة كيفية تنفيذ الدالة foo حيث foo هو اسم الدالة".
النقل

جرِّب الطلبات التالية في محادثة Gemini Code Assist:

  • "أريد استراتيجية لنقل FILE_NAME من LANGUAGE_1 إلى LANGUAGE_2"، مثلاً من Go إلى Python.
  • "بالنظر إلى الدالة FUNCTION_NAME في المستودع REPOSITORY_NAME، ابحث لي عن دالة مكافئة باللغة LANGUAGE_NAME يمكنني استخدامها".

جرِّب سير العمل التالي المستند إلى المحادثة أو إنشاء الرموز باستخدام الطلبات:

  1. "أريد تحويل الرمز FILENAME_COMPONENT المكتوب بلغة LANGUAGE_1 إلى لغة LANGUAGE_2"، مثلاً، من Go إلى Python.
  2. بعد نقل بعض الرموز، جرِّب ما يلي:
    • اختَر أجزاء أصغر واستخدِم /fix للوصول إلى الحالة التي تريدها.
    • جرِّب الطلبات التالية:
      • "هل هناك أي شيء يمكن تحسينه؟"
      • "أريد معرفة المشاكل المحتملة".
      • "كيف يمكنك اختبار هذا الرمز إذا كان الترحيل صحيحًا؟"
إنشاء مستندات

جرِّب الطلبات التالية في محادثة Gemini Code Assist:

  • "أريد تلخيص الرمز البرمجي في الحزمة أو المجلد X وتقديم مستندات لأهم خمس طرق."
  • "أريد إنشاء مستندات خاصة بـ FUNCTION_OR_CLASS_NAME".
  • "أريد تلخيص المستند مع الحفاظ على المعلومات الأساسية".
إنشاء اختبارات الوحدات

جرِّب الطلبات التالية في محادثة Gemini Code Assist:

  • "إنشاء اختبارات وحدات للرمز FILENAME"
  • "أريد إضافة حالات الاختبار الأكثر صلة بالدالة FUNCTION_NAME".
  • "أزِل حالات الاختبار التي تعتقد أنّها لا تقدّم قيمة كبيرة".

أفضل الممارسات

  • استخدِم أسماء متغيرات ودوال أو مقتطفات رموز ذات صلة. يوجه هذا الدليل عملية تخصيص الرموز البرمجية نحو أمثلة الرموز البرمجية الأكثر صلة.
  • استخدِم مستودعات الفهرس التي تريد توسيع نطاقها، وتجنَّب إضافة وظائف تم إيقافها نهائيًا. يساعد تخصيص الرموز البرمجية في التوسّع لتلبية متطلبات أسلوب الرموز البرمجية وأنماطها ودلالاتها ومعرفتها وعمليات تنفيذها في جميع أنحاء قاعدة الرموز البرمجية. تشمل الأمثلة السيئة على المستودعات التي يمكن توسيع نطاقها الوظائف المتوقّفة نهائيًا والرموز البرمجية التي تم إنشاؤها وعمليات التنفيذ القديمة.
  • بالنسبة إلى حالات استخدام استرجاع الرموز، استخدِم وظيفة إنشاء الرموز بدلاً من إكمال الرموز. استخدِم عبارات في الطلب مثل "باستخدام تعريف FUNCTION_NAME، أنشئ الدالة نفسها بالضبط" أو "أنشئ التنفيذ نفسه بالضبط للدالة FUNCTION_NAME".
  • تضمين عمليات تضمين أو استيراد في الملف للرمز البرمجي الذي تريد استرداده لتحسين إدراك Gemini للسياق
  • تنفيذ إجراء واحد فقط لكل طلب على سبيل المثال، إذا أردت استرداد رمز وتنفيذ هذا الرمز في دالة جديدة، اتّبِع الخطوات التالية على مدى طلبَين.
  • في حالات الاستخدام التي تحتاج فيها إلى أكثر من مجرد رمز (مثل شرح الرمز أو خطة النقل أو شرح الخطأ)، استخدِم ميزة "تخصيص الرمز" في المحادثة، حيث يمكنك إجراء محادثة مع Gemini مع توفير سياق قاعدة الرموز.
  • يُرجى العِلم أنّ إنشاء نماذج الذكاء الاصطناعي غير حتمي. إذا لم تكن راضيًا عن الرد، قد يؤدي تنفيذ الطلب نفسه مرة أخرى إلى تحقيق نتيجة أفضل.
  • يُرجى العِلم أنّ إنشاء اختبارات الوحدة يكون عادةً أفضل إذا فتحت الملف محليًا، ثم طلبت من المحادثة إنشاء اختبارات الوحدة لهذا الملف أو لدالة معيّنة.

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

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

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

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

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

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

في ما يلي بعض الأمثلة حول كيفية استخدام هذه الميزة:

  • للتعرّف على مستودع:
    • "@REPOSITORY_NAME ما هو الهيكل العام لهذا المستودع؟"
    • REPOSITORY_NAME أنا عضو جديد في الفريق. هل يمكنك تقديم نظرة عامة حول الغرض من هذا المستودع والوحدات الرئيسية فيه؟"
  • لإنشاء الرموز البرمجية وتعديلها:
    • "@REPOSITORY_NAME نفِّذ وظيفة مصادقة مشابهة للوظيفة الواردة في هذا المستودع."
    • "@REPOSITORY_NAME إعادة تصميم الرمز التالي ليتوافق مع الاصطلاحات في المستودع المحدّد"
    • REPOSITORY_A_NAME@ كيف يمكنني استخدام أحدث الوظائف من هذا المستودع لتحسين الرمز البرمجي في REPOSITORY_B_NAME؟"
  • للاختبار:
    • UNIT_TEST_FILE_NAME إنشاء اختبارات الوحدة لـ MODULE استنادًا إلى الأمثلة في الملف المحدّد@"

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