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

ملاحظة: لا تتوفّر ميزة تخصيص الرموز البرمجية في Gemini Code Assist إلا في Gemini Code Assist Enterprise. لمزيد من المعلومات، يُرجى الاطّلاع على الميزات المتوافقة مع 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، سواء مع تحديد رمز أو بدون تحديد رمز.	لمزيد من المعلومات، يُرجى الاطّلاع على إنشاء رمز باستخدام الطلبات.
الإكمال التلقائي	يتم تفعيل تخصيص الرمز تلقائيًا، ويقدّم اقتراحات استنادًا إلى ما تكتبه.	ننصحك باتّباع الخطوات التالية: يجب أن يتوفّر مستوى معيّن من الثقة في ميزة إكمال الرمز البرمجي حتى تقترح عليك اقتراحًا. تأكَّد من توفّر قدر كبير من الرموز البرمجية كي يتم استرداد المقتطفات ذات الصلة. تتحقّق ميزة "إكمال الرمز البرمجي" مما إذا كانت لديك المكتبات المطلوبة لاستخدام عناصر معيّنة من الدالة. لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على عمليات إكمال الرمز.
سياق المستودع البعيد	ابدأ طلبك بالرمز @. ستظهر قائمة بالمستودعات البعيدة المتاحة التي تم فهرستها. اختَر المستودع الذي تريد استخدامه للسياق من القائمة. يمكنك أيضًا البدء بكتابة اسم المستودع لفلترة القائمة. بعد اختيار المستودع، اكتب بقية طلبك.	ننصحك باتّباع الخطوات التالية: لا يتوفّر هذا الخيار في وضع "الوكيل". ويكون ذلك مفيدًا عند العمل على مهمة مرتبطة بشكل كبير بمجموعة معيّنة من الخدمات المصغّرة أو المكتبات أو الوحدات. لمزيد من المعلومات، يُرجى الاطّلاع على الحصول على اقتراحات أكثر صلة باستخدام سياق المستودع البعيد.

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

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

حالة الاستخدام	اقتراحات ننصح بتجربتها
كتابة رمز جديد	جرِّب ما يلي لإنشاء رمز برمجي في بيئة التطوير المتكاملة أو في محادثة 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 يمكنني استخدامها". جرِّب سير العمل التالي المستند إلى المحادثة أو إنشاء الرموز باستخدام الطلبات: "أريد تحويل الرمز FILENAME_COMPONENT المكتوب بلغة LANGUAGE_1 إلى لغة LANGUAGE_2"، مثلاً من Go إلى Python. بعد نقل بعض الرموز، جرِّب ما يلي: اختَر أجزاء أصغر واستخدِم /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، ما يساعدك في كتابة الرموز البرمجية بشكل أسرع وأكثر فعالية.