۱. مقدمه
در این codelab، با Google Antigravity، پلاتفرم توسعه عامل‌محور که برای کمک به شما در توسعه در این عصر عامل‌ها طراحی شده است، آشنا خواهید شد. Antigravity 2.0 به‌عنوان مرکز فرماندهی مرکزی عامل‌های هوش مصنوعی شما عمل می‌کند و پلاتفرمی یکپارچه برای راه‌اندازی، نظارت، و هماهنگ‌سازی فعالیت‌های آن‌ها ارائه می‌دهد.
با راه‌اندازی نسخه ۲.۰، Antigravity دیگر فقط «مدیر عامل» یکپارچه با «محیط توسعه یکپارچه» نیست. اکنون اکوسیستم کاملی از محصولات طراحی‌شده برای عصر عامل‌محور است:
- Antigravity: برنامه خوداتکای شاخص برای macOS، Linux، و Windows. این مرکز فرمان شما برای مدیریت موازی چندین عامل محلی، اجرای تکالیف زمان‌بندی‌شده، و غیره است. برخلاف نسخه قبلی خود، «مدیر عامل»، Antigravity 2.0 برنامه‌ای مستقل است که به‌طور مستقل از «محیط توسعه یکپارچه» کار می‌کند.
- Antigravity IDE: نسخه اصلی IDE عامل‌گرا و کاملاً مجهز همچنان دردسترس است (و به توسعه‌دهندگان توصیه می‌شود!). این عامل با مدیر عامل، آرتیفکت‌ها، و درک عمیق از پایگاه کد شما ارائه می‌شود.
- Antigravity CLI: میانای خط فرمان برای تعاملات عامل مبتنی بر ترمینال. این موضوع در این آموزش پوشش داده نخواهد شد.
- Antigravity SDK: ابزارهایی برای توسعه‌دهندگان جهت ادغام برنامه‌ریزی‌شده Antigravity در سیستم‌های خودشان. این موضوع در این آموزش پوشش داده نخواهد شد.
- «ضدجاذبه برای محیط‌های توسعه یکپارچه»: این ویژگی اخیراً منتشر شده است. این ویژگی قابلیت‌های عامل خودکار Antigravity را مستقیماً در ویرایشگر موردعلاقه‌تان با افزونه‌های رسمی برای Visual Studio Code، Jetbrains، Zed، و غیره ادغام می‌کند. اگر نمی‌خواهید از هیچ‌کدام از این افزونه‌ها استفاده کنید، می‌توانید از Antigravity IDE مستقل که در بالا ذکر شد استفاده کنید.
در این codelab، تمرکز اصلی ما بر Antigravity خواهد بود و به‌طور خلاصه به Antigravity IDE خواهیم پرداخت. دو مؤلفه دیگر، Antigravity CLI و Antigravity SDK، تحت پوشش قرار نمی‌گیرند.
اگر به codelab درباره Antigravity CLI، که برنامه‌ای مبتنی بر ترمینال است، علاقه‌مندید، به codelab زیر مراجعه کنید: شروع به کار با Antigravity CLI.
آنچه خواهید آموخت
- درحال نصب و پیکربندی Antigravity.
- کاوش مفاهیم کلیدی Antigravity مانند کار با «عامل‌ها»، «پروژه‌ها»، و غیره.
- سفارشی‌سازی «ضدجاذبه» ازطریق تنظیمات مختلف و مطابق با اولویت‌های شما.
آنچه نیاز خواهید داشت
«ضدجاذبه» باید به‌صورت محلی در سیستم شما نصب شود. این محصول در Mac، Windows، و توزیع‌های خاص Linux دردسترس است. علاوه‌بر دستگاه خودتان، به موارد زیر نیاز دارید:
- مرورگر وب Chrome.
- حساب Gmail (حساب Gmail شخصی).
این codelab برای کاربران و توسعه‌دهندگان در همه سطوح طراحی شده است.
گزارش کردن مشکلات
هم‌زمان با کار کردن روی دستورالعمل گام‌به‌گام و Antigravity، ممکن است با مشکلاتی مواجه شوید.
برای مشکلات مربوط به آزمایش کد (غلط املایی، دستورالعمل‌های اشتباه)، لطفاً با دکمه Report a mistake در گوشه پایین سمت راست این آزمایش کد، اشکالی را باز کنید:
برای اشکالات یا درخواست‌های ویژگی مربوط به Antigravity، لطفاً مشکل را در Antigravity گزارش کنید. با کلیک کردن روی «تنظیمات» که در گوشه پایین سمت راست محصول Antigravity دردسترس است، می‌توانید بازخورد محصول را گزارش کنید. و سپس گزینه Provide Feedback را انتخاب کنید.
۲. نصب
درحال نصب Antigravity
به صفحه بارگیری Google Antigravity بروید. برنامه Antigravity را برای سیستم‌عامل خود (macOS، Linux، یا Windows) بارگیری کنید.
نصب‌کننده را اجرا کنید. صفحه زیر را نشان می‌دهد:
۲ گزینه وجود دارد:
- ادامه با Google: در اینجا می‌توانید از حساب شخصی Google خود استفاده کنید و Antigravity از بسته آغازین با Gmail شخصی پشتیبانی می‌کند. درصورتی‌که بسته‌های Google AI Pro / Ultra را در «حساب Google» خود خریداری کرده باشید، محدودیت‌های سهمیه مناسب Antigravity اعمال خواهد شد.
- استفاده از حساب کاری: اگر از این در پروژه «سازمانی» استفاده می‌کنید، که در آن «پروژه Google Cloud» دارید و سازمانتان پروانه‌ها را خریداری کرده است، این مورد اعمال می‌شود. همچنین می‌توانید از «پروژه Google Cloud» به‌همراه «پلاتفرم عامل» به‌صورت پرداخت براساس مصرف استفاده کنید. در اینجا از این گزینه استفاده نخواهیم کرد.
روی «ادامه با Google» کلیک کنید و با حساب Google خود وارد سیستم شوید. اصالت‌سنجی را تکمیل کنید و باید موارد زیر را نشان دهد:
روی باز کردن ضدجاذبه کلیک کنید و بقیه فرایند ادامه خواهد یافت.
می‌توانید موضوع، یک یا چند افزایه Google را که می‌توانید با آن‌ها «ضدجاذبه» را تقویت کنید (فعلاً می‌توانید همه این‌ها را نادیده بگیرید)، و صفحه شرایط خدمات را انتخاب کنید. آن را بپذیرید، روی پایان کلیک کنید و باید رابط کاربری Antigravity را ببینید که شبیه زیر است:
کمی بعد به رابط کاربری خواهیم رسید اما درحال‌حاضر آماده‌ایم.
نصب Antigravity IDE
در صفحه بالا، باید دکمه نصب Antigravity IDE را در گوشه بالا سمت چپ ببینید. این کار شما را به صفحه بارگیری Google Antigravity IDE هدایت می‌کند یا می‌توانید مستقیماً به آنجا بروید.
روی دکمه بارگیری کلیک کنید. این کار شما را به صفحه‌ای می‌برد که در آن می‌توانید «افزونه Antigravity» را برای IDE موردعلاقه‌تان (Visual Studio Code، Zed، Jetbrains، و غیره) بارگیری کنید یا می‌توانید نصب‌کننده IDE مستقل Antigravity را که در زیر ارائه شده است بارگیری کنید:
نصب‌کننده مناسب را بارگیری کنید. برنامه‌نصب را اجرا کنید، با همان «حساب Google» به سیستم وارد شوید، و نصب را ادامه دهید. برای هر مرحله، از IDE، کنش‌های پیش‌فرض، افزایه‌ها، و غیره، از پیش‌فرض‌ها استفاده کنید.
دو نماد در سکو خواهید دید: Antigravity 2.0 (پس‌زمینه سفید) و Antigravity IDE (پس‌زمینه شطرنجی سیاه).
۳. میانای Antigravity 2.0
اگر قبلاً Antigravity را راه‌اندازی نکرده‌اید، این کار را انجام دهید. در حالت ایده‌آل، باید صفحه‌ای شبیه به این ببینید. اگر Antigravity IDE مستقل را نصب کرده باشید، دکمه گوشه بالا Open Antigravity IDE (باز کردن Antigravity IDE) خواهد بود و نه Install IDE (نصب IDE).
در این آموزش، هرگاه نیاز باشد به گزینه تنظیمات در گوشه پایین سمت راست خواهیم رسید.
پروژه‌ها
ابتدا بیایید مفهوم پروژه‌ها را در Antigravity درک کنیم. این موضوع بسیار مهم است زیرا اگر به میانای کار در قاب سمت چپ توجه کنید، به‌وضوح نوشته شده است انتخاب پروژه و Antigravity از رویکردی پروژه محور استفاده می‌کند تا مطمئن شود که کارگزاران به فایل‌ها، ابزارها، اجازه‌ها، و موارد دیگر صحیح دسترسی دارند.
پروژه ترکیبی از پوشه‌هایی است که محیط و محدوده عامل شما را تعریف می‌کند. به‌جای اینکه عامل را مجبور کنید در یک پوشه واحد کار کند، پروژه می‌تواند با یک یا چند پوشه (برای نمونه، مخزن پیش‌کار و پس‌کار) کار کند و همه زمینه‌های موردنیاز پایگاه کد را دراختیار عامل‌هایتان قرار دهد. همه پروژه‌ها تنظیمات عامل مجزای خودشان را دارند که به شما امکان می‌دهد تنظیمات امنیتی پروژه‌های مختلف را به‌طور مستقل سفارشی‌سازی کنید.
بیایید اولین پروژه‌مان را بسازیم. در پوشه خانه در ماشین محلی‌تان، پوشه‌ای به‌نام $HOME/agy2-projects/my-first-project ایجاد کنید . توجه داشته باشید که لازم نیست پوشه خالی باشد.
اکنون می‌خواهیم اولین پروژه خود را در Antigravity با تعریف اینکه کدام پوشه‌ها پروژه را تشکیل می‌دهند ایجاد کنیم. در مورد اولیه ما در اینجا، فقط یک پوشه خواهد بود، یعنی $HOME/agy2-projects/my-first-project.
در نوار پیمایش سمت راست، بخش پروژه‌ها را خواهید دید. روی دکمه ایجاد پروژه جدید همان‌طور که در زیر نشان داده شده است کلیک کنید:
گزینه‌ها را همان‌طور که در زیر نشان داده شده است خواهید دید، روی پروژه جدید کلیک کنید:
از شما می‌خواهد با باز کردن «پوشه» یا «کاوشگر فایل»، پوشه‌ای را برای پروژه‌تان انتخاب کنید. پوشه را انتخاب کنید، در مورد ما، $HOME/agy2-projects/my-first-project است.
بنابراین درحال‌حاضر پروژه‌ای به‌نام my-first-project تعریف کرده‌ایم که به پوشه‌ای یعنی $HOME/agy2-projects/my-first-project اشاره می‌کند.
ممکن است بپرسید آیا «پروژه» می‌تواند فقط یک پوشه داشته باشد. اگر بخواهم پروژه‌ای داشته باشم که هم پوشه‌های کد جلویی و هم پوشه‌های کد پشتی داشته باشد، چه؟ می‌توانید پوشه‌های بیشتری اضافه کنید تا Antigravity هنگام کار با پروژه‌هایتان زمینه کامل داشته باشد. روی تنظیمات پروژه برای پروژه خاص (my-first-project) همان‌طور که در زیر نشان داده شده است کلیک کنید:
با این کار، کادر گفتگوی تنظیمات پروژه برای پروژه خاصی باز می‌شود و متوجه خواهید شد که حاوی گزینه افزودن پوشه‌های بیشتر ازطریق گزینه افزودن پوشه است.
همچنان می‌توانید پوشه‌های بیشتری به «پروژه» اضافه کنید، همان‌طور که می‌توانید متوجه شوید (ازطریق افزودن پوشه)، اما درحال‌حاضر با همین پوشه‌ها مشکلی نداریم و می‌توانیم روی دکمه «ایجاد» کلیک کنیم.
اکنون می‌توانید صفحه تنظیمات را ببندید.
یکی از موارد کلیدی که متوجه آن خواهید شد این است که «همه پروژه‌ها تنظیمات عامل مجزای خودشان را دارند که به شما امکان می‌دهد تنظیمات امنیتی پروژه‌های مختلف را به‌طور مستقل سفارشی‌سازی کنید.» بنابراین در هر زمانی، اگر بخواهید رفتار «ضدجاذبه» را برای پروژه خاص خود تغییر دهید، می‌توانید به تنظیمات پروژه بروید و تنظیمات خاص را درصورت نیاز اصلاح کنید.
به‌عبارت ساده، هر پروژه اجازه‌های مربوط به مرور آرتیفکت‌ها، ابزارهای مجاز، و پیکربندی «سرور MCP» را از پیکربندی سراسری که ازطریق تنظیمات در میانای اصلی دردسترس است به‌ارث می‌برد. بااین‌حال، می‌توانید این اجازه‌ها و اجازه‌های بیشتر را به‌صورت جداگانه برای هر پروژه تنظیم کنید و از این طریق انعطاف‌پذیری بیشتری داشته باشید و زمینه و ابزارها را برای پروژه خاص خودتان ساده و کارآمد نگه دارید.
فعلاً با کلیک کردن روی شروع اولین مکالمه، به نماینده فوق‌العاده‌مان سلام کنیم. پس‌از انجام این کار، صفحه زیر و اولین پروژه ما را خواهید دید که اکنون هم در فهرست پروژه‌ها در سمت راست و هم درحال‌حاضر به‌عنوان پروژه‌ای که «عامل» در آن کار خواهد کرد نمایش داده می‌شود. وقتی ازطریق «میانای گپ» به آن پیام می‌دهید، در این پروژه کار خواهد کرد. توجه داشته باشید که می‌توانید «مدل» را انتخاب کنید، ازطریق علامت + یا @ یا کنش‌های / و غیره بافتار اضافی ارسال کنید.
بیایید با پیامی به «عامل» خود خوشامد بگوییم و او مطابق با آن پاسخ می‌دهد.
درخواست دیگری برای دریافت اخبار دارم و خوب عمل می‌کند.
مکالمه‌ها
کاری که در اینجا انجام داده‌ایم این است که در «پروژه» (my-first-project) خود، رشته مکالمه‌ای را شروع کردیم و درحال‌حاضر مجموعه‌ای از پیام‌ها (پیام کاربر و پاسخ‌های نماینده) در رشته وجود دارد.
خواهید دید که این رشته مکالمه همچنان یک رشته واحد است و در سمت راست در زیر پروژه گروه‌بندی‌شده نشان داده می‌شود.
اکنون، بیایید کاری جالب انجام دهیم و به این رشته مکالمه نامی بدهیم. بیایید آن را conv-introduction بنامیم.
برای انجام این کار، روی سه نقطه عمودی در کنار مکالمه کلیک کنید. ۳ گزینه به شما نشان داده می‌شود. کنش تغییر نام را انتخاب کنید.
مقدار conv-introduction یا هر نامی که برایتان منطقی است را وارد کنید.
اکنون، اگر می‌خواهید مکالمه کاملاً جدیدی در پروژه داشته باشید، روی علامت + (مکالمه جدید در پروژه) در کنار پروژه، همان‌طور که در زیر نشان داده شده است، کلیک کنید.
اکنون وارد مکالمه کاملاً جدیدی شده‌اید.
بیایید چند خبر ورزشی از سراسر جهان بپرسیم. توجه داشته باشید که هنوز در my-first-project هستیم، یعنی «Give me some sports news from across the world» (چند خبر ورزشی از سراسر جهان به من بده).
این کار به من اخبار مربوط به دنیای ورزش را می‌دهد و می‌توانید متوجه شوید که اکنون دو رشته مکالمه در یک پروژه داریم.
بیایید نام این مکالمه را به conv-sportsnews تغییر دهیم. اگر می‌خواهید همه مکالمه‌هایی را که تاکنون انجام شده است ببینید، می‌توانید به سابقه مکالمه در بالا سمت راست، همان‌طور که در زیر نشان داده شده است، مراجعه کنید:
در هر زمانی، می‌توانید مکالمه جدیدی را در پروژه فعلی یا پروژه جدید ازطریق گزینه مکالمه جدید در بالا شروع کنید.
تنظیمات پروژه
اکنون بیایید به تنظیمات پروژه که قبلاً درباره آن صحبت کردیم برگردیم. وقتی در Antigravity پروژه‌ای ایجاد می‌کنید، این پروژه اجازه‌های پیش‌فرض را به‌ارث می‌برد که درصورت تمایل می‌توانید آن‌ها را به‌طور خاص ملغی کنید.
برای دسترسی به تنظیمات پروژه برای یک پروژه خاص، روی نماد چرخ‌دنده تنظیمات در کنار پروژه خاص در نوار پیمایش سمت راست کلیک کنید، همان‌طور که در زیر نشان داده شده است، و روی تنظیمات پروژه کلیک کنید:
این کار شما را به تنظیمات خاص «پروژه» (یعنی my-first-project) هدایت می‌کند، همان‌طور که در زیر نشان داده شده است:
در سمت راست در بخش پروژه‌ها، متوجه می‌شوید که my-first-project انتخاب شده است. اگر پروژه‌های بیشتری وجود داشت، در زیر این فهرست قابل‌مشاهده بودند و می‌توانید به‌راحتی هریک از پروژه‌ها را انتخاب کنید و تنظیمات آن‌ها را درصورت نیاز تغییر دهید.
اکنون، بیایید روی سمت چپ، تنظیمات پروژه نشان‌داده‌شده برای my-first-project تمرکز کنیم. متوجه خواهید شد که این بایگانی فقط پوشه‌ای را دارد که به این پروژه اضافه کرده بودیم. از اینجا هم می‌توانید پوشه‌های بیشتری اضافه کنید.
پیشنهاد می‌کنم ابتدا کل فهرست را بررسی کنید و انعطاف‌پذیری‌ای را که اکنون برای کمک به شما در تغییر تعداد زیادی از تنظیمات براساس الزامات سفارشی‌سازی پروژه شما ارائه شده است ببینید.
این موارد عبارت‌اند از:
- پیش‌تنظیم امنیتی: می‌توانید تعیین کنید که آیا می‌خواهید همه دستورات ترمینال و دسترسی‌های فایل ابتدا توسط شما بررسی شود و سپس نماینده بتواند اقدامات را انجام دهد.
- رفتار عامل: درصورت تولید آرتیفکت‌ها، برای مثال implementation_plan.md، که می‌خواهید قبل‌از اینکه از عامل بخواهید طرح را اجرا کند، آن را مرور کنید.
- اجازه‌های محلی مختلف یعنی مسیرهای فایل مجاز برای دسترسی، نشانی‌های وب مجاز یا مسدود برای «عامل»، و غیره.
- حتی می‌توانید پیکربندی کنید که کدام «ابزارهای MCP» خاص برای این «پروژه» مجاز باشند. این کار برای جلوگیری از دردسترس قرار گرفتن همه «سرورهای MCP» پیکربندی‌شده جهانی برای «عامل» در این پروژه بسیار مفید است.
توجه: در هر زمانی می‌توانید ازطریق گزینه تنظیمات اصلی در رابط Antigravity به تنظیمات Antigravity یا حتی تنظیمات پروژه بروید.
۴. فرمان‌های خط مورب
چند فرمان جالب خط مورب / در Antigravity دردسترس است. در میانای گپ مکالمه، اگر / را تایپ کنید، باید فرمان‌ها را همان‌طور که در زیر نشان داده شده است ببینید:
اگر می‌خواهید مدل قبل‌از اجرا کردن، طرح پیاده‌سازی ایجاد کند، فرمان /plan مهم است.
فرمان /browser برای راه‌اندازی مرورگر و درخواست از آن برای انجام کاری است.
مرور کردن وب‌سایت را همان‌طور که در زیر نشان داده شده است امتحان کنید:
این کار باعث ایجاد یک عامل فرعی مرورگر می‌شود که تلاش می‌کند یک جلسه اشکال‌زدایی را با Chrome راه‌اندازی کند و ابتدا از شما اجازه می‌خواهد:
پس‌از اینکه اجازه دادید، مرورگر از سایت بازدید می‌کند، جدیدترین اخبار را دریافت می‌کند، و سپس داده‌ها در Antigravity به شما برگردانده می‌شود.
اگر می‌خواهید تکالیف تکرارشونده یا یک‌باره‌ای را برای اجرا توسط کارگزار در فواصل زمانی ثابت یا در یک برنامه زمانی (مثلاً ۹:۰۰ صبح دوشنبه، چهارشنبه) تنظیم کنید، فرمان /schedule مفید است.
درعین‌حال، همین امکان ازطریق میانای کاربری دراختیار شما قرار می‌گیرد و در بخش فرمان‌های زمان‌بندی در مرحله بعد پوشش داده می‌شود.
۵. فرمان‌های زمان‌بندی
می‌توانید از گزینه زمان‌بندی در میانای اصلی برای خودکارسازی کردن تکالیف تکرارشونده یا تنظیم یادآوری‌های یک‌باره در پروژه‌های خاص خود استفاده کنید.
بیایید تکلیف روزانه‌ای ایجاد کنیم که جلسه ساعت ۶ عصر را به ما یادآوری کند. روی جدید کلیک کنید و جزئیات را همان‌طور که در زیر نشان داده شده است تکمیل کنید:
روی افزودن تکلیف زمان‌بندی‌شده کلیک کنید و سپس تکلیف را به فهرست تکالیف زمان‌بندی‌شده اضافه کنید، همان‌طور که در زیر نشان داده شده است:
بیایید یادآور دیگری اضافه کنیم که هر ۲۰ دقیقه به ما یادآوری کند استراحت کنیم:
اکنون دو تکلیف زمان‌بندی‌شده داریم، همان‌طور که در زیر نشان داده شده است:
می‌توانید هریک از تکالیف را غیرفعال یا حذف کنید. به‌یاد داشته باشید که ما از پیام‌واره‌های ساده استفاده کرده‌ایم اما پیام‌واره‌های شما می‌تواند جزئی‌تر باشد، می‌تواند ابزارها را فراخوانی کند (با سیستم‌های خارجی صحبت کند) و براساس الزامات شما، در فواصل زمانی منظم کارهای بیشتری در پشت صحنه انجام دهد.
۶. سرورهای «پروتکل بافتار مدل» (MCP)
«پروتکل بافتار مدل» (MCP) استاندارد کمک به اتصال عامل‌ها به سیستم‌های خارجی است. این افراد نقش کلیدی در تضمین اینکه نماینده ازنظر داده‌ها و یکپارچه‌سازی شما در جایگاه خود باقی بماند ایفا می‌کنند.
Antigravity از سرورهای MCP، هم محلی و هم از دور، پشتیبانی می‌کند. این ابزار همچنین با یکپارچه‌سازی با چندین سرور MCP که با سرویس‌های Google Cloud کار می‌کنند ارائه می‌شود و نصب آن‌ها با چند داده پیکربندی فقط با یک کلیک انجام می‌شود.
جدیدترین نسخه Antigravity 2.0 اضافه کردن «سرورهای MCP» به Antigravity را آسان کرده است.
به تنظیمات → سفارشی‌سازی‌ها بروید و پیکربندی «سرور MCP» را همان‌طور که در زیر نشان داده شده است مشاهده خواهید کرد:
به بخش «سرورهای MCP نصب‌شده» در پیکربندی بالا بروید، همان‌طور که در زیر نشان داده شده است:
اگر روی دکمه «باز کردن پیکربندی MCP» کلیک کنید، به فایل موجود در $HOME/.gemini/config/mcp_config.json هدایت می‌شوید و همه پیکربندی‌هایتان در آنجا قرار می‌گیرد. اگر با فایل پیکربندی «سرورهای MCP» آشنا هستید، می‌توانید محتوای فایل را مستقیماً ویرایش و ذخیره کنید.
می‌بینید که در این زمان خالی است.
برای پیکربندی «سرور MCP»، تنها کاری که باید انجام دهید این است که روی دکمه افزودن MCP کلیک کنید.
با این کار، فهرست بزرگی از پیش‌پیکربندی‌های دردسترس برای چندین «سرور MCP» نمایش داده می‌شود، به‌ویژه سرویس‌های Google Cloud که به‌عنوان «سرورهای MCP» بسته‌بندی شده‌اند. صفحه‌ای در زیر نشان داده شده است:
می‌توانید هرکدام از آن‌ها را اضافه کنید. برای مثال، روی افزودن در کنار «سرور Google Cloud Run MCP» کلیک کردم و آن را نصب کرد.
این سرور را به فهرست «سرورهای MCP» اضافه می‌کند، همان‌طور که در زیر نشان داده شده است، همراه با ابزارهایی که «سرور MCP» آشکار می‌کند. به‌سادگی می‌توانید با کلیک کردن روی نکته‌ابزار نام ابزار خاص در زیر، ابزاری را فعال/غیرفعال کنید یا حتی با روشن/خاموش کردن کلید روشن/خاموش، کل «سرور MCP» را غیرفعال کنید.
اگر روی دکمه باز کردن پیکربندی MCP کلیک کنید، خواهید دید که ورودی به فایل mcp_config.json اضافه شده است، همان‌طور که در زیر نشان داده شده است:
{
"mcpServers": {
"cloudrun": {
"command": "npx",
"args": [
"-y",
"@google-cloud/cloud-run-mcp"
]
}
}
}
اگر با «سرورهای MCP» از دور موجود کار کرده‌اید، می‌توانید به‌سادگی جزئیات را به فایل $HOME/.gemini/config/mcp_config.json اضافه کنید.
برای استفاده از سرورهای MCP پیکربندی‌شده، می‌توانید از Antigravity چیزی بپرسید که به سرور MCP نیاز داشته باشد. برای مثال، می‌توانید سرور cloudrun-mcp را فعال کنید و از Antigravity سؤالات زیر را بپرسید: Build and deploy a Cloud Run service. این کار باعث می‌شود Antigravity به‌دنبال سرور cloudrun-mcp بگردد و از آن برای پیکربندی و استقرار سرویس Cloud Run استفاده کند.
۷. خروجی‌های ساختاریافته
Antigravity ممکن است درحین برنامه‌ریزی و انجام کار خود، آثار ایجاد کند تا از این طریق کار خود را به کاربر انسانی اطلاع دهد و از او بازخورد دریافت کند. این‌ها فایل‌های نشانه‌گذاری غنی، نمودارهای معماری، تصاویر، ضبط‌های مرورگر، تفاوت‌های کد، و غیره هستند.
آثار هنری شکاف اعتماد را پر می‌کنند. وقتی نماینده‌ای ادعا می‌کند که اشکالی را برطرف کرده است، توسعه‌دهنده قبلاً باید کد را می‌خواند تا آن را درستی‌سنجی کند. در Antigravity، عامل برای اثبات آن مصنوعه‌ای تولید می‌کند.
این‌ها آرتیفکت‌های اصلی هستند که ممکن است Antigravity تولید کند:
Task Lists: قبل‌از نوشتن کد، عامل می‌تواند انتخاب کند که طرحی ساختاریافته ایجاد کند. معمولاً نیازی به ویرایش این طرح ندارید، اما می‌توانید آن را مرور کنید و درصورت نیاز، برای تغییر آن نظر اضافه کنید.Implementation Plan: وقتی از فرمان /plan استفاده می‌شود، قبل‌از شروع انجام تکلیف، طرح پیاده‌سازی ایجاد می‌شود. این طرح‌ها حاوی جزئیات فنی درباره اصلاحات ضروری است و باید توسط کاربر مرور شود، مگراینکه خط‌مشی مرور آرتیفکت شما روی همیشه ادامه دهید تنظیم شده باشد.Walkthrough: این ممکن است پس‌از تکمیل اجرای تکلیف توسط نماینده، به‌عنوان خلاصه‌ای از تغییرات و نحوه آزمایش آن‌ها ایجاد شود.Code diffs: اگرچه ازنظر فنی یک آرتیفکت نیست، Antigravity همچنین تفاوت‌های کد تولید می‌کند که می‌توانید آن‌ها را بررسی و نظر دهید.Screenshots: نماینده ممکن است وضعیت میانای کاربر را قبل و بعداز تغییر ضبط کند.
برای درک بهتر آرتیفکت‌ها، با پیام‌واره زیر و فرمان /plan، مکالمه‌ای با پروژه جدید یا موجود ایجاد کنید:
/plan Design a Node application that I can run from the command line to get me the latest news from Google.
«عامل» پرواز می‌کند و با اولین دست‌ساخته ما برمی‌گردد: «طرح پیاده‌سازی».
با روشن/خاموش کردن پانل کمکی که در گوشه بالا سمت چپ نشان داده می‌شود، می‌توانید به هریک از آرتیفکت‌های تولیدشده توسط Antigravity نگاه کنید.
اگر پانل کمکی را روشن/خاموش کنید، برونداد زیر را می‌بینید که در آن ذکر شده است ۱ «آرتیفکت» (طرح پیاده‌سازی) تولید شده است.
برای دیدن جزئیات، روی طرح پیاده‌سازی کلیک کنید، همان‌طور که در زیر نشان داده شده است:
درحال‌حاضر، با این طرح موافقیم و برای ادامه دادن، کافی است روی دکمه ادامه کلیک کنیم.
ممکن است برای ادامه از شما اجازه خواسته شود، لطفاً اجازه دهید.
وقتی همه چیز توسط «نماینده» تکمیل، آزمایش، و درستی‌سنجی شد، پیامی دریافت خواهید کرد که می‌گوید تکلیف تکمیل شده است.
یکی دیگر از آرتیفکت‌هایی که ممکن است ببینید راهنما همراه با تفاوت‌های فایل‌ها است، همان‌طور که در زیر نشان داده شده است.
برای مشاهده فایل‌های تولیدشده ممکن است به «ویرایشگر» / «محیط توسعه یکپارچه» کامل نیاز نداشته باشید. می‌توانید روی فایل‌های package.json یا index.js کلیک کنید و محتوای آن را ببینید و روی آن نظر دهید.
۸. Antigravity IDE
اگر IDE را ترجیح می‌دهید، می‌توانید از Antigravity IDE که قبلاً در این آزمایش کد نصب کردیم استفاده کنید. متوجه خواهید شد که وقتی برای روشن/خاموش کردن «پانل کمکی» در میانای اصلی «ضدجاذبه» می‌روید، گزینه Open IDE (باز کردن IDE) وجود دارد.
برای باز کردن Antigravity IDE، روی آن کلیک کنید. ممکن است هنگام راه‌اندازی Antigravity IDE، هشداری شبیه به این ببینید:
این رویداد عادی است؛ ادامه دهید و روی بله کلیک کنید. با این کار، Antigravity IDE بالا می‌آید که برای هر کسی که قبلاً از IDE استفاده کرده است آشنا خواهد بود. این کد همه پوشه‌ها/فایل‌های تولیدشده، یک ویرایشگر، و یک پانل عامل دارد که در آن می‌توانید درباره کد با «عامل» گپ بزنید (توضیح دهید، تولید کنید، رفع اشکال کنید، و غیره).
۹. مهارت‌ها
اگرچه مدل‌های زیربنایی Antigravity متخصصان عمومی قدرتمندی هستند، اما از بافت پروژه خاص شما یا استانداردهای تیمتان اطلاعی ندارند. بار کردن همه ابزارها یا قوانین در پنجره زمینه‌ای عامل منجر به تورم ابزار، هزینه‌های بالاتر، تأخیر، و سردرگمی می‌شود.
مهارت‌ها این مشکل را ازطریق شفاف‌سازی تدریجی حل می‌کنند. مهارت بسته تخصصی از دانش است که تا زمانی که به آن نیاز نباشد غیرفعال می‌ماند. فقط زمانی در زمینه نماینده بار می‌شود که درخواست ویژه شما با شرح مهارت مطابقت داشته باشد .
ساختار و حوزه
مهارت‌ها بسته‌های مبتنی بر فهرست راهنما هستند. بسته به نیازهایتان می‌توانید آن‌ها را در دو حوزه تعریف کنید:
- محدوده جهانی (
~/.gemini/config/skills/): در همه محصولات Antigravity (Antigravity، Antigravity IDE، Antigravity CLI) و پروژه‌ها دردسترس است. - محدوده پروژه/فضای کاری (
<project-root>/.agents/skills/): این کار باعث می‌شود مهارت فقط در یک پروژه خاص دردسترس باشد.
تشریح مهارت
دایرکتوری مهارت معمول به این شکل است :
my-skill/
├── SKILL.md #(Required) metadata & instructions.
├── scripts/ # (Optional) Python or Bash scripts for execution.
├── references/ # (Optional) text, documentation, or templates.
└── assets/ # (Optional) Images or logos.
بیایید اکنون چند مهارت اضافه کنیم.
مهارت بازبینی کد
این یک مهارت فقط دستورالعمل است، یعنی فقط باید فایل SKILL.md را ایجاد کنیم که حاوی فراداده و دستورالعمل‌های مهارت است. بیایید مهارتی ایجاد کنیم که جزئیاتی را برای عامل ارائه دهد تا تغییرات کد را ازنظر اشکالات، مشکلات سبک، و روال‌های مطلوب بررسی کند.
با فرض اینکه در پوشه پروژه خاصی هستید (مثلاً $HOME/agy2-projects/my-skills-project) اولین گام ایجاد دایرکتوری در پوشه پروژه است که حاوی مهارت خواهد بود.
mkdir -p .agents/skills/code-review
فایل SKILL.md را در پوشه پروژه (برای نمونه .agents/skills/code-review که به‌تازگی ایجاد کردیم) با محتوای نشان‌داده‌شده در زیر ایجاد کنید:
---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing PRs or checking code quality.
---
# Code Review Skill
When reviewing code, follow these steps:
## Review checklist
1. **Correctness**: Does the code do what it's supposed to?
2. **Edge cases**: Are error conditions handled?
3. **Style**: Does it follow project conventions?
4. **Performance**: Are there obvious inefficiencies?
## How to provide feedback
- Be specific about what needs to change
- Explain why, not just what
- Suggest alternatives when possible
توجه داشته باشید که فایل SKILL.md بالا حاوی فراداده (نام و توضیحات) در بالا و سپس دستورالعمل‌ها است. وقتی کارگزار بار می‌شود، فقط فراداده مهارت‌ها را می‌خواند و دستورالعمل‌های کامل مهارت‌ها را فقط درصورت نیاز بار می‌کند.
اجازه دهید مهارت مرور کد را اعتبارسنجی کنیم. مکالمه‌ای را در «ضدجاذبه» در پروژه خاصی که انتخاب کرده‌اید باز کنید و پیام‌واره زیر را ارائه دهید.
باید مهارت بازبینی کد را نشان دهد.
امتحان کنید
فایل جدیدی با نام demo_bad_code.py در $HOME/agy2-projects/my-skills-project با محتوای نشان‌داده‌شده در زیر ایجاد کنید:
import time
def get_user_data(users, id):
# Find user by ID
for u in users:
if u['id'] == id:
return u
return None
def process_payments(items):
total = 0
for i in items:
# Calculate tax
tax = i['price'] * 0.1
total = total + i['price'] + tax
time.sleep(0.1) # Simulate slow network call
return total
def run_batch():
users = [{'id': 1, 'name': 'Alice'}, {'id': 2, 'name': 'Bob'}]
items = [{'price': 10}, {'price': 20}, {'price': 100}]
u = get_user_data(users, 3)
print("User found: " + u['name']) # Will crash if None
print("Total: " + str(process_payments(items)))
if __name__ == "__main__":
run_batch()
مکالمه جدیدی را در پروژه خاصی در Antigravity باز کنید و پیام‌واره زیر را ارائه دهید: review the @demo_bad_code.py file.
«نماینده» باید مهارت code-review را شناسایی کند، جزئیات را بار کند، و سپس کنش را طبق دستورالعمل‌های ارائه‌شده در فایل code-review/SKILL.md انجام دهد.
برونداد نمونه در زیر نشان داده شده است:
۱۰. نتیجه‌گیری
تبریک! اکنون Antigravity 2.0 را باموفقیت نصب کرده‌اید، محیطتان را پیکربندی کرده‌اید، و با نحوه کنترل کردن عامل‌هایتان آشنا شده‌اید.
بعدی چیست؟ برای دیدن Antigravity 2.0 درحال ساخت برنامه‌های دنیای واقعی، می‌توانید به کدآزمای زیر نگاه کنید:
- ساختن و مستقر کردن در Google Cloud با Antigravity: این codelab نشان می‌دهد چگونه برنامه بدون‌سرور را در Google Cloud طراحی، بسازید، و مستقر کنید.
اسناد مرجع
- سایت رسمی : https://antigravity.google/
- مستندات: https://antigravity.google/docs/home
- موارد استفاده : https://antigravity.google/use-cases
- بارگیری : https://antigravity.google/download
- کانال YouTube برای Google Antigravity : https://www.youtube.com/@googleantigravity