از سفارشی‌سازی کد Gemini Code Assist استفاده کنید

این سند نحوه استفاده از سفارشی‌سازی کد Gemini Code Assist را شرح می‌دهد و چند بهترین روش را ارائه می‌دهد. این ویژگی به شما امکان می‌دهد توصیه‌هایی را دریافت کنید که از کتابخانه‌های داخلی، APIهای خصوصی و سبک کدنویسی سازمان شما استخراج می‌شوند.

قبل از شروع

  1. با اشتراک Enterprise، Gemini Code Assist را تنظیم کنید .
  2. سفارشی‌سازی کد Gemini Code Assist را تنظیم کنید .

نحوه استفاده از سفارشی سازی کد

جدول زیر راه‌های استفاده از سفارشی‌سازی کد Gemini Code Assist را فهرست می‌کند:

فرم نحوه تحریک یادداشت ها و منابع

چت به زبان طبیعی

یک درخواست زبان طبیعی را در چت Gemini Code Assist در IDE وارد کنید.

موارد زیر را در نظر بگیرید:

  • سابقه چت در دسترس نیست. از پرس و جوهای چند مرحله ای خودداری کنید.
  • می‌توانید جزئیات بیشتری درباره منابع، از جمله پیوندهایی به منابع خاص، بپرسید.
  • اگر هنگام ارسال پیام در چت، کد را برجسته یا انتخاب کنید، Gemini Code Assist از آن کد برای بهبود سفارشی‌سازی کد و کیفیت گپ استفاده می‌کند.

برای اطلاعات بیشتر، به Chat with Gemini Code Assist مراجعه کنید.

کد تولید کنید در نوار انتخاب سریع در IDE خود، با یا بدون کد انتخاب شده، Command+Enter (در macOS) یا Control+Enter را فشار دهید. برای اطلاعات بیشتر، به ایجاد کد با دستورات مراجعه کنید.
تبدیل کد در نوار انتخاب سریع در IDE خود، با یا بدون کد انتخاب شده، /fix وارد کنید. برای اطلاعات بیشتر، به ایجاد کد با دستورات مراجعه کنید.
تکمیل خودکار سفارشی‌سازی کد به‌طور خودکار فعال می‌شود و پیشنهاداتی را بر اساس آنچه می‌نویسید ارائه می‌کند.

موارد زیر را در نظر بگیرید:

  • تکمیل کد برای ارائه یک پیشنهاد به سطح خاصی از اطمینان نیاز دارد. اطمینان حاصل کنید که مقدار قابل توجهی کد در دسترس است تا قطعات مربوطه بازیابی شوند.
  • تکمیل کد بررسی می‌کند که آیا برای استفاده از عناصر خاصی از تابع، کتابخانه‌های لازم دارید یا خیر.

برای اطلاعات بیشتر، به دریافت تکمیل کد مراجعه کنید.

زمینه مخزن از راه دور
  1. درخواست خود را با علامت @ شروع کنید. فهرستی از مخازن راه دور موجود که نمایه شده اند ظاهر می شود.
  2. مخزنی را که می خواهید برای زمینه استفاده کنید از لیست انتخاب کنید. همچنین می توانید شروع به تایپ نام مخزن برای فیلتر کردن لیست کنید.
  3. پس از انتخاب مخزن، بقیه درخواست خود را بنویسید.

موارد زیر را در نظر بگیرید:

  • این زمانی مفید است که روی کاری کار می کنید که بیشتر به مجموعه خاصی از میکروسرویس ها، کتابخانه ها یا ماژول ها مربوط می شود.

برای اطلاعات بیشتر، به دریافت پیشنهادات مرتبط تر با زمینه مخزن راه دور مراجعه کنید.

از موارد و مثال های سریع استفاده کنید

جدول زیر راهنمایی و مثال هایی در مورد استفاده از سفارشی سازی کد در موارد استفاده خاص ارائه می دهد:

مورد استفاده چیزهایی که ارزش امتحان کردن را دارد
نوشتن کد جدید

برای ایجاد کد در چت IDE یا 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/Add 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 to 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 به منظور تمرکز بر مخازن راه دور خاص، می‌توانید پیشنهادهای کد مرتبط‌تر و آگاه‌تر را دریافت کنید. با استفاده از نماد @ در چت، می توانید یک یا چند مخزن را انتخاب کنید تا به عنوان منبع اصلی زمینه برای درخواست های خود استفاده شود. این زمانی مفید است که روی کاری کار می کنید که بیشتر به مجموعه خاصی از میکروسرویس ها، کتابخانه ها یا ماژول ها مربوط می شود.

برای استفاده از یک مخزن راه دور به عنوان زمینه، این مراحل را در چت IDE خود دنبال کنید:

  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 دریافت کنید، که می‌تواند به شما در کدنویسی سریع‌تر و کارآمدتر کمک کند.