کد با Gemini Code Assist برای افراد

این سند توضیح می‌دهد که چگونه می‌توانید از Gemini Code Assist ، یک همکار مبتنی بر هوش مصنوعی در IDE خود استفاده کنید تا به شما در انجام کارهای زیر در VS Code یا IntelliJ و سایر IDE‌های JetBrains پشتیبانی‌شده کمک کند:

  • راهنمایی برای کمک به حل مشکلات کد خود ارائه دهید.
  • برای پروژه خود کد تولید کنید.
  • هنگام کدنویسی پیشنهادات درون خطی دریافت کنید.

بیاموزید Gemini for Google Cloud چگونه و چه زمانی از داده‌های شما استفاده می‌کند .

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

این سند برای توسعه دهندگان در تمام سطوح مهارت در نظر گرفته شده است. فرض بر این است که شما دانش کاری VS Code یا IntelliJ و سایر IDE های JetBrains پشتیبانی شده دارید. همچنین می توانید از Gemini در اندروید استودیو استفاده کنید

قبل از شروع

کد VS

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

IntelliJ

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

  2. اگر ترجیح می دهید از IDE خود در پشت پراکسی استفاده کنید، به پروکسی HTTP مراجعه کنید.

از چت Gemini Code Assist برای توضیح کد خود استفاده کنید

در این بخش، از Gemini Code Assist می‌خواهید تا توضیحی در مورد کد موجود شما ارائه دهد.

کد VS

برای دریافت توضیح کد خود، این مراحل را دنبال کنید:

  1. فایل کد خود را باز کنید.

  2. در نوار فعالیت IDE خود، spark Gemini Code Assist کلیک کنید.

  3. در قسمت Gemini Code Assist ، دستور Explain this code to me وارد کنید و روی send کلیک کنید.

    Gemini Code Assist از کد موجود در فایل کد شما به عنوان مرجع درخواست شما استفاده می کند و با توضیح کد شما پاسخ می دهد.

    برای مراجعه به یک بلوک کد خاص به جای همه کدهای موجود در فایل، می‌توانید بلوک را در فایل کد خود انتخاب کنید و سپس از Gemini Code Assist درخواست کنید.

IntelliJ

برای دریافت توضیح کد خود، این مراحل را دنبال کنید:

  1. در IDE خود، فایل کد خود را باز کنید.

  2. در پنجره ابزار Gemini Code Assist، اعلان Explain this code to me وارد کنید و روی ارسال کلیک کنید.

Gemini Code Assist از کد موجود در فایل کد شما به عنوان مرجع درخواست شما استفاده می کند و با توضیح کد شما پاسخ می دهد.

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

هنگامی که Gemini Code Assist کدی را در پاسخ به شما ارائه می‌کند، می‌توانید گزینه‌های زیر را که در انتهای پاسخ آن فهرست شده است انتخاب کنید:

  • درج در مکان نما : کد ایجاد شده را در فایل فعلی در موقعیت مکان نما فعلی شما وارد می کند.

  • Insert in New File : فایل جدیدی را باز می کند و کد تولید شده را در فایل جدید قرار می دهد.

    Gemini اقدامات کد را در انتهای یک پاسخ کد تولید شده فهرست می کند.

این گزینه ها زمانی در دسترس هستند که Gemini Code Assist زبان مورد استفاده در بلوک کد شما را شناسایی کند و اگر این زبان در IDE فعلی شما پشتیبانی شود.

مشاهده تاریخچه پرس و جو

اگر می‌خواهید دوباره از درخواست‌های قبلی‌تان استفاده کنید، می‌توانید با کلیک کردن روی schedule نمایش تاریخچه پرس و جو، آن‌ها را در «سابقه پرسمان» در پنجره ابزار Gemini Code Assist پیدا کنید.

Gemini Query History در پنجره ابزار.

چندین چت ایجاد کنید

می‌توانید با Gemini Code Assist چت‌های متعددی ایجاد کنید که حاوی زمینه‌های جداگانه‌ای از چت‌های دیگر است. سابقه چت شما اولین چت و آخرین مُهر زمانی به‌روزرسانی‌شده را نشان می‌دهد. محدودیت 20 چت وجود دارد. پس از رسیدن به این حد، قدیمی‌ترین چت به‌طور خودکار حذف می‌شود که چت جدیدی اضافه می‌کنید.

کد VS

  1. برای افزودن یک چت جدید، روی افزودن گپ جدید کلیک کنید و درخواست خود را در قسمت متن وارد کنید. پس از وارد کردن فرمان، Gemini Code Assist چت جدید را ایجاد می کند.
  2. برای دسترسی به چت قبلی خود، روی تاریخچه ازسرگیری چت قبلی کلیک کنید. لیستی از چت های شما ظاهر می شود. چتی را که می خواهید مشاهده کنید انتخاب کنید.
  3. برای حذف یک موضوع چت، روی Resume Previous Chat کلیک کنید و سپس روی delete Delete در کنار چتی که می خواهید حذف کنید کلیک کنید.

IntelliJ

این ویژگی در حال حاضر در Gemini Code Assist برای IntelliJ و سایر IDE های JetBrains پشتیبانی نمی شود.

بازنشانی سابقه چت

Gemini Code Assist از تاریخچه چت برای زمینه اضافی هنگام پاسخ دادن به درخواست‌های شما استفاده می‌کند. اگر سابقه چت شما دیگر با آنچه می‌خواهید به دست آورید مرتبط نیست، می‌توانید سابقه گپ را بازنشانی کنید .

ایجاد کد با دستورات

بخش‌های زیر به شما نشان می‌دهند که چگونه از Gemini Code Assist برای تولید کد با مثال Function to create a Cloud Storage bucket در داخل فایل کد خود استفاده کنید. همچنین می‌توانید بخشی از کد خود را انتخاب کنید و سپس از Gemini Code Assist از طریق ویژگی چت کمک بخواهید، و هنگام کدنویسی پیشنهادات کد را دریافت و قبول یا رد کنید.

کد VS

کمک به کد Gemini با تبدیل کد

تبدیل کد به شما این امکان را می دهد که از دستورات یا دستورات زبان طبیعی در منوی انتخاب سریع برای درخواست تغییرات در کد خود استفاده کنید و یک نمای متفاوت برای نمایش تغییرات معلق در کدتان در اختیار شما قرار می دهد. برای درخواست Gemini Code Assist با تبدیل کد، مراحل زیر را دنبال کنید:

  1. در فایل کد خود، در یک خط جدید، Control+I (برای ویندوز و لینوکس) یا Command+I (برای macOS) را فشار دهید تا منوی Gemini Code Assist Quick Pick باز شود.

  2. در منو، با استفاده از فرمان /generate ، /generate function to create a Cloud Storage bucket وارد کنید و سپس Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

    Gemini Code Assist با دستور /generate کد تولید می کند.

    Gemini Code Assist کد را بر اساس درخواست شما در نمای متفاوت تولید می کند.

    Gemini Code Assist یک نمای متفاوت برای نمایش کد تولید شده باز می کند.

  3. اختیاری: برای پذیرش این تغییرات، روی Accept کلیک کنید.

از Gemini Code Assist در یک فایل کد با یک نظر توضیح دهید

اگر ترجیح می‌دهید، می‌توانید با دنبال کردن مراحل زیر، از Gemini Code Assist در فایل کد خود با یک نظر درخواست کنید:

  1. در یک خط جدید، Function to create a Cloud Storage bucket و سپس Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

  2. برای تولید کد، Control+Enter (برای ویندوز و لینوکس) یا Control+Return (برای macOS) را فشار دهید.

    در کنار متن درخواستی شما در فایل کدتان، Gemini Code Assist کد را به شکل متن شبح تولید می کند.

  3. اختیاری: برای پذیرش کد تولید شده، Tab را فشار دهید.

از Gemini Code با استفاده از چت با کد انتخابی کمک کنید

Gemini Code Assist می تواند وظایف را انجام دهد یا بر اساس کدی که انتخاب می کنید به سؤالات شما پاسخ دهد. برای دریافت کد تولید شده بر اساس یک درخواست با کد انتخاب شده، این مراحل را دنبال کنید:

  1. در نوار فعالیت، روی spark Gemini Code Assist کلیک کنید تا پنجره Gemini Code Assist باز شود.

  2. در فایل کد خود، یک بلوک کد را انتخاب کنید.

  3. در قسمت متنی کادر Gemini Code Assist ، یک درخواست برای کد انتخاب شده وارد کنید.

    به عنوان مثال، یک تابع را در کد خود انتخاب کنید و دستور Write a unit test for this function را وارد کنید:

    Gemini برای یک تابع انتخاب شده یک تست واحد می نویسد.

    Gemini از کد انتخابی شما به عنوان مرجع استفاده می کند و به درخواست شما پاسخ می دهد.

IntelliJ

کمک به کد Gemini با تبدیل کد

تبدیل کد به شما این امکان را می دهد که از دستورات یا دستورات زبان طبیعی در منوی انتخاب سریع برای درخواست تغییرات در کد خود استفاده کنید و یک نمای متفاوت برای نمایش تغییرات معلق در کدتان در اختیار شما قرار می دهد. برای درخواست Gemini Code Assist با تبدیل کد، مراحل زیر را دنبال کنید:

  1. در فایل کد خود، در یک خط جدید، Alt+\ (برای ویندوز و لینوکس) یا Cmd+\ (برای macOS) را فشار دهید تا منوی Gemini Code Assist Quick Pick باز شود.

  2. در منو، با استفاده از فرمان /generate ، /generate function to create a Cloud Storage bucket وارد کنید و سپس Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

    تبدیل کد عملکردی را در IntelliJ Gemini Code Assist ایجاد می کند

    Gemini Code Assist کد را بر اساس درخواست شما در نمای متفاوت تولید می کند.

    نمای تغییر تغییر کد در IntelliJ Gemini Code Assist

  3. اختیاری: برای پذیرش این تغییرات، روی Accept Changes کلیک کنید.

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

    • /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 (برای ویندوز و لینوکس) یا Option+G (برای macOS) را فشار دهید. یا می‌توانید در کنار نظر کلیک راست کرده و Generate Code را انتخاب کنید.

    Gemini Code Assist کد زیر نظر شما را به شکل متن شبح تولید می کند.

  3. اختیاری: برای پذیرش کد تولید شده، Tab را فشار دهید.

از Gemini Code با استفاده از چت با کد انتخابی کمک کنید

Gemini Code Assist می تواند وظایف را انجام دهد یا بر اساس کدی که انتخاب می کنید به سؤالات شما پاسخ دهد. برای دریافت کد تولید شده بر اساس یک درخواست با کد انتخاب شده، این مراحل را دنبال کنید:

  1. در نوار فعالیت، روی spark Gemini Code Assist کلیک کنید تا پنجره ابزار Gemini Code Assist باز شود.

  2. در فایل کد خود، یک بلوک کد را انتخاب کنید.

  3. در قسمت متنی پنجره ابزار Gemini Code Assist ، یک درخواست برای کد انتخاب شده وارد کنید.

    به عنوان مثال، یک تابع را در کد خود انتخاب کنید و دستور Write a unit test for this function.

    Gemini Code Assist از کد انتخابی شما به عنوان مرجع استفاده می کند و به درخواست شما پاسخ می دهد.

اختیاری: میانبر صفحه کلید را برای تولید کد تغییر دهید

اگر میانبر پیش‌فرض صفحه‌کلید برای تولید کد، همانطور که در بخش قبل توضیح داده شد، کار نمی‌کند، می‌توانید با دنبال کردن این مراحل، میان‌بر صفحه‌کلید را تغییر دهید:

کد VS

  1. در IDE خود، روی File (برای Windows و Linux) یا Code (برای macOS) کلیک کنید و سپس به تنظیمات > میانبرهای صفحه کلید بروید.

  2. در لیست میانبرهای صفحه کلید، پیمایش کنید تا Gemini Code Assist: Generate code را پیدا کنید.

  3. روی Gemini Code Assist: Generate Code کلیک کنید و سپس روی edit Change Keybinding کلیک کنید.

  4. در گفتگوی ظاهر شده، میانبر خود را وارد کنید.

  5. Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

    اکنون می توانید از میانبر صفحه کلید جدید اختصاص داده شده خود برای تولید کد با Gemini Code Assist استفاده کنید.

برای کسب اطلاعات بیشتر در مورد تغییر میانبرها در IDE خود، به Keybindings for Visual Studio Code مراجعه کنید.

IntelliJ

  1. به settings IDE و Project Settings > Settings > Keymap > Gemini Code Assist بروید.

  2. روی Gemini Code Assist کلیک راست کرده و Add Keyboard Shortcut را انتخاب کنید.

  3. میانبر صفحه کلید دلخواه خود را وارد کنید و سپس روی OK کلیک کنید.

  4. روی Gemini Code Assist راست کلیک کرده و Remove Alt+G (برای ویندوز و لینوکس) یا Remove Option+G (برای macOS) را انتخاب کنید.

اکنون می توانید از میانبر صفحه کلید جدید خود برای تولید کد در یک فایل کد استفاده کنید.

دستورات سفارشی ایجاد کنید

به طور پیش فرض، Gemini Code Assist دستوراتی مانند /generate را ارائه می دهد. همچنین می توانید دستورات سفارشی خود را ایجاد کنید تا به شما کمک کند کارهای تکراری را سریعتر در IDE خود انجام دهید.

در این قسمت شما یک دستور سفارشی به نام add-comments ایجاد می کنید که نظرات را به کد موجود در فایل کد شما اضافه می کند.

کد VS

  1. در فایل کد خود، Control+I (برای ویندوز و لینوکس) یا Command+I (برای macOS) را فشار دهید تا منوی Gemini Code Assist Quick Pick باز شود.

  2. در منو، تنظیمات برگزیده را جستجو و انتخاب کنید: تنظیمات (UI) را باز کنید .

  3. در قسمت تنظیمات جستجو ، Geminicodeassist: Custom Commands وارد کنید.

  4. در کادر دستورات سفارشی ، Add Item را انتخاب کنید.

  5. در قسمت Item ، add-comments به عنوان نام دستور وارد کنید.

  6. در قسمت Value ، add comments to all functions without comments in my code به عنوان اعلان وارد کنید.

  7. روی OK کلیک کنید.

اکنون می توانید از دستور سفارشی add-comments در IDE خود استفاده کنید. این فرمان در فهرست دستورات در منوی Gemini Code Assist Quick Pick ( Control+I (برای ویندوز و لینوکس) یا Command+I (برای macOS)) ظاهر می‌شود.

IntelliJ

این ویژگی در حال حاضر در Gemini Code Assist برای IntelliJ و سایر IDE های JetBrains پشتیبانی نمی شود.

قوانین ایجاد کنید

می‌توانید قوانینی را برای Gemini Code Assist ایجاد کنید تا از آن پیروی کند، و قوانین در هر پیام چتی که وارد می‌کنید گنجانده شده است.

کد VS

  1. در فایل کد خود، Control+I (برای ویندوز و لینوکس) یا Command+I (برای macOS) را فشار دهید تا منوی Gemini Code Assist Quick Pick باز شود.

  2. در منو، تنظیمات برگزیده را جستجو و انتخاب کنید: تنظیمات (UI) را باز کنید .

  3. در قسمت تنظیمات جستجو ، Geminicodeassist: Rules را وارد کنید.

  4. در قسمت متن، قاعده‌ای مانند: Always generate unit tests when creating a new function . همچنین می توانید یک یا چند قانون را با چند خط در قسمت متن اضافه کنید.

    پس از افزودن قوانین در تنظیمات قوانین، Gemini Code Assist قانون را برای هر درخواست یا درخواستی که می کنید در نظر می گیرد.

    برای حذف قانون، محتوا را از قسمت متن قوانین حذف کنید.

IntelliJ

این ویژگی در حال حاضر در Gemini Code Assist برای IntelliJ و سایر IDE های JetBrains پشتیبانی نمی شود.

تکمیل کدها را دریافت کنید

هنگام نوشتن کد، Gemini Code Assist کدهای درون خطی را پیشنهاد می کند که به عنوان تکمیل کد نیز شناخته می شود، که می توانید آنها را بپذیرید یا نادیده بگیرید. برای دریافت تکمیل کد، مراحل زیر را دنبال کنید:

کد VS

  1. در فایل کد خود، در یک خط جدید، شروع به نوشتن یک تابع کنید. برای مثال، اگر در یک فایل پایتون هستید، def بنویسید.

    Gemini Code Assist کدی را به شکل متن شبح پیشنهاد می کند.

  2. برای پذیرش پیشنهاد کد از Gemini Code Assist، Tab را فشار دهید. در غیر این صورت، برای نادیده گرفتن پیشنهاد، Esc را فشار دهید یا به نوشتن کد خود ادامه دهید.

IntelliJ

  1. در فایل کد خود، در یک خط جدید، شروع به نوشتن یک تابع کنید. برای مثال، اگر در یک فایل پایتون هستید، def بنویسید.

    Gemini Code Assist کد را در قالب یک پیشنهاد درون خطی پیشنهاد می کند.

  2. برای پذیرش پیشنهاد کد از Gemini Code Assist، Tab را فشار دهید. در غیر این صورت، برای نادیده گرفتن پیشنهاد، Esc را فشار دهید یا به نوشتن کد خود ادامه دهید.

  3. اختیاری: اگر ترجیح می دهید از کلید میانبر دیگری برای پذیرش پیشنهاد درون خطی استفاده کنید، نشانگر خود را روی پیشنهاد درون خطی نگه دارید و روی منوی کشویی Tab که ظاهر می شود کلیک کنید. سپس، میانبر مورد نظر خود را انتخاب کنید یا روی Custom کلیک کنید تا میانبر خود را وارد کنید.

    Gemini یک منوی کشویی برای تغییر میانبر شما برای پذیرش یک پیشنهاد درون خطی ارائه می دهد.

اختیاری: تکمیل کد را غیرفعال کنید

تکمیل کد به طور پیش فرض فعال است. اگر می خواهید تکمیل کد را غیرفعال کنید، این مراحل را دنبال کنید:

کد VS

  1. در IDE خود، روی Code (برای macOS) یا File (برای Windows و Linux) کلیک کنید و سپس به Settings > Settings بروید.

  2. در برگه کاربر در گفتگوی تنظیمات ، به Extensions > Gemini Code Assist بروید.

  3. پیمایش کنید تا Duet AI: Inline Suggestions: Enable Auto list را بیابید و سپس Off را انتخاب کنید.

    این پیشنهادات درون خطی را خاموش می کند. همچنان می توانید Control+Enter (برای ویندوز و لینوکس) یا Control+Return (برای macOS) را فشار دهید تا به صورت دستی پیشنهادات درون خطی را فعال کنید.

IntelliJ

در نوار وضعیت IDE خود، روی spark Gemini Code Assist: Active کلیک کنید و Enable AI Code Completion را انتخاب کنید.

دکمه تکمیل کد Gemini در نوار وضعیت IntelliJ.

این تنظیمات تکمیل کد را غیرفعال می‌کند و Gemini Code Assist دیگر پیشنهادات درون خطی ارائه نمی‌کند تا زمانی که تنظیم را دوباره فعال کنید.

از اقدامات هوشمندانه استفاده کنید

Gemini Code Assist برای کمک به بهره‌وری بیشتر و در عین حال به حداقل رساندن تغییر زمینه، اقدامات هوشمند مبتنی بر هوش مصنوعی را مستقیماً در ویرایشگر کد شما ارائه می‌کند. هنگامی که کد خود را در ویرایشگر کد خود انتخاب می کنید، می توانید لیستی از اقدامات مرتبط با زمینه خود را مشاهده و انتخاب کنید.

برای استفاده از اقدامات هوشمند در کد خود، این مراحل را دنبال کنید:

کد VS

  1. در فایل کد خود، یک بلوک کد را انتخاب کنید.

  2. در کنار بلوک کد انتخاب شده، lightbulb نمایش اقدامات کد کلیک کنید.

    نماد لامپ اقدامات هوشمند پس از انتخاب یک بلوک کد در VS Code ظاهر می شود.

  3. اقدامی مانند Generate unit tests را انتخاب کنید.

    Gemini Code Assist پاسخی را ایجاد می‌کند که بر اساس عملکردی است که انتخاب کرده‌اید.

IntelliJ

  1. در فایل کد خود، یک خط یا بلوک کد را انتخاب کنید.

  2. روی کد انتخاب شده کلیک راست کرده و یک اقدام هوشمند مانند Generate unit tests را انتخاب کنید.

    انتخاب کنش هوشمند به طور خودکار از Gemini Code Assist درخواست می‌کند تا در پنجره ابزار Gemini Code Assist به درخواست پاسخ دهد.

از اصلاح سریع تبدیل کد استفاده کنید

اگر خطایی در کد شما وجود داشته باشد، Gemini Code Assist به شما این امکان را می دهد که با تبدیل کد، یک اصلاح سریع برای خطا اعمال کنید.

برای اعمال یک رفع سریع در فایل کد خود، این مراحل را دنبال کنید:

کد VS

  1. در فایل کد خود، نشانگر خود را روی خط خطای squiggly نگه دارید و Quick Fix را انتخاب کنید و سپس /fix را انتخاب کنید.

    رفع سریع تبدیل کد در IDE.

  2. هنگامی که رفع سریع اعمال می شود، نمای تفاوت ظاهر می شود. برای پذیرش این تغییرات، روی Accept کلیک کنید.

IntelliJ

  1. در فایل کد خود، روی نماد لامپ خطای قرمز رنگ که نشان دهنده خطای کد شما است، کلیک کنید و گزینه Fix with Gemini را انتخاب کنید.

    گزینه تبدیل کد برای اصلاح با Gemini در IDE.

  2. هنگامی که اصلاح اعمال می شود، یک نمای تفاوت ظاهر می شود. برای پذیرش این تغییرات، روی Accept کلیک کنید.

فایل ها و پوشه های خاصی را در فضای کاری خود با آگاهی از پایگاه کد محلی درخواست کنید

آگاهی از پایگاه کد محلی به شما کمک می کند تا با پیشنهادات کد با کیفیت بالا که از نظر نحوی صحیح و از نظر معنایی در زمینه گسترده تر پایگاه کد شما معنادار هستند، هنگامی که فایل ها یا پوشه هایی را برای Gemini Code Assist برای استفاده به عنوان زمینه تعیین می کنید.

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

کد VS

برای مشخص کردن فایل‌ها یا پوشه‌ها در اعلان چت، @ را تایپ کرده و فایل یا پوشه‌ای را که می‌خواهید مشخص کنید انتخاب کنید.

فایل‌ها و پوشه‌هایی را با آگاهی از پایگاه کد محلی برای VS Code مشخص کنید.

برای دریافت توضیح در مورد تفاوت دو فایل در پایگاه کد خود، این مراحل را دنبال کنید:

  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 را فشار دهید. همچنین می توانید برای انتخاب فایل روی نام فایل موجود در لیست کلیک کنید. کلیک کردن روی نام فایل، فایل را به متن درخواست شما اضافه می کند و فایل را در IDE شما باز می کند.

Gemini Code Assist هنگام استفاده از دو فایلی که برای زمینه مشخص کرده‌اید به درخواست شما پاسخ می‌دهد. Gemini Code Assist همچنین شامل فایل‌هایی است که در منابع زمینه مشخص کرده‌اید.

اکنون که آن فایل‌ها را مشخص کرده‌اید، می‌توانید بدون نیاز به تعیین مجدد فایل‌ها، سؤالات یا درخواست‌های اضافی را در همان سابقه چت بپرسید.

به عنوان مثال: در قسمت Gemini Code Assist ، فرمان را وارد کنید How can I improve YOUR_FILE_NAME_1? (بدون علامت @ ) و Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

Gemini Code Assist به درخواست شما در مورد فایلی که در درخواست خود مشخص کرده اید پاسخ می دهد.

IntelliJ

برای مشخص کردن فایل‌ها یا پوشه‌ها در اعلان چت، @ را تایپ کرده و فایل‌ها یا پوشه‌هایی را که می‌خواهید مشخص کنید انتخاب کنید.

فایل هایی را با آگاهی از پایگاه کد محلی برای IntelliJ مشخص کنید.

برای دریافت توضیح در مورد تفاوت دو فایل در پایگاه کد خود، این مراحل را دنبال کنید:

  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 را فشار دهید. همچنین می توانید برای انتخاب فایل روی نام فایل موجود در لیست کلیک کنید. کلیک کردن روی نام فایل، فایل را به متن درخواست شما اضافه می کند و فایل را در IDE شما باز می کند.

Gemini Code Assist هنگام استفاده از دو فایلی که برای زمینه مشخص کرده‌اید به درخواست شما پاسخ می‌دهد. Gemini Code Assist همچنین شامل فایل‌هایی است که در منابع زمینه مشخص کرده‌اید.

اکنون که آن فایل‌ها را مشخص کرده‌اید، می‌توانید بدون نیاز به تعیین مجدد آن‌ها، سؤالات یا درخواست‌های اضافی را در همان سابقه چت بپرسید.

به عنوان مثال: در قسمت Gemini Code Assist ، فرمان را وارد کنید How can I improve YOUR_FILE_NAME_1? (بدون علامت @ ) و Enter (برای ویندوز و لینوکس) یا Return (برای macOS) را فشار دهید.

Gemini Code Assist به درخواست شما در مورد فایلی که در درخواست خود مشخص کرده اید پاسخ می دهد.

پیشنهادات کدی را که با منابع ذکر شده مطابقت دارند غیرفعال کنید

Gemini Code Assist زمانی که مستقیماً از منبع دیگری مانند کد منبع باز موجود نقل قول می کند، اطلاعات نقل قول را ارائه می دهد. برای اطلاعات بیشتر، به نحوه و زمان استناد جمینی به منابع مراجعه کنید.

برای جلوگیری از پیشنهاد کدی که با منابع ذکر شده مطابقت دارد، موارد زیر را انجام دهید:

  1. در نوار فعالیت IDE خود، روی مدیریت > تنظیمات کلیک کنید.

  2. در برگه کاربر پنجره تنظیمات، به Extensions > Gemini Code Assist بروید.

  3. پیمایش کنید تا Duet AI > Recitation: Max Cited Length را پیدا کنید.

  4. مقدار را روی 0 قرار دهید.

    Gemini Code Assist دیگر کدی را به شما پیشنهاد نمی کند که با منابع ذکر شده مطابقت داشته باشد.

مسائل شناخته شده

این بخش به تشریح مسائل شناخته شده Gemini Code Assist می پردازد:

کد VS

  • پاسخ‌های گپ زمانی که شامل نسخه به‌روزرسانی‌شده یک فایل باز بزرگ باشد، ممکن است کوتاه شوند

    برای حل این مشکل، بخش کوچکتری از کد را انتخاب کنید و یک دستورالعمل اضافی را در اعلان چت قرار دهید، مانند only output the selected code.

  • Vim: نمی‌تواند پیشنهادهای تولید کد را بپذیرد یا رد کند مگر اینکه در حالت درج باشد

    هنگام استفاده از افزونه Vim در حالت عادی، نمی توانید پیشنهادات کد را بپذیرید یا رد کنید.

    برای حل این مشکل، i را فشار دهید تا وارد حالت درج شوید و سپس Tab را فشار دهید تا پیشنهاد را بپذیرید.

  • Vim: رفتار ناسازگار هنگام فشار دادن Esc برای رد پیشنهادها

    وقتی Esc را فشار می‌دهید، هر دو پیشنهاد IDE و Gemini Code Assist رد می‌شوند. این رفتار متفاوت از رفتار غیر Vim است که در آن فشار دادن Esc دوباره Gemini Code Assist را فعال می‌کند.

  • تلاش برای ورود به سیستم به پایان می رسد

    اگر تلاش‌های ورود به سیستم شما به پایان می‌رسد، سعی کنید تنظیم cloudcode.beta.forceOobLogin را به فایل settings.json خود اضافه کنید:

     "cloudcode.beta.forceOobLogin": true
    
  • هشدارهای تلاوت مجوز در تمام جلسات ادامه نمی‌یابد

    اگر اخطارهای تلاوت مجوز در تمام جلسات ادامه نداشت، به گزارش‌های مداوم مراجعه کنید:

    1. روی View > Output کلیک کنید.

    2. Gemini Code Assist - Citations را انتخاب کنید.

  • مشکلات اتصال در پنجره خروجی 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 برای IntelliJ و سایر IDE های JetBrains پشتیبانی شده وجود ندارد.

بازخورد بگذارید

برای ارائه بازخورد از تجربه خود، این مراحل را دنبال کنید:

کد VS

  1. در نوار وضعیت، روی spark Gemini Code Assist کلیک کنید و سپس در منوی Quick Pick ، Send feedback را انتخاب کنید.

  2. در فرم، فیلدهای عنوان و نظرات را پر کنید.

  3. اگر می خواهید سیاهههای Skaffold یا AI Companion خود را به اشتراک بگذارید، مطمئن شوید که گزینه Send Skaffold logs یا Send AI Companion logs را انتخاب کرده اید.

  4. روی ارسال بازخورد کلیک کنید.

IntelliJ

  1. در نوار وضعیت، روی spark Gemini Code Assist کلیک کنید و سپس در منو، ارسال بازخورد را انتخاب کنید.

  2. در قسمت متن بالای فرم، بازخورد خود را وارد کنید.

  3. اگر می‌خواهید گزارش‌های Gemini Code Assist خود را به اشتراک بگذارید، مطمئن شوید که فایل‌های گزارش را انتخاب کرده‌اید.

  4. روی ارسال بازخورد کلیک کنید.

بعدش چی