تسریع توسعه با Gemini CLI

۱. مرور کلی

این آزمایشگاه بر استفاده از Gemini CLI، یک عامل متن‌باز مبتنی بر هوش مصنوعی در Google Cloud، تمرکز دارد. شما یاد خواهید گرفت که از Gemini CLI برای کارهای مختلف، از جمله درک پایگاه‌های کد موجود، تولید مستندات و تست‌های واحد، و بازسازی اجزای رابط کاربری و بک‌اند یک برنامه وب پایتون استفاده کنید.

آنچه یاد خواهید گرفت

در این آزمایشگاه، شما یاد خواهید گرفت که چگونه موارد زیر را انجام دهید:

  • نحوه استفاده از رابط خط فرمان Gemini برای وظایف رایج توسعه‌دهندگان.

پیش‌نیازها

  • این آزمایشگاه آشنایی با محیط‌های Cloud Console و Cloud Shell را پیش‌فرض قرار می‌دهد.

۲. تنظیمات و الزامات

راه‌اندازی پروژه ابری

  1. وارد کنسول گوگل کلود شوید و یک پروژه جدید ایجاد کنید یا از یک پروژه موجود دوباره استفاده کنید. اگر از قبل حساب جیمیل یا گوگل ورک اسپیس ندارید، باید یکی ایجاد کنید .

fbef9caa1602edd0.png

a99b7ace416376c4.png

5e3ff691252acf41.png

  • نام پروژه، نام نمایشی برای شرکت‌کنندگان این پروژه است. این یک رشته کاراکتری است که توسط APIهای گوگل استفاده نمی‌شود. شما همیشه می‌توانید آن را به‌روزرسانی کنید.
  • شناسه پروژه در تمام پروژه‌های گوگل کلود منحصر به فرد است و تغییرناپذیر است (پس از تنظیم، قابل تغییر نیست). کنسول کلود به طور خودکار یک رشته منحصر به فرد تولید می‌کند؛ معمولاً برای شما مهم نیست که چه باشد. در اکثر آزمایشگاه‌های کد، باید شناسه پروژه خود را (که معمولاً با عنوان PROJECT_ID شناخته می‌شود) ارجاع دهید. اگر شناسه تولید شده را دوست ندارید، می‌توانید یک شناسه تصادفی دیگر ایجاد کنید. به عنوان یک جایگزین، می‌توانید شناسه خودتان را امتحان کنید و ببینید که آیا در دسترس است یا خیر. پس از این مرحله قابل تغییر نیست و در طول پروژه باقی می‌ماند.
  • برای اطلاع شما، یک مقدار سوم، شماره پروژه ، وجود دارد که برخی از APIها از آن استفاده می‌کنند. برای کسب اطلاعات بیشتر در مورد هر سه این مقادیر، به مستندات مراجعه کنید.
  1. در مرحله بعد، برای استفاده از منابع/API های ابری، باید پرداخت صورتحساب را در کنسول ابری فعال کنید . اجرای این آزمایشگاه کد هزینه زیادی نخواهد داشت، اگر اصلاً هزینه‌ای داشته باشد. برای خاموش کردن منابع به منظور جلوگیری از پرداخت صورتحساب پس از این آموزش، می‌توانید منابعی را که ایجاد کرده‌اید یا پروژه را حذف کنید. کاربران جدید Google Cloud واجد شرایط برنامه آزمایشی رایگان ۳۰۰ دلاری هستند.

تنظیمات محیط

چت جمینی را باز کنید.

bc3c899ac8bcf488.png

یا در نوار جستجو عبارت «از جمینی بپرسید» را تایپ کنید.

e1e9ad314691368a.png

فعال کردن Gemini برای Google Cloud API:

636114fa6e5f0abf.png

در صفحه بعد، GCA را فعال کنید.

8e234b2e282c4413.png

روی « Start chatting » کلیک کنید و یکی از نمونه سوالات را دنبال کنید یا سوال خودتان را تایپ کنید تا آن را امتحان کنید.

ed120d672468b412.png

نکاتی برای امتحان کردن:

  • Cloud Run را در 5 نکته کلیدی توضیح دهید.
  • شما مدیر محصول Google Cloud Run هستید، Cloud Run را در 5 نکته کلیدی کوتاه برای یک دانشجو توضیح دهید.
  • شما مدیر محصول Google Cloud Run هستید، Cloud Run را برای یک توسعه‌دهنده‌ی مجاز Kubernetes در 5 نکته‌ی کلیدی کوتاه توضیح دهید.
  • شما مدیر محصول Google Cloud Run هستید، در 5 نکته کلیدی کوتاه، توضیح دهید که چه زمانی از Cloud Run در مقابل GKE استفاده می‌کنید.

بعد از اتمام کار، پنجره چت Gemini Cloud Assist را ببندید.

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

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

تعهد گوگل به حفظ حریم خصوصی

گوگل یکی از اولین شرکت‌هایی بود که در این صنعت، تعهدنامه‌ای در مورد حریم خصوصی هوش مصنوعی/یادگیری ماشین منتشر کرد که در آن، باور ما مبنی بر اینکه مشتریان باید بالاترین سطح امنیت و کنترل را بر داده‌های ذخیره شده در فضای ابری خود داشته باشند، تشریح شده است.

داده‌هایی که ارسال و دریافت می‌کنید

سوالاتی که از Gemini می‌پرسید، شامل هرگونه اطلاعات ورودی یا کدی که برای تجزیه و تحلیل یا تکمیل به Gemini ارسال می‌کنید، prompt نامیده می‌شوند. پاسخ‌ها یا تکمیل کدی که از Gemini دریافت می‌کنید، response نامیده می‌شوند. Gemini از promptهای شما یا پاسخ‌های خود به عنوان داده برای آموزش مدل‌های خود استفاده نمی‌کند .

رمزگذاری پیام‌های تبلیغاتی

وقتی درخواست‌هایی را به Gemini ارسال می‌کنید، داده‌های شما در حین انتقال به عنوان ورودی به مدل اصلی در Gemini رمزگذاری می‌شوند .

داده‌های برنامه تولید شده از Gemini

جمینی (Gemini) بر اساس کد گوگل کلود (Google Cloud) شخص ثالث و همچنین کد منتخب شخص ثالث آموزش دیده است. شما مسئول امنیت، آزمایش و اثربخشی کد خود ، از جمله هرگونه تکمیل، تولید یا تجزیه و تحلیل کدی که جمینی به شما ارائه می‌دهد، هستید.

بیشتر بدانید که گوگل چگونه درخواست‌های شما را مدیریت می‌کند.

۳. گزینه‌هایی برای آزمایش دستورالعمل‌ها

اگر می‌خواهید اعلان‌های موجود را تغییر دهید، گزینه‌های مختلفی برای آن دارید.

استودیوی هوش مصنوعی ورتکس (Vertex AI Studio) بخشی از پلتفرم هوش مصنوعی ورتکس گوگل کلود (Google Cloud) است که به‌طور خاص برای ساده‌سازی و تسریع توسعه و استفاده از مدل‌های هوش مصنوعی مولد (Generative AI) طراحی شده است.

گوگل هوش مصنوعی استودیو (Google AI Studio) ابزاری مبتنی بر وب برای نمونه‌سازی اولیه و آزمایش با مهندسی سریع و رابط برنامه‌نویسی کاربردی (API) جمینی (Gemini) است.

برنامه وب گوگل جمینی (gemini.google.com) ابزاری مبتنی بر وب است که برای کمک به شما در کشف و استفاده از قدرت مدل‌های هوش مصنوعی گوگل جمینی طراحی شده است.

۴. برنامه را دانلود و بررسی کنید

با کلیک روی آیکون سمت راست نوار جستجو، Cloud Shell را فعال کنید.

3e0c761ca41f315e.png

اگر از شما خواسته شد که مجوز دهید، برای ادامه روی «مجوز» کلیک کنید.

6356559df3eccdda.png

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

git clone https://github.com/gitrey/calendar-app-lab
cd calendar-app-lab

«ویرایشگر پوسته ابری» را اجرا کنید.

18ca8f879206a382.png

پوشه‌ی « calendar-app-lab » را باز کنید.

7cef847802b51038.png

یک ترمینال جدید در ویرایشگر Cloud Shell باز کنید.

3336bea9c0e999b9.png

محیط شما باید مشابه تصویر زیر باشد.

ae9475871b7d28a6.png

۵. مقدمه‌ی رابط خط فرمان Gemini

Gemini CLI یک عامل هوش مصنوعی متن‌باز است که با مدل‌های Gemini گوگل کلود ادغام می‌شود. این رابط به توسعه‌دهندگان اجازه می‌دهد تا وظایف مختلفی را مستقیماً از ترمینال خود انجام دهند، مانند درک پایگاه‌های کد، تولید مستندات و تست‌های واحد و اصلاح کد. مزیت اصلی Gemini CLI توانایی آن در ساده‌سازی گردش‌های کاری توسعه با آوردن قدرت هوش مصنوعی مولد به طور مستقیم به محیط خط فرمان توسعه‌دهنده، کاهش تغییر زمینه و افزایش بهره‌وری است.

این مرحله، برای تنظیم متغیر محیطی، برای محیط Qwiklabs لازم نیست. به مرحله بعدی بروید.

در محیط محلی خود، اگر از مجوز Code Assist پولی سازمان خود استفاده می‌کنید، به یاد داشته باشید که Google Cloud Project را در ترمینال خود تنظیم کنید. جزئیات بیشتر .

export GOOGLE_CLOUD_PROJECT="YOUR_PROJECT_NAME"

بررسی کنید که در ریشه پوشه پروژه هستید:

cd ~/calendar-app-lab

اجرای Gemini CLI در پنجره ترمینال:

gemini

محیط شما باید مشابه تصویر زیر باشد.

اگر مراحل را در محیط محلی خود دنبال می‌کنید، می‌توانید ادغام با IDE خود را فعال کنید.

شما همیشه می‌توانید با اجرای /ide disable | enable ‎ این را تغییر دهید.

eaee08868abb4ccd.png

اگر آزمایشگاه را در محیط Qwiklabs اجرا می‌کنید، گزینه « Use Cloud Shell user credentials » را انتخاب کنید.

در غیر این صورت، با اجرای دستور زیر، رابط خط فرمان Gemini را تأیید کنید و « Login with Google » را انتخاب کنید:

/auth

پس از راه‌اندازی مجدد CLI، از شما خواسته می‌شود که با دنبال کردن لینک ارائه شده، برنامه را تأیید کنید.

390e8cbd9a32e8eb.png

لینک را باز کنید و مراحل ورود به سیستم را با اطلاعات دانشجویی Qwiklabs خود دنبال کنید. ۲۴c۱۶۷۱a۳c۱۴b۶۱d.png

کد تأیید را کپی کنید و برای تکمیل فرآیند با چسباندن کد، به ترمینال برگردید.

برای تأیید روش Auth خود، دستور زیر را اجرا کنید:

/about

f15a4036437b84d5.png

۶. درک کدبیس

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

برای کسب اطلاعات بیشتر در مورد کدبیس، دستور زیر را در رابط خط فرمان Gemini ارسال کنید:

Don't suggest any changes. Explain this codebase to me.

خروجی را بررسی کنید:

63b57c91fd0e90a8.png

۷. برنامه را به صورت محلی اجرا کنید

رابط خط فرمان Gemini می‌تواند با کمک به شما در تولید خودکار فایل‌های پیکربندی ضروری مانند requirements.txt یا یک Dockerfile اولیه، اجرای برنامه پایتون شما را به صورت محلی به طور قابل توجهی ساده کند. علاوه بر این، برای مدیریت وابستگی‌های پایتون و عیب‌یابی عالی است، زیرا می‌تواند به سرعت خطاهای ردیابی ناشی از بسته‌های از دست رفته یا تداخل نسخه‌ها را توضیح دهد و اغلب دستور دقیق pip install را برای رفع مشکل پیشنهاد می‌دهد.

برای اجرای برنامه به صورت محلی، دستور زیر را در ترمینال Gemini CLI وارد کنید:

Run this app locally

برای شروع برنامه، دستورالعمل‌ها را دنبال کنید:

d1fefa449b733c15.png

برای مشاهده پیش‌نمایش برنامه روی لینک کلیک کنید:

695fc8a1abab0aa7.png

خروجی نمونه:

e9f986d9088b4419.png

d2bb703195b4f99.png

۸. افزودن مستندات

رابط خط فرمان Gemini با امکان تولید فوری رشته‌های مستندات (docstraints) برای توابع یا کلاس‌ها، برای مستندسازی و کامنت‌گذاری مؤثر است. همچنین می‌توانید از آن برای اضافه کردن سریع کامنت‌های درون‌خطی توضیحی به بلوک‌های کد پیچیده یا ناآشنا استفاده کنید که به طور قابل توجهی وضوح و قابلیت نگهداری کدبیس را بهبود می‌بخشد.

برای افزودن توضیحات به هر فایل پایتون در برنامه، از ترمینال Gemini CLI استفاده کنید و دستور زیر را وارد کنید:

Add docstrings to all files

تغییرات پیشنهادی را تأیید کنید. اگر ادغام IDE فعال باشد، می‌توانید با استفاده از کنترل‌های رابط کاربری یا فشار دادن Enter در ترمینال، تغییرات را پذیرفته و ادامه دهید. همچنین می‌توانید حالت تأیید خودکار (YOLO) را با " ctrl+y " فعال کنید.

a41d76b77290cc10.png

فایل .gitignore را با اعلان زیر به‌روزرسانی کنید:

update .gitignore and add __pycache__ folder

به نمای Source Control بروید و تغییراتی را که تاکنون ایجاد کرده‌اید، مرور کنید:

2c41f8b842573384.png

۹. افزودن تست‌های واحد

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

با استفاده از اعلان زیر، برای تولید تست‌های واحد:

Generate unit tests for @calendar.py

پس از بررسی تغییرات، آنها را بپذیرید.

6b59d78b83152a22.png

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

ec1a4fbb2d340384.png

۱۰. بررسی اشکالات

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

برای بررسی هرگونه اشکال در منطق تبدیل، دستور زیر را در Gemini CLI ارسال کنید:

Are there any bugs in the conversion logic? Check if negative numbers are handled properly.

تغییرات پیشنهادی را بررسی کنید و آنها را در چت بپذیرید:

54ef65ded5462b34.png

۱۱. بازسازی رابط کاربری

رابط خط فرمان Gemini می‌تواند با کمک به شما در ترجمه الگوهای قدیمی‌تر رابط کاربری (مانند کامپوننت‌های کلاس) به الگوهای عملکردی جدیدتر و مدرن‌تر (مانند هوک‌ها در React) یا پیشنهاد بهبودهای ساختاری برای قابلیت نگهداری بهتر، به طور قابل توجهی در بازسازی رابط کاربری کمک کند. می‌توانید از آن برای تجزیه و تحلیل و بازسازی کد رابط کاربری موجود به کامپوننت‌های ماژولارتر و قابل استفاده مجدد استفاده کنید و از طراحی رابط کاربری تمیزتر و استانداردتر اطمینان حاصل کنید.

با ارسال دستور زیر به رابط خط فرمان Gemini، رابط کاربری را با استفاده از کتابخانه Bootstrap بازسازی کنید:

Refactor UI to use Bootstrap library

تغییرات را بررسی و بپذیرید:

16e6ca14e703127.png

برای شروع، برنامه را اجرا کنید. اگر از قبل در حال اجرا است، کافیست صفحه را مجدداً بارگذاری کنید.

python3 main.py

صفحه را دوباره بارگذاری کنید و تغییرات را بررسی کنید.

b52a709e902040e3.png

54664e527bcd9227.png

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

Implement error handling to display an error page when issues occur.

برای مشاهده به‌روزرسانی‌ها، لطفاً صفحه را رفرش کنید.

برای تأیید صفحه خطا، یک عدد منفی ارسال کنید.

82e16d4cf25933db.png

۱۲. بازسازی بک‌اند

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

بخش مدیریت را تغییر دهید تا درخواست‌های تبدیل در حافظه ذخیره شوند.

Store requests in memory and create a page to display conversion history. Add links on all pages to view the history.

تغییرات را در چت بررسی و قبول کنید:

19cfa20552fb3a01.png

چندین درخواست به برنامه ارسال کنید، سپس صفحه تاریخچه را مرور کنید.

ac5639d18b341b0a.png

تاریخچه درخواست‌های تبدیل را بررسی کنید.

9ca680e193510640.png

برای به‌روزرسانی فایل README.md با وضعیت فعلی کدبیس، این اعلان را از طریق Gemini CLI ارسال کنید:

analyze README.md file and update it with latest codebase state

خروجی را بررسی کنید. اگر ادغام Cloud Shell را فعال کرده‌اید، می‌توانید از کنترل رابط کاربری برای دسترسی به تغییرات استفاده کنید یا می‌توانید این کار را از ترمینال انجام دهید.

۱۳. ابزارهای داخلی Gemini CLI

رابط خط فرمان Gemini شامل ابزارهای داخلی است که مدل Gemini از آنها برای تعامل با محیط محلی شما، دسترسی به اطلاعات و انجام اقدامات استفاده می‌کند. این ابزارها قابلیت‌های CLI را افزایش می‌دهند و آن را قادر می‌سازند تا فراتر از تولید متن عمل کند و به طیف گسترده‌ای از وظایف کمک کند.

برای مشاهده ابزارهای موجود، این دستور را در Gemini CLI ارسال کنید:

/tools

خروجی را بررسی کنید.

e5ef2d9b81f6c10.png

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

۱۴. دستور آغازین Repo در Gemini CLI

رابط خط فرمان (CLI) نرم‌افزار Gemini شامل دستوری برای تجزیه و تحلیل پروژه و ایجاد یک فایل GEMINI.md سفارشی است.

برای تولید فایل GEMINI.md ، با استفاده از رابط خط فرمان Gemini، دستور زیر را ارسال کنید:

/init

خروجی را بررسی کنید. این دستور یک فایل GEMINI.md ایجاد می‌کند که خلاصه‌ای از هدف پروژه، فناوری‌ها، دستورالعمل‌های ساخت/اجرا و قراردادهای توسعه برای زمینه‌های آینده را ارائه می‌دهد.

برای درک اینکه چه دستورالعمل‌ها یا زمینه‌هایی را باید در فایل GEMINI.md پروژه خود بگنجانید، یک نقطه شروع خوب، بررسی فایل GEMINI.md موجود در مخزن gemini-cli است.

۱۵. دستورات سفارشی Gemini CLI

شما می‌توانید با استفاده از دستورات سفارشی در Gemini CLI، گردش کار توسعه خود را ساده کرده و ثبات را حفظ کنید. این دستورات به عنوان میانبرهای شخصی برای دستورات پرکاربرد شما عمل می‌کنند. شما می‌توانید دستوراتی را ایجاد کنید که مختص یک پروژه واحد باشند یا آنها را به صورت جهانی در تمام پروژه‌های خود در دسترس قرار دهید.

این مخزن با چندین دستور سفارشی که در پوشه .gemini/commands قرار دارند، ارائه می‌شود.

دستور سفارشی برای ایجاد نمودار

این اعلان را در Gemini CLI ارسال کنید تا نمودار جریان درخواست با فرمت Mermaid ایجاد شود.

فراخوانی‌های ابزارها، مانند ایجاد پوشه و ذخیره فایل را بپذیرید.

/diagram:new request flow for this app

خروجی را بررسی کنید.

a85a31f482a2cc7d.png

اگر می‌خواهید پیش‌نمایش نمودار را ببینید، افزونه Mermaid Chart از Marketplace نصب کنید.

۲۲d4a002e2137b55.png

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

bccf0ae8ac46415f.png

c669fcd96c34662.png

دستور سفارشی برای ایجاد یک دسته

این اعلان را در Gemini CLI ارسال کنید تا یک دسته کارت با نکات کلیدی در قالب Marp ایجاد شود.

فراخوانی‌های ابزارها، مانند ایجاد پوشه و ذخیره فایل را بپذیرید.

/deck:new key points and details for this app

خروجی را بررسی کنید.

c9aa767796204c7c.png

این مرحله با Cloud Shell سازگار نیست، زیرا افزونه Marp نیاز به نصب مرورگر وب دارد.

برای ذخیره مجموعه، افزونه Marp for VS Code را از Marketplace نصب کنید.

a9d339718cbfcd9.png

در غیر این صورت، فایل تولید شده را در ویرایشگر باز می‌کنید و از پالت دستورات، « Marp: Export Slide Deck » را انتخاب می‌کنید.

۹۱۱۴۳fe81f7f5d71.png

دستور سفارشی برای برنامه‌ریزی پیاده‌سازی ویژگی جدید

این اعلان را در رابط خط فرمان Gemini برای بازسازی رابط کاربری ارسال کنید.

فراخوانی‌های ابزارها، مانند ایجاد پوشه و ذخیره فایل را بپذیرید.

/plan:new refactor UI to use Materialize CSS

خروجی را بررسی کنید.

552dbe189a493f91.png

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

فراخوانی‌های ابزار، مانند ایجاد پوشه و ذخیره فایل را بپذیرید. می‌توانید با استفاده از " ctrl+y " حالت تأیید خودکار ابزار ( YOLO mode ) را فعال کنید.

/plan:impl implement the plan to refactor the app

a3ceec7146f285e0.png

برنامه را اجرا/بارگذاری مجدد کنید و خروجی را بررسی کنید:

fd0675f713d361e4.png

7352b93acabfb5be.png

۱۶. حالت غیر تعاملی رابط خط فرمان Gemini

هنگام اجرای Gemini CLI در حالت غیر تعاملی در یک خط لوله CI/CD، می‌توانید با ارسال مستقیم اعلان‌ها و دستورات به CLI و بدون نیاز به مداخله دستی، وظایف مختلفی را خودکار کنید. این امر امکان ادغام یکپارچه در گردش‌های کاری خودکار برای تجزیه و تحلیل کد، تولید مستندات و سایر وظایف توسعه را فراهم می‌کند.

یک ترمینال جدید باز کنید یا جلسه CLI موجود Gemini را ببندید و این دستور را اجرا کنید.

gemini -p "Explain the architecture of this codebase"

خروجی را بررسی کنید.

اگر وظیفه شما نیاز به تأیید ابزارها دارد، می‌توانید حالت YOLO را با استفاده از آپشن -y فعال کنید.

gemini -p "Explain the architecture of this codebase and save the file in the markdown format in the docs folder" -y

خروجی را بررسی کنید.

با استفاده از Gemini CLI در حالت غیر تعاملی، می‌توانید قابلیت‌های اتوماسیون خطوط لوله CI/CD خود را به میزان قابل توجهی افزایش دهید و منجر به چرخه‌های توسعه کارآمدتر و کیفیت کد بهبود یافته شوید.

۱۷. حالت شل Gemini CLI

در حالی که LLMها وظایف پیچیده را انجام می‌دهند، دستورات مستقیم برای اقدامات ساده کارآمدتر هستند. ! prefix امکان جابجایی یکپارچه بین رابط‌های هوش مصنوعی و خط فرمان سنتی را فراهم می‌کند.

!ls

خروجی را بررسی کنید. برای خروج از حالت shell، Escape را بزنید.

۱۸. پشتیبانی از Gemini CLI MCP

رابط خط فرمان Gemini، از طریق پروتکل زمینه مدل (MCP)، می‌تواند با سیستم‌های شخص ثالث مانند Jira، Confluence یا GitHub ادغام شود. این امر از طریق ادغام ابزارهای سفارشی سرور MCP محقق می‌شود و به Gemini CLI اجازه می‌دهد تا تیکت‌های JIRA را ایجاد یا به‌روزرسانی کند، اطلاعات را از صفحات Confluence دریافت کند، درخواست‌های pull ایجاد کند و غیره.

برای ایجاد فایل پیکربندی یا استفاده از حالت shell، این دستور را در ترمینال اجرا کنید.

echo '{
    "mcpServers": {
        "context7": {
            "httpUrl": "https://mcp.context7.com/mcp"
        }
    }
}' > .gemini/settings.json

شروع جلسه Gemini CLI:

gemini

سرورهای MCP پیکربندی شده را تأیید کنید:

/mcp

خروجی را بررسی کنید

c80d95544cc3436a.png

ارسال اعلان برای آزمایش سرور MCP پیکربندی شده:

use context7 tools to look up how to implement flex grid in react mui library 

ابزارها را تأیید کنید و خروجی را بررسی کنید.

b51db5af09bd3f02.png

۱۹. نمونه پیکربندی سرورهای MCP برای محیط محلی شما

شما می‌توانید چندین سرور MCP را در محیط محلی خود با استفاده از پیکربندی زیر پیکربندی کنید.

{
    "mcpServers": {
        "Snyk Security Scanner": {
            "command": "snyk",
            "args": [
                "mcp",
                "-t",
                "stdio",
                "--experimental"
            ],
            "env": {}
        },
        "atlassian": {
            "command": "npx",
            "args": [
                "-y",
                "mcp-remote",
                "https://mcp.atlassian.com/v1/sse"
            ]
        },
        "playwright": {
            "command": "npx",
            "args": [
                "@playwright/mcp@latest"
            ]
        },
        "github": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-github"
            ],
            "env": {
                "GITHUB_PERSONAL_ACCESS_TOKEN": "******"
            }
        }
    }
}

سرورهای MCP در این پیکربندی، عامل Gemini CLI شما را با ارائه دسترسی استاندارد به سیستم‌های خارجی، به یک ابزار توسعه و همکاری پویا تبدیل می‌کنند. به طور خاص، سرور اسکنر امنیتی Snyk به عامل اجازه می‌دهد تا کد و وابستگی‌ها را برای آسیب‌پذیری‌ها بدون ترک فضای کاری فعلی شما بررسی کند، در حالی که سرور Atlassian به Jira و Confluence متصل می‌شود و Gemini CLI را قادر می‌سازد تا با استفاده از زبان طبیعی، مسائل یا مستندات را ایجاد، جستجو و به‌روزرسانی کند. علاوه بر این، سرور Playwright قابلیت‌های اتوماسیون مرورگر عامل را اعطا می‌کند و به آن اجازه می‌دهد تا برای کارهایی مانند آزمایش یا استخراج داده‌ها، با وب پیمایش و تعامل داشته باشد. در نهایت، سرور Github به عامل دسترسی مستقیم و زمینه‌ای به مخازن شما می‌دهد و به آن امکان مدیریت PRها، مسائل مربوط به اولویت‌بندی و تجزیه و تحلیل پایگاه کد را می‌دهد که به طور قابل توجهی تغییر زمینه را کاهش داده و بهره‌وری را در کل گردش کار توسعه شما افزایش می‌دهد.

۲۰. نتیجه‌گیری رابط خط فرمان Gemini

در پایان، Gemini CLI به عنوان یک عامل هوش مصنوعی متن‌باز قدرتمند و همه‌کاره برجسته است که به طور یکپارچه با مدل‌های Gemini گوگل کلود ادغام می‌شود و بهره‌وری توسعه‌دهندگان را به طور قابل توجهی افزایش می‌دهد. در طول این آزمایشگاه، ما قابلیت‌های آن را در ساده‌سازی وظایف مختلف توسعه رایج، از درک پایگاه‌های کد پیچیده و تولید مستندات ضروری و تست‌های واحد گرفته تا بازسازی مؤثر اجزای frontend و backend یک برنامه وب پایتون، بررسی کرده‌ایم. با بهره‌گیری از Gemini CLI، توسعه‌دهندگان می‌توانند تغییر زمینه را کاهش دهند، فرآیندهای تکراری را خودکار کنند و در نهایت کد با کیفیت بالاتر و کارایی بیشتری ارائه دهند. توانایی آن در آوردن قدرت هوش مصنوعی مولد به طور مستقیم به خط فرمان، واقعاً انقلابی در گردش کار توسعه ایجاد می‌کند.

۲۱. تبریک می‌گویم!

تبریک می‌گویم، شما codelab را تمام کردید!

آنچه ما پوشش داده‌ایم:

  • استفاده از رابط خط فرمان Gemini برای وظایف رایج توسعه‌دهندگان

قدم بعدی چیست؟

  • جلسات عملی بیشتری در راه است!

تمیز کردن

برای جلوگیری از تحمیل هزینه به حساب گوگل کلود خود برای منابع استفاده شده در این آموزش، یا پروژه‌ای که شامل منابع است را حذف کنید، یا پروژه را نگه دارید و منابع تکی را حذف کنید.

حذف پروژه

ساده‌ترین راه برای حذف هزینه‌ها، حذف پروژه‌ای است که برای آموزش ایجاد کرده‌اید.

©2024 Google LLC تمامی حقوق محفوظ است. گوگل و لوگوی گوگل علائم تجاری Google LLC هستند. سایر نام‌های شرکت‌ها و محصولات ممکن است علائم تجاری شرکت‌های مربوطه باشند که با آنها مرتبط هستند.