برنامه نویس جفت AI در Github – Amazon Q Developer در GitHub (در پیش نمایش)

کد با سرعت Q و هرگز دوباره به تنهایی کد نکنید

مقدمه

توسعه دهنده A Amazon Q در Github (در پیش نمایش) ، دیروز به تازگی راه اندازی شد و من بلافاصله آن را برای کار کردن ابزار مبدل متوسط ​​من به dev.to کار کردم. این پست وبلاگ تجربه من را با استفاده از ادغام جدید GitHub برای ساخت و بهبود یک پروژه از طریق توسعه AI-Allian به اشتراک می گذارد.

با تکیه بر موفقیت قبلی با توسعه دهنده Q Amazon Q CLI

پست وبلاگ قبلی من توضیح می دهد که چگونه من پروژه خود را با استفاده از توسعه دهنده Amazon Q CLI شروع کردم تا یک ابزار خط فرمان ایجاد کنم که پست های وبلاگ متوسط ​​را به فرمت مارک سازگار با Dev.to تبدیل می کند. فرآیند توسعه اولیه صاف بود ، با توسعه دهنده Amazon Q CLI به من کمک کرد تا عملکرد اصلی را تولید کنم:

1. مقالات متوسط ​​را با استفاده از خراش وب واگذار کنید
2. تبدیل محتوای HTML به قالب Markdown
3. حفظ قالب بندی و ساختار
4. اضافه کردن dev.to frontmatter
5. اجرای انتشار مستقیم به dev.to در حالت پیش نویس

در عرض چند دقیقه ، من یک نمونه اولیه کار داشتم که می تواند مقالات متوسط ​​را به قالب dev.to تبدیل کند.

کشف مسائل

بعد از انتشار پروژه خود به GitHub ، متوجه برخی از مواردی شدم که نیاز به پرداختن به آنها داشتند:

1. هدرها در علامت تبدیل شده از دست رفته بودند
2. برخی از عناصر UI خاص متوسط ​​هنوز در خروجی ظاهر می شدند
3. کد با نظرات پایتون (#) به درستی استخراج نمی شد

من به جای بازگشت به توسعه دهنده Q Amazon Q CLI ، تصمیم گرفتم توسعه دهنده جدید Amazon Q را در GitHub (پیش نمایش) امتحان کنم تا به این مسائل بپردازم و برنامه نویسی جفت AI را با GitHub آزمایش کنم.

تجربه توسعه دهنده A Amazon Q در GitHub

ادغام GitHub از توسعه دهنده A Amazon Q (در حال حاضر در پیش نمایش) به من این امکان را داد که بدون نیاز به استفاده از CLI ، مستقیماً در این مرورگر کار کنم. در اینجا نحوه کار این روند آمده است.

نصب

اولین مورد مورد نیاز نصب برنامه Amazon Q Developer در GitHub بود ، تا بتوانم بلافاصله بدون اتصال به حساب AWS خود و شروع کار ، بلافاصله استفاده کنم. برای شروع استفاده از عامل در GitHub نیازی به حساب AWS ندارد.

در مرحله بعد ، شما با انتخابی برای اضافه کردن آن به تمام مخازن خود یا انتخاب موارد خاص ، به شما انتخاب می شود. در این حالت ، من می خواهم آن را به repo Medium2Dev خود اضافه کنم ، بنابراین فقط مخازن منتخب را انتخاب می کنم و نام آن را تایپ می کنم تا آن را پیدا کنم.

برنامه ها را در GitHub پیکربندی کنید

از آنجا که رایگان است ، بهترین قسمت این است که به AWS Builder ID یا مرکز هویت IAM شما متصل نیست. شما برای تهیه ویژگی ها و قابلیت های بررسی کد ، و همچنین تعداد مشخص شده خطوط برای تبدیل کد در هر ماه ، در هر ماه دعوت های محدودی ارائه می دهید. با این حال ، شما می توانید با ثبت نام برنامه Developer Amazon Q با حساب AWS خود ، در هر زمان استفاده رایگان خود را افزایش دهید.

توسعه ویژگی

1. من در مخزن GitHub خود موضوعاتی ایجاد کردم که جزئیات مشکلات را نشان می دهد:
2. توسعه دهنده Amazon Q ، موضوعات و تغییرات کد پیشنهادی را تجزیه و تحلیل کرد
3. من تغییرات در برگه “پرونده ها را تغییر داده” مرور کردم
4. برای هر پیشنهاد ، من می توانم نظرات ، درخواست تغییر یا تأیید را ترک کنم

من با موفقیت سه درخواست کشش را با استفاده از این گردش کار بسته کردم و به همه موضوعات شناسایی شده با پروژه خود رسیدگی کردم.

در اینجا تصاویر مرحله به مرحله از گردش کار توسعه ویژگی من آورده شده است.

ایجاد مسئله ای که مشکل را توصیف می کند.

استفاده از برچسب نماینده توسعه Amazon Q

پاسخ از نماینده با درخواست کشش تولید شده و پیوند آماده برای بررسی.

تأیید تغییرات و کد بررسی.

بررسی کد

سپس من از توسعه دهنده A Amazon Q خواستم تا با استفاده از جریان بررسی کد عادی در رابط GitHub ، مجدداً تکرار و تغییرات ایجاد کند. در این حالت ، نظر زیر را اضافه کردم و سپس شروع به بررسی می کنم که سپس تغییر در بررسی را صف می کند.

سپس بررسی خود را انتخاب کنید و تغییرات را درخواست کنید.

من متوجه شدم که نماینده توسعه دهنده Amazon Q تغییرات را از نظرات بررسی کد انتخاب می کند ، و نه از نظرات در بررسی خود را تمام کنید صفحه (که گاهی گیج کننده است)

بعد ، نشان دادن تمام تعهدات در هنگام بررسی کد.

سرانجام درخواست کشش را ادغام کرده و مسئله را ببندید.

مزایای توسعه دهنده A Amazon Q در GitHub

ادغام GitHub چندین مزیت ارائه داد:

1. گردش کار بدون درز: من می توانم بدون تغییر به CLI در رابط Github بمانم
2. درک متنی: توسعه دهنده Amazon Q ساختار پروژه من را درک کرد و می تواند تغییرات هدفمند را پیشنهاد کند
3. رویکرد مشترک: روند بررسی مانند کار با یک برنامه نویس جفت با استفاده از جریان GitHub آشنا احساس می شود.
4. تکرارهای سریع: هنگامی که من درخواست تغییرات کردم ، توسعه دهنده Amazon Q به سرعت راه حل های اصلاح شده را پیشنهاد داد
5. حساب رایگان بدون AWS: یکی از قانع کننده ترین جنبه های توسعه دهنده Amazon Q در GitHub این است که بدون نیاز به یک حساب کاربری AWS ، استفاده از آن در دسترس است ، و این باعث می شود بدون توجه به ترجیحات ارائه دهنده ابر خود ، آن را برای همه توسعه دهندگان در دسترس قرار دهد.

محدودیت های فعلی در نسخه پیش نمایش

در حالی که این تجربه به طور کلی مثبت بود ، من با نسخه پیش نمایش چند محدودیت مشاهده کردم:

• محدودیت های گردش کار : برای هر شماره ، این فرایند نیاز به پیمایش به برگه “پرونده ها تغییر یافته” ، ترک نظرات ، انتخاب “شروع بررسی” و سپس “درخواست تغییر” برای دریافت پیشنهادات اصلاح شده
• آگاهی از زمینه محدود : در حال حاضر ، به نظر نمی رسد توسعه دهنده A Amazon Q در GitHub به URL ها یا سایر پیوندهای روابط عمومی ذکر شده در اعلان ها متصل شود
• مدل تکرار : گردش کار ایده آل باعث می شود که بر اساس نظرات تکراری مستقیماً در خود درخواست ، پیشرفت هایی را انجام دهد (علاوه بر این اظهار نظر در بررسی کد به روش معمولی)
• رسیدگی چند نظر : نماینده گاهی اوقات با پردازش چندین نقطه بازخورد بررسی کد در یک درخواست کشش واحد در “پرونده ها تغییر یافته” تلاش می کند ، و به توسعه دهندگان نیاز دارد تا به جای پرداختن به همه نظرات در یک ، مسائل جداگانه ای را برای هر پالایش ایجاد کنند.
• دقت تحول: هنگام استفاده از برچسب Amazon Q Transform Agent در قابلیت های مربوط به شماره به PR ، عامل با وجود دستورالعمل های صریح برای تبدیل به Node.js ، کد را به جاوا 17 تبدیل کرد ، و این نشانگر پیشرفت های احتمالی مورد نیاز با جمله های اضافی یا هشدار دادن آن فقط از Java 17 است.

Amazon Q Agent Agent

عامل تبدیل

توجه داشته باشید که برای استفاده از عامل تبدیل (که فقط برای جاوا 17 در نسخه پیش نمایش است) باید اقدامات GitHub را برای مخزن فعال کنید و حداقل به یک دونده آنلاین نیاز دارید. مدت زمان لازم برای انجام مهاجرت بستگی به اندازه و پیچیدگی کاربرد شما دارد. نماینده کد نمونه را برای ایجاد گردش کار فراهم می کند و اگر این تنظیمات را از قبل ندارید ، باید برچسب Amazon Q Transfice را دوباره حذف و دوباره حذف کنید.

name: Q Code Transformation  

on:  
  push:  
    branches:  
      - 'Q-TRANSFORM-issue-*'  

jobs:  
  q-code-transformation:  
    runs-on: ubuntu-latest  
    steps:  
      - uses: actions/checkout@v3  
      - uses: actions/setup-java@v3  
        with:  
          java-version: '17'  
          distribution: 'adopt'  

      - name: Build and copy dependencies  
        run: |  
          mvn ${{ env.MAVEN_CLI_OPTS }} verify  
          mvn ${{ env.MAVEN_CLI_OPTS }} dependency:copy-dependencies -DoutputDirectory=dependencies -Dmdep.useRepositoryLayout=true -Dmdep.copyPom=true -Dmdep.addParentPoms=true  

      - name: Upload artifacts  
        uses: actions/upload-artifact@v4  
        with:  
          name: q-code-transformation-dependencies  
          path: dependencies

منتظر

از آنجا که توسعه دهنده A Amazon Q در GitHub از پیش نمایش به دسترسی عمومی منتقل می شود ، امیدوارم که برخی از محدودیت هایی که ارسال کردم مورد توجه قرار گیرد. توانایی مراجعه به URL ها و سایر پیوندهای روابط عمومی باعث افزایش چشمگیر زمینه در دسترس برای توسعه دهنده Q Amazon می شود و پیشنهادات آن را حتی بیشتر مرتبط می کند.

پایان

ترکیبی از Amazon Q CLI برای ایجاد پروژه اولیه و توسعه دهنده Amazon Q در GitHub برای پیشرفت های مداوم ، یک گردش کار قدرتمند است. CLI در داربست Rapid Project عالی بود ، در حالی که ادغام GitHub روند بهبود تکراری را حتی در هنگام عدم داشتن رایانه من با من ساده تر کرد ، زیرا این امکان را برای انجام توسعه و برنامه ریزی جفت کردن فقط با استفاده از مرورگر فراهم کرد.

برای توسعه دهندگان که به دنبال افزایش بهره وری هستند ، توسعه دهنده Amazon Q در GitHub Preview یک نگاه اجمالی به آینده ای ارائه می دهد که در آن کمک هوش مصنوعی عمیقاً در گردش کار توسعه ادغام شده است. از آنجا که این سرویس محدودیت های فعلی را بالغ می کند و به آن می پردازد ، این پتانسیل را دارد که نحوه همکاری ما در کد را تغییر دهیم.

اگر علاقه مند به تلاش برای توسعه دهنده Amazon Q در Github هستید که در حال حاضر در پیش نمایش موجود است ، همچنین اعلامیه رسمی را بررسی کنید.