شروع کار با توسعه دهنده Amazon Q CLI

اگر این مطلب را می خوانید ، این احتمال وجود دارد که کنجکاوی شما با هیجان که توسعه دهنده Amazon Q CLI به صورت آنلاین تولید کرده است ، کمرنگ شده است. توسعه دهندگان نحوه استفاده از توسعه دهنده Amazon Q CLI را برای ایجاد اتوماسیون های شگفت انگیز ، ایجاد برنامه های جدید از Scratch ، Vibe Code Fun Games و موارد دیگر به اشتراک گذاشته اند (پایان این پست را برای انتخاب کوچکی از آن ها بررسی کنید). شما نیازی به داشتن یک حساب کاربری AWS ندارید تا بتوانید از توسعه دهنده Amazon Q CLI استفاده کنید، بنابراین همه می توانند در سرگرمی بپیوندند … بله همه!
در این پست می خواهم درباره آنچه که توسعه دهنده Amazon Q CLI است ، بیشتر صحبت کنم و سپس به شما در شروع کار کمک کنم. بیایید درست در آن شیرجه بزنیم.
توسعه دهنده Q Amazon Q چیست
چند بار برای استفاده از ترمینال یا پوسته خود؟ من به عنوان یک توسعه دهنده ، احتمالاً بیشتر وقت خود را در ترمینال می گذرانم وقتی که در IDE خود کد نمی نویسم. اگر شما یک توسعه دهنده نیستید ، شاید شما به عنوان یک sysadmin یا شاید یک مهندس DevOps کار کنید ، ممکن است تمام وقت خود را در ترمینال بگذرانید – نوشتن اسکریپت ها برای خودکار کردن مواد ، اجرای ابزارهای مختلف برای کمک به کار خود و کمک به رفع مشکلات در هنگام اشتباه. ترمینال بخش اساسی کار ما است و بنابراین ما باید اطمینان حاصل کنیم که همانطور که دوست دارم بگویم “خط فرمان اعتماد به نفس” داریم.
با این وجود ، با استفاده از ابزارهای زیادی که برای کمک به فعالیت های خود استفاده می کنیم ، آسان است که گاهی اوقات پارامترها و گزینه های خط فرمان را فراموش کنیم – به ویژه هنگامی که اینها برای پشتیبانی از نسخه های جدیدتر به روز می شوند. با توجه به اینکه هوش مصنوعی به طور فزاینده ای در ابزار توسعه دهنده یکپارچه و فعال می شود ، اگر بتوانیم برخی از این قابلیت ها را برای استفاده در خط فرمان داشته باشیم ، عالی نخواهد بود.
خوب خبر خوب این است که می توانید! تمام خوبی های شما در IDE با مواردی مانند افزونه Amazon Q Developer IDE ، اکنون می توانید در نوک انگشتان خود در ترمینال و خط فرمان خود داشته باشید. Amazon Q Developer CLI یک منبع باز (دارای مجوز دوگانه ، Apache 2.0 و MIT) است که می توانید بارگیری و نصب کنید و این قابلیت ها را فراهم می کند:
- فرمان خودکار کامل – اگر طرفدار نحوه عملکرد خودکار در IDE هستید ، Amazon Q Developer CLI از صدها ابزار محبوب CLI پشتیبانی می کند (به عنوان مثال git ، docker ، aws) و آن را به خط فرمان می آورد
- زبان طبیعی برای ترجمه فرمان – به شما کمک می کند تا قصد خود را به ابزارها و آرگومان های مناسب تبدیل کنید که می توانید در خط فرمان اجرا کنید – مناسب برای آن مواقعی که ممکن است تمام پارامترها و گزینه های مختلف خط فرمان را فراموش کنید ، اما می دانید چه کاری می خواهید انجام دهید
- گپ زبان طبیعی با اجرای عامل – به شما امکان می دهد با استفاده از زبان طبیعی با ترمینال خود در تعامل باشید (سؤال کنید ، مسائل اشکال زدایی را بپرسید ، پایگاه کد و غیره را کشف کنید) و سپس اقدام کنید (تولید کنید ، پرونده های ویرایش ، گردش کار GIT را خودکار کنید ، درگیری های ادغام و موارد دیگر را برطرف کنید) با اجازه خود
علاوه بر این ، اگر انگلیسی زبان اول شما نیست ، پس نگران نباشید زیرا می توانید با بسیاری از زبانها با توسعه دهنده Amazon Q CLI ارتباط برقرار کنید. همکار من جف بار حتی قادر به استفاده از آن با Quechua ، زبان بومی است که به زمان های قبل از کلمبیا باز می گردد (در اینجا بیشتر بخوانید). من آن را به زبان اسپانیایی امتحان کرده ام ، و همکارانم از سراسر جهان آن را به زبانهای محلی خود امتحان کرده اند و همه ما آن را انگشت شست می کنیم!
خوب ، امیدوارم که این برای شما خوب به نظر برسد. بیایید با قدم زدن در مراحل نصب و سپس نشان دادن نحوه شروع کار ، شروع به کار کنیم.
نصب
برای استفاده از Amazon Q Developer CLI همه شما نیاز به یک سیستم عامل پشتیبانی شده (MacOS ، Linux و Windows با استفاده از زیر سیستم ویندوز برای Linux ، WSL) ، یک ترمینال پشتیبانی شده (نگران نباشید ، مگر اینکه از چیزی متفاوت استفاده کنید ، احتمالاً از ترمینال پشتیبانی شده استفاده می کنید) و یک پوسته پشتیبانی شده (Zsh ، Bash و Fish).
نصب های حداقل و کامل – دو نوع نصب وجود دارد: یک نصب حداقل که چت CLI Developer Amazon Q و ویژگی های خودکار را نصب می کند ، و سپس یک نصب کامل که اضافی ابزار پیکربندی GUI را نصب می کند. هرچند بیش از حد نگران نباشید ، نکته اصلی این است که هر دو نوع نصب به شما کمک می کند تا Amazon Q Developer CLI را در محیط خود قرار داده و در محیط خود اجرا کنید.
فرآیند نصب باینری ها را برای پلتفرم شما نصب می کند ، ادغام را با ترمینال (یا پوسته) پیکربندی می کند و سپس به شما کمک می کند تا وارد شوید. من چند راهنما را برای کمک به نصب در کنار هم قرار داده ام. در مرحله اول راهنمای ضروری برای نصب Amazon Q Developer CLI در لینوکس برای کسانی که از لینوکس استفاده می کنند ، و سپس برای کاربران ویندوز راهنمای ضروری برای نصب Amazon Q Developer CLI را در ویندوز قرار داده ام. برای کاربران MACOS ، آنها ساده ترین نصب را که می توانید در اینجا پیدا کنید ، با بارگیری مستقیم یا استفاده از Brew برای نصب آن دارند.
AWS Community Builder Ravindra Singh همچنین یک راهنمای نصب MAC را در کنار هم قرار داده است ، Amazon Q AI Assance را در MAC نصب و استفاده کنید
پس از نصب ، شما نیاز به ورود به سیستم دارید. دو نوع حساب وجود دارد که می توانید با آنها وارد شوید: Builder ID و حساب های مرکز هویت. برای شروع رایگان ، می توانیم از ورود به سیستم سازنده استفاده کنیم. اگر قبلاً از این استفاده نکرده اید ، بسیار ساده است. به صفحه شناسه سازنده دسترسی پیدا کنید ، و می توانید با استفاده از آدرس ایمیل خود ، شناسه سازنده رایگان خود را ثبت کنید. نیازی به داشتن حساب AWS نیستبشر
در اینجا یک فیلم کوتاه از آنچه به نظر می رسد وجود دارد:
https://www.youtube.com/watch؟v=wuinq2urmow
پس از نصب آن ، خوب هستید که بروید و اکنون تعدادی دستورات جدید را از درون ترمینال خود در دسترس خواهید داشت. بیایید نگاهی به این موارد و چگونگی شروع کار بیندازیم.
شروع
اکنون که شما Amazon Q Developer CLI را نصب کرده اید ، تمام کاری که برای دسترسی به آن باید انجام دهیم ، باز کردن یک ترمینال است. ترمینال شما یک پوسته را باز می کند و به عنوان بخشی از نصب ، آن پوسته به طور خودکار Qterm را شروع می کند. بیایید برخی از موارد را طی کنیم تا شما را از بین ببرد و اجرا شود.
تکمیل فرمان
اولین چیزی که ما می خواهیم به آن توجه کنیم این است که چگونه فرمان تکمیل کار می کند. هنگامی که یک دستور را از ترمینال تایپ می کنید ، متوجه خواهید شد که اکنون یک یاور وجود دارد که پیشنهادهایی در مورد گزینه های فرمان می خواهید استفاده کنید.
برای گزینه های مختلف می توانید با استفاده از کلیدهای پیکان بالا و پایین حرکت کنید ، یا می توانید تایپ کنید و گزینه ها هنگام تایپ تغییر می کنند. اگر می خواهید این گزینه ها متوقف شوند یا از بین بروند ، می توانید ESC را فشار دهید و آن را لغو می کند.
این فیلم کوتاه از این را در عمل مشاهده کنید.
ترجمه دستورات
مورد بعدی که ما می خواهیم انجام دهیم استفاده از توسعه دهنده Q Amazon Q برای ترجمه قصد خود به یک دستور خاص است. بیایید بگوییم به عنوان مثال می خواستیم یک دستور را اجرا کنیم اما نمی توانیم تمام پارامترها و گزینه های خط فرمان مورد نیاز خود را به خاطر بسپاریم. این برای من همیشه اتفاق می افتد. به عنوان مثال ، اجازه دهید بگوییم که من می خواستم تمام پرونده های موجود در فهرست محلی خود را که شامل جهان “Amazon-Q” است ، پیدا کنم.
از یک ترمینال می توانم تایپ کنم:
q translate "find all the files in my current directory and all subdirectories that contain the word amazon-q but exclude hidden files and directories"
و بعد از یک لحظه کوتاه ، این همان چیزی است که من می گیرم
q translate "find all the files in my current directory and all subdirectories that contain the word amazon-q but exclude hidden files and directories"
Shell · find . -type f -name "*amazon-q*" -not -path "*/.*" -not -path "./.*"
❯ ⚡ Execute command
📝 Edit command
🔄 Regenerate answer
❓ Ask another question
❌ Cancel
اکنون می توانم از کلیدهای فلش برای انتخاب گزینه استفاده کنم. گزینه پیش فرض اجرای دستور هنگام فشار دادن Enter است. من همچنین می توانم دستور را ویرایش کنم اگر می خواستم ، اگر فکر می کنم اشتباه کرده است ، این مسئله را نادیده گرفته و یک سؤال متفاوت را مطرح کنید (در چه نقطه ای سریعاً به من ارائه می دهد) یا فقط لغو و از این امر استفاده می کنم.
من هنگام کار با تمام ابزارهای خط فرمان که روز در روز خارج می کنید ، از این توانایی زیاد و فوق العاده مفید آن استفاده می کنم ،
گپ
من بهترین ویژگی را برای آخرین بار ذخیره کرده ام. شما می توانید از Amazon Q Developer CLI در حالت گپ استفاده کنید و در مکالمات زبان طبیعی شرکت کنید ، سؤال کنید و از Amazon Q در محیط ترمینال خود پاسخ دهید. برای شروع ، از ترمینال به سادگی تایپ کنید:
q chat
که یک جلسه چت جدید را باز می کند:
Hi, I'm Amazon Q. Ask me anything.
Things to try
• Fix the build failures in this project.
• List my s3 buckets in us-west-2.
• Write unit tests for my application.
• Help me understand my git status
/acceptall Toggles acceptance prompting for the session.
/profile (Beta) Manage profiles for the chat session
/context (Beta) Manage context files for a profile
/help Show the help dialogue
/quit Quit the application
>
همچنین می توانید با استفاده از قالب ، یک جلسه گپ را با برخی از متن ها فراخوانی کنید:
q chat "Can you tell me which is the largest file in my directory"
که جلسه چت را باز می کند و بلافاصله روی سؤالی که از آن پرسیدید شروع به کار کنید.
Hi, I'm Amazon Q. Ask me anything.
Things to try
• Fix the build failures in this project.
• List my s3 buckets in us-west-2.
• Write unit tests for my application.
• Help me understand my git status
/acceptall Toggles acceptance prompting for the session.
/profile (Beta) Manage profiles for the chat session
/context (Beta) Manage context files for a profile
/help Show the help dialogue
/quit Quit the application
> Can you tell me which is the largest file in my directory
I'll help you find the largest file in your current directory. Let me run a command to check that for you.
Execute shell command
▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔
I will run the following shell command:
find . -type f -maxdepth 1 -exec du -h {} \; | sort -hr | head -n 10
Enter y to run this tool, otherwise continue chatting.
این منتظر خواهد بود تا قبل از تکمیل درخواست ، با “y” پاسخ دهید.
Executing `find . -type f -maxdepth 1 -exec du -h {} \; | sort -hr | head -n 10`...
▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔▔
21M ./q-x86_64-linux-musl.zip
580K ./.zsh_history
120K ./.zcompdump-bcd074a65b1c-5.9.zwc
52K ./.zcompdump-bcd074a65b1c-5.9
52K ./.zcompdump
24K ./.DS_Store
20K ./.viminfo
12K ./.aider.chat.history.md
8.0K ./aws.prg-vice.log
8.0K ./.zshrc
🟢 Completed in 0.207s
Based on the results, the largest file in your current directory (/Users/ricsue) is:
q-x86_64-linux-musl.zip at 21MB
The next largest files are:
• .zsh_history (580KB)
• .zcompdump-bcd074a65b1c-5.9.zwc (120KB)
• .zcompdump-bcd074a65b1c-5.9 (52KB)
• .zcompdump (52KB)
درخواست اجازه
هنگام انجام عملیات با استفاده از ابزارها ، Amazon Q به طور کلی از شما خواسته می شود تأیید کنید که می خواهید به آن اجازه دهید این اقدامات را انجام دهد. Amazon Q به دنبال اجازه برای دستورات Readonly زیر نیست: LS ، CAT ، ECHO ، PWD ، که ، سر و دم. شما می توانید از “/پذیرش” برای پذیرش خودکار تمام درخواست ها استفاده کنید ، اما لطفاً از این کار با احتیاط استفاده کنید و همیشه بر آنچه اتفاق می افتد نظارت کنید.
دستورات موجود
در هر زمان می توانید از “https://dev.to/help” استفاده کنید تا لیستی از دستورات موجود را بدست آورید.
زمینه
همانطور که با ابزارهایی مانند Amazon Q Developer CLI کار می کنید ، مهم است که نحوه پیکربندی زمینه را برای ارائه پاسخ های مناسب تر و آگاه تر درک کنید. پیش فرض این است که Amazon Q For Line اطلاعات متنی را از محیط توسعه محلی شما ادغام می کند ، یعنی دایرکتوری که در حال حاضر در آن هستید.
ایجاد اسناد در قالب Markdown یک روش مناسب برای کمک به هدایت خروجی است. به عنوان مثال ، من به طور معمول ترجیحات برنامه نویسی خودم را در یک DOC در یک فهرست به نام “Spec” در فهرست کار من قرار داده ام که زمینه دیگری را برای توسعه دهنده Q Amazon Q CLI فراهم می کند. این منابع و فاکتورهای موجود در بازده ایجاد شده را مرور می کند.
برای تنظیم دقیق آن زمینه می توانید پرونده ها و منابع خاص را در یک جلسه “چت Q” اضافه کنید. اگر ما دستور “/Context Show” را برای ما قرار دهید ، جزئیات مربوط به نحوه استفاده از پرونده های خاص را برای کمک به پیشنهادات آن در اختیار شما قرار می دهد.
> /context show
current profile: default
global:
.amazonq/rules/**/*.md
README.md
AmazonQ.md
profile:
>
می توانید پرونده های دیگری را که می خواهید به متن اضافه کنید اضافه کنید ، که اگر یک روش استاندارد برای کار دارید بسیار مفید است و می خواهید این موارد را در آن اسناد مارک تعریف کنید.
شما می توانید با استفاده از دستور “/نمایه” پروفایل های مختلفی ایجاد کنید که به شما امکان می دهد زمینه های مختلف را پیکربندی کنید و بر اساس نیازهای خود انعطاف پذیری را در اختیار شما قرار می دهد.
هرچه پروژه های شما بزرگتر می شوند و موارد استفاده پیچیده تر می شوند ، قادر به تنظیم متن خوب به شما در دستیابی به تولید بهتر کمک می کند.
اجرای دستورات
هنگامی که در یک جلسه “Q Chat” قرار دارید ، می توانید با استفاده از “!” دستورات را بدون ترک اجرا کنید. پیشوند به عنوان مثال ، من می توانم استفاده کنم:
\> ! echo "Q is cool"
و این دستور اجرا خواهد شد (و شما باید خروجی را از اجرای ابزار مشاهده کنید). این برای دانستن مفید است.
خروجی
برای ترک جلسه گپ ، “/q” را وارد می کنید و این شما را به پوسته باز می گرداند.
نسخه ی نمایشی پیاده روی
در اینجا یک ویدیوی سریع از همکار من دونی پراکوسو وجود دارد که شما را از طریق این ویژگی ها طی می کند
https://www.youtube.com/watch؟v=a4ygk_upjyk
الهام گرفتن
اگر به دنبال الهام هستید ، پس جامعه توسعه دهنده AWS ، همکاران من و خودم برخی از مطالب را از قبل جمع کرده ایم تا ایده ای از آنچه می توانید به دست آورید ، ارائه دهیم. در اینجا یک انتخاب کوچک وجود دارد:
اینها باید یک نقطه شروع عالی به شما بدهند ، اما به نظر می رسد که هر روز من می شنوم که روشهای جدیدی را می شنوم که توسعه دهندگان قادر به استفاده از توسعه دهنده Q Amazon Q برای انجام کارهای شگفت انگیز هستند.
با توسعه دهنده A Amazon Q شروع کنید
Amazon Q توسعه دهنده CLI که توسط Claude Sonnet 3.7 ساخته شده است فقط یک دستیار نیست – فکر می کند ، می نویسد ، می نویسد ، به روزرسانی ها ، اعمال و از همه مهمتر ، قبل از انجام هرگونه اصلاح. امیدوارم این پست وبلاگ به شما الهام بخش باشد که می خواهید Amazon Q Developer CLI را برای خودتان امتحان کنید.
می توانید با ثبت نام در شناسه سازنده و سپس بارگیری برنامه از اینجا ، آن را به صورت رایگان امتحان کنید.
من برای بهترین محتوایی که در این مورد ایجاد شده است ، برخی از سکه های Developer Amazon Q Developer را دارم ، بنابراین اگر چیزی را ایجاد کردید و چه کسی می داند ، در تماس باشید و یکی از این سکه ها می تواند راه شما را هدایت کند!
تا دفعه بعد مردمی!
ساخته شده با 🧡 توسط Devrel!