۱. مقدمه
در این آزمایشگاه کد، شما با Google Antigravity (که در ادامه سند به آن Antigravity گفته میشود) آشنا خواهید شد، یک پلتفرم توسعه عاملمحور که IDE را به دوران عاملمحوری تکامل میدهد.
برخلاف دستیارهای کدنویسی استاندارد که فقط خطوط را به صورت خودکار تکمیل میکنند، Antigravity یک «کنترل ماموریت» برای مدیریت عاملهای خودمختار ارائه میدهد که میتوانند برنامهریزی، کدنویسی و حتی مرور وب را برای کمک به شما در ساخت و ساز انجام دهند.
آنتیگراویتی به عنوان یک پلتفرم عامل-محور طراحی شده است. این پلتفرم فرض میکند که هوش مصنوعی فقط ابزاری برای نوشتن کد نیست، بلکه یک بازیگر مستقل است که قادر به برنامهریزی، اجرا، اعتبارسنجی و تکرار وظایف مهندسی پیچیده با حداقل دخالت انسان است.
آنچه یاد خواهید گرفت
- نصب و پیکربندی آنتی گراویتی
- بررسی مفاهیم کلیدی Antigravity مانند Agent Manager، Editor، Browser و موارد دیگر.
- سفارشیسازی Antigravity با قوانین و گردش کار خودتان، همراه با ملاحظات امنیتی.
آنچه نیاز دارید
در حال حاضر Antigravity به صورت پیشنمایش برای حسابهای جیمیل شخصی در دسترس است. این برنامه با سهمیه رایگان برای استفاده از مدلهای برتر ارائه میشود.
آنتیگراویتی باید به صورت محلی روی سیستم شما نصب شود. این محصول روی مک، ویندوز و برخی توزیعهای لینوکس موجود است. علاوه بر دستگاه خودتان، به موارد زیر نیز نیاز خواهید داشت:
- مرورگر وب کروم
- یک حساب جیمیل (حساب جیمیل شخصی).
این آزمایشگاه کد، برای کاربران و توسعهدهندگان در تمام سطوح (از جمله مبتدیان) طراحی شده است.
گزارش مشکلات
همانطور که با آزمایشگاه کد و با Antigravity کار میکنید، ممکن است با مشکلاتی روبرو شوید.
برای مشکلات مربوط به codelab (غلط املایی، دستورالعملهای اشتباه)، لطفاً با استفاده از دکمه Report a mistake در گوشه پایین سمت چپ این codelab، یک اشکال (bug) ایجاد کنید:
برای اشکالات یا درخواستهای مربوط به Antigravity، لطفاً مشکل را در Antigravity گزارش دهید. میتوانید این کار را در Agent Manager با لینک Provide Feedback در گوشه پایین سمت چپ انجام دهید:
همچنین میتوانید با لینک Report Issue در زیر آیکون پروفایل خود به ویرایشگر بروید:
۲. نصب
اگر Antigravity را از قبل نصب نکردهاید، بیایید با نصب Antigravity شروع کنیم. در حال حاضر این محصول برای پیشنمایش در دسترس است و میتوانید از حساب Gmail شخصی خود برای شروع کار با آن استفاده کنید.
به صفحه دانلودها بروید و روی نسخه سیستم عامل مناسب برای سیستم خود کلیک کنید. نصب کننده برنامه را اجرا کنید و آن را روی دستگاه خود نصب کنید. پس از اتمام نصب، برنامه Antigravity را اجرا کنید. باید صفحهای مشابه صفحه زیر مشاهده کنید:
لطفا هر بار روی Next کلیک کنید. مراحل کلیدی در زیر شرح داده شده است:
- انتخاب جریان راهاندازی: این گزینه، امکان وارد کردن تنظیمات فعلی VS Code یا Cursor را برای شما فراهم میکند. ما با یک شروع تازه شروع خواهیم کرد.
- نوع قالب ویرایشگر را انتخاب کنید : ما قالب تاریک را انتخاب میکنیم، اما انتخاب کاملاً به خودتان بستگی دارد.
- چطور میخواهی از عامل ضد جاذبه استفاده کنی؟
بیایید این موضوع را با جزئیات بیشتری بررسی کنیم. به یاد داشته باشید که تنظیمات را میتوان در هر زمانی از طریق تنظیمات کاربری Antigravity ( Cmd + , ) تغییر داد.
قبل از اینکه به بررسی گزینهها بپردازیم، اجازه دهید نگاهی به برخی از ویژگیهای خاص (که در سمت راست کادر محاورهای میبینید) بیندازیم.
سیاست اجرای ترمینال
این در مورد دادن توانایی به Agent برای اجرای دستورات (برنامهها/ابزارها) در ترمینال شما است:
- همیشه ادامه دهید: همیشه دستورات ترمینال را به طور خودکار اجرا کنید (به جز مواردی که در یک لیست رد قابل تنظیم هستند).
- درخواست بررسی: قبل از اجرای دستورات ترمینال، از کاربر درخواست بررسی و تأیید کنید.
سیاست بررسی
همانطور که نماینده وظیفه خود را انجام میدهد، مصنوعات مختلفی (طرح وظیفه، طرح اجرا و غیره) ایجاد میکند. سیاست بررسی به گونهای تنظیم شده است که میتوانید تعیین کنید چه کسی تصمیم میگیرد که آیا نیاز به بررسی دارد یا خیر. آیا همیشه میخواهید آن را بررسی کنید یا اجازه دهید نماینده در این مورد تصمیم بگیرد. بر این اساس، در اینجا نیز سه گزینه وجود دارد.
- همیشه ادامه دهید: نماینده هرگز درخواست بررسی نمیکند.
- تصمیم نماینده: نماینده تصمیم میگیرد چه زمانی درخواست بررسی کند.
- درخواست بررسی: نماینده همیشه درخواست بررسی میکند.
سیاست اجرای جاوا اسکریپت
وقتی فعال باشد، عامل میتواند از ابزارهای مرورگر برای باز کردن URLها، خواندن صفحات وب و تعامل با محتوای مرورگر استفاده کند. این خطمشی نحوه اجرای جاوا اسکریپت در مرورگر را کنترل میکند.
- همیشه ادامه دهید: عامل برای درخواست مجوز اجرای جاوا اسکریپت در مرورگر متوقف نمیشود. این ویژگی به عامل حداکثر استقلال را برای انجام اقدامات پیچیده و اعتبارسنجی در مرورگر میدهد، اما همچنین بیشترین میزان آسیبپذیری را در برابر سوءاستفادههای امنیتی دارد.
- درخواست بررسی: عامل همیشه برای درخواست مجوز اجرای کد جاوا اسکریپت در مرورگر، متوقف میشود.
- غیرفعال: عامل هرگز کد جاوا اسکریپت را در مرورگر اجرا نخواهد کرد.
حالا که سیاستهای مختلف را درک کردهایم، ۴ گزینه سمت چپ چیزی جز تنظیمات خاص برای اجرای ترمینال، بررسی و سیاستهای اجرای جاوا اسکریپت برای ۳ مورد از آنها نیستند و گزینه چهارم در دسترس است که میتوانیم آن را کاملاً سفارشی کنترل کنیم. این ۴ گزینه در دسترس هستند تا بتوانیم انتخاب کنیم که چه میزان استقلال میخواهید به عامل بدهید تا دستورات را در ترمینال اجرا کند و قبل از ادامه کار، مصنوعات را بررسی کند.
این ۴ گزینه عبارتند از:
- حالت امن : حالت امن، کنترلهای امنیتی پیشرفتهای را برای عامل فراهم میکند و به شما امکان میدهد دسترسی آن را به منابع خارجی و عملیات حساس محدود کنید. وقتی حالت امن فعال است، چندین اقدام امنیتی برای محافظت از محیط شما اعمال میشود.
- توسعه مبتنی بر بررسی (توصیه میشود) : نماینده مرتباً درخواست بررسی میکند.
- توسعه مبتنی بر عامل : عامل هرگز درخواست بررسی نخواهد کرد.
- پیکربندی سفارشی
گزینه توسعه مبتنی بر بررسی، تعادل خوبی ایجاد میکند و گزینه پیشنهادی است، زیرا به عامل اجازه میدهد تا تصمیمی بگیرد و برای تأیید به کاربر مراجعه کند.
صفحه بعدی، صفحه تنظیمات ویرایشگر شماست که در آن میتوانید تنظیمات برگزیده خود را برای موارد زیر انتخاب کنید:
- کلیدهای ترکیبی: کلیدهای ترکیبی خود را پیکربندی کنید.
- افزونهها: افزونههای زبان محبوب و سایر افزونههای پیشنهادی را نصب کنید.
- خط فرمان: ابزار خط فرمان را برای باز کردن Antigravity با
agyنصب کنید.
اکنون، شما آماده ورود به گوگل هستید. همانطور که قبلاً ذکر شد، Antigravity در حالت پیشنمایش و در صورت داشتن حساب کاربری جیمیل شخصی رایگان است. اکنون با حساب کاربری خود وارد شوید. این کار مرورگر را باز میکند و به شما امکان ورود میدهد. در صورت موفقیتآمیز بودن احراز هویت، پیامی مشابه پیام زیر مشاهده خواهید کرد و شما را به برنامه Antigravity هدایت میکند. با روند پیش بروید.
در نهایت، شرایط استفاده . میتوانید تصمیم بگیرید که آیا میخواهید عضو شوید یا خیر و سپس روی Next کلیک کنید.
این شما را به لحظه حقیقت هدایت میکند، جایی که ضد جاذبه منتظر همکاری با شما خواهد بود.
۳. مدیر عامل
ما آمادهایم تا شروع کنیم!
آنتیگراویتی (Antigravity) از پایه و اساس متنباز ویژوال استودیو کد (VS Code) منشعب شده است، اما تجربه کاربری را به طور اساسی تغییر میدهد تا مدیریت عامل را بر ویرایش متن اولویت دهد. رابط کاربری به دو پنجره اصلی مجزا تقسیم شده است: Editor و Agent Manager ). این تفکیک دغدغهها، تمایز بین مشارکت فردی و مدیریت مهندسی را منعکس میکند.
مدیر عامل: کنترل ماموریت
پس از اجرای Antigravity، کاربر معمولاً نه با یک درخت فایل، بلکه با Agent Manager، همانطور که در زیر نشان داده شده است، مواجه میشود:
این رابط کاربری به عنوان یک داشبورد Mission Control عمل میکند. این رابط برای هماهنگی سطح بالا طراحی شده است و به توسعهدهندگان اجازه میدهد تا چندین عامل را که به صورت غیرهمزمان در فضاهای کاری یا وظایف مختلف کار میکنند، ایجاد، نظارت و با آنها تعامل داشته باشند.
در این دیدگاه، توسعهدهنده به عنوان یک معمار عمل میکند. او اهداف سطح بالا را تعریف میکند، مثالها میتوانند موارد زیر باشند:
- ماژول احراز هویت را بازسازی کنید
- درخت وابستگی را بهروزرسانی کنید
- ایجاد یک مجموعه آزمایشی برای API صورتحساب
همانطور که نمودار بالا نشان میدهد، هر یک از این درخواستها یک نمونه عامل اختصاصی ایجاد میکند. رابط کاربری، تجسمی از این جریانهای کاری موازی را ارائه میدهد و وضعیت هر عامل، مصنوعاتی که تولید کردهاند (طرحها، نتایج، تفاوتها) و هرگونه درخواست در انتظار تأیید انسانی را نمایش میدهد.
این معماری، محدودیت کلیدی IDEهای قبلی را که بیشتر تجربه چتبات داشتند و خطی و همزمان بودند، برطرف میکند. در یک رابط چت سنتی، توسعهدهنده باید منتظر بماند تا هوش مصنوعی تولید کد را تمام کند و سپس سوال بعدی را بپرسد. در نمای مدیر Antigravity، یک توسعهدهنده میتواند پنج عامل مختلف را برای کار بر روی پنج اشکال مختلف به طور همزمان اعزام کند و به طور مؤثر توان عملیاتی خود را چند برابر کند.
اگر روی Next در بالا کلیک کنید، میتوانید یک فضای کاری باز کنید.
فضای کاری را همانطور که از VS Code میدانستید در نظر بگیرید و کار تمام است. بنابراین میتوانیم با کلیک روی دکمه و سپس انتخاب یک پوشه برای شروع، یک پوشه محلی را باز کنیم. در مورد من، پوشهای در پوشه خانهام به نام my-agy-projects داشتم و آن را انتخاب کردم. شما میتوانید از یک پوشه کاملاً متفاوت استفاده کنید. توجه داشته باشید، در صورت تمایل میتوانید این مرحله را کاملاً نادیده بگیرید و میتوانید بعداً هر زمان که خواستید یک فضای کاری باز کنید.
پس از تکمیل این مرحله، در پنجره Agent Manager قرار خواهید گرفت که در زیر نشان داده شده است:
متوجه خواهید شد که برنامه بلافاصله برای شروع یک مکالمه جدید در پوشه فضای کاری ( my-agy-projects ) که انتخاب شده است، آماده میشود. میتوانید از دانش موجود خود در مورد کار با سایر برنامههای هوش مصنوعی (Cursor، Gemini CLI) استفاده کنید و @ و روشهای دیگر برای افزودن زمینه اضافی هنگام درخواست استفاده کنید.
به هر دو منوی کشویی Planning و Model Selection نگاهی بیندازید. منوی کشویی انتخاب مدل به شما امکان میدهد یکی از مدلهای موجود در حال حاضر را برای استفاده نماینده خود انتخاب کنید. لیست در زیر نشان داده شده است:
به طور مشابه، متوجه میشویم که عامل در حالت Planning پیشفرض قرار دارد. اما میتوانیم حالت Fast ) را نیز انتخاب کنیم.
بیایید ببینیم اسناد در این مورد چه میگویند:
-
Planning: یک عامل میتواند قبل از اجرای وظایف، برنامهریزی کند. برای تحقیقات عمیق، وظایف پیچیده یا کار مشارکتی استفاده میشود. در این حالت، عامل کار خود را در گروههای کاری سازماندهی میکند، مصنوعات تولید میکند و مراحل دیگری را برای تحقیق کامل، تفکر و برنامهریزی کار خود برای کیفیت مطلوب انجام میدهد. در اینجا خروجی بسیار بیشتری خواهید دید. -
Fast: یک عامل وظایف را مستقیماً اجرا میکند. برای وظایف سادهای که میتوانند سریعتر انجام شوند، مانند تغییر نام متغیرها، شروع چند دستور bash یا سایر وظایف کوچکتر و محلی، استفاده میشود. این برای زمانی مفید است که سرعت یک عامل مهم است و وظیفه به اندازه کافی ساده است که نگرانی کمی از کیفیت پایین وجود دارد.
اگر با بودجه تفکر و اصطلاحات مشابه در نمایندگان آشنا هستید، این را به عنوان توانایی کنترل تفکر نماینده در نظر بگیرید، در نتیجه تأثیر مستقیمی بر بودجه تفکر خواهد داشت. فعلاً با پیشفرضها پیش میرویم، اما به یاد داشته باشید که در زمان عرضه، موجودی مدل Gemini 3 Pro برای همه محدود است، بنابراین انتظار پیامهای مناسبی را داشته باشید که نشان میدهد آیا سهمیههای رایگان برای استفاده از Gemini 3 را تمام کردهاید یا خیر.
بیایید کمی وقت صرف بررسی پنجرهی Agent Manager کنیم و چند نکته را بررسی کنیم تا اجزای اصلی، نحوهی پیمایش در Antigravity و موارد دیگر برایتان روشن شود. پنجرهی Agent Manager در زیر نمایش داده شده است:
لطفاً به نمودار بالا با اعداد مراجعه کنید:
-
Inbox: این را به عنوان راهی برای پیگیری تمام مکالمات خود در یک مکان در نظر بگیرید. وقتی شما مامورین را برای انجام وظایفشان اعزام میکنید، این وظایف در صندوق ورودی ظاهر میشوند و میتوانید روی صندوق ورودی کلیک کنید تا لیستی از تمام مکالمات فعلی را مشاهده کنید. ضربه زدن روی هر یک از مکالمات، شما را به تمام پیامهای رد و بدل شده، وضعیت وظایف، آنچه مامور تولید کرده است یا حتی اینکه آیا منتظر تأیید شما برای وظایف است یا خیر، هدایت میکند. این یک راه عالی برای بازگشت به وظیفه قبلی است که روی آن کار میکردید. یک ویژگی بسیار مفید. -
Start Conversation: برای شروع مکالمه جدید روی این کلیک کنید. این کار شما را مستقیماً به ورودی هدایت میکند که در آن نوشته شده استAsk anything. -
Workspaces: ما در مورد فضاهای کاری و اینکه میتوانید در هر فضای کاری که میخواهید کار کنید، اشاره کردیم. میتوانید در هر زمانی فضاهای کاری بیشتری اضافه کنید و هنگام شروع مکالمه، هر فضای کاری را انتخاب کنید. -
Playground: این یک روش عالی است که میتوانید به سادگی با نماینده گفتگو کنید و سپس اگر مایلید آن را به یک فضای کاری تبدیل کنید، جایی که کنترل دقیقتری روی فایلها و غیره دارید. این را به عنوان یک منطقه آزمایشی در نظر بگیرید. -
Editor View: تاکنون در نمای مدیر عامل هستیم. در صورت تمایل میتوانید هر زمان که خواستید به نمای ویرایشگر بروید. این به شما پوشه فضای کاری و هر فایل تولید شده را نشان میدهد. میتوانید مستقیماً فایلها را در آنجا ویرایش کنید، یا حتی راهنماییهای درون خطی، دستور را در ویرایشگر ارائه دهید تا عامل بتواند طبق توصیهها/دستورالعملهای اصلاح شده شما کاری انجام دهد یا تغییر دهد. نمای ویرایشگر را در بخش بعدی به تفصیل پوشش خواهیم داد. -
Browser: در نهایت، به یکی از وجوه تمایز آشکاری میرسیم که Antigravity را بسیار قدرتمند میکند و آن ادغام نزدیک آن با مرورگر کروم است. بیایید در بخش بعدی به تنظیمات مرورگر بپردازیم.
۴. مرورگر ضد جاذبه
طبق مستندات ، وقتی عامل میخواهد با مرورگر تعامل داشته باشد، یک زیرعامل مرورگر را برای انجام وظیفه مورد نظر فراخوانی میکند. زیرعامل مرورگر مدلی را اجرا میکند که مخصوص کار روی صفحاتی است که در مرورگر مدیریتشده توسط Antigravity باز هستند، که با مدلی که برای عامل اصلی انتخاب کردهاید متفاوت است.
این subagent به ابزارهای متنوعی که برای کنترل مرورگر شما ضروری هستند، از جمله کلیک کردن، اسکرول کردن، تایپ کردن، خواندن لاگهای کنسول و موارد دیگر، دسترسی دارد. همچنین میتواند صفحات باز شما را از طریق ضبط DOM، اسکرینشات یا تجزیه markdown و همچنین فیلمبرداری بخواند.
این یعنی باید افزونه مرورگر Antigravity را اجرا و نصب کنیم. بیایید این کار را با شروع یک مکالمه در Playground و طی کردن مراحل انجام دهیم.
Playground انتخاب کنید و وظیفه زیر go to antigravity.google مامور بدهید، همانطور که در زیر نشان داده شده است:
وظیفه را ارسال کنید . خواهید دید که عامل، وظیفه را تجزیه و تحلیل میکند و میتوانید روند کار را بررسی کنید. در مقطعی، به درستی ادامه میدهد و ذکر میکند که باید عامل مرورگر را مطابق شکل زیر تنظیم کند. روی Setup کلیک کنید.
این کار مرورگر را باز میکند و پیامی برای نصب افزونه نمایش میدهد، همانطور که در زیر نشان داده شده است:
ادامه دهید و به افزونه کروم هدایت خواهید شد که میتوانید آن را نصب کنید.
پس از نصب موفقیتآمیز افزونه، Antigravity Agent شروع به کار میکند و اعلام میکند که از شما اجازه انجام وظیفهاش را میخواهد. باید در پنجره مرورگر باز شده، فعالیتهایی را مشاهده کنید:
نمای Agent Manager را به حالت قبل برگردانید و باید موارد زیر را ببینید:
این دقیقاً همان چیزی بود که انتظار داشتیم اتفاق بیفتد، زیرا از مامور خواستیم که به وبسایت antigravity.google مراجعه کند. به او اجازه دهید و خواهید دید که وبسایت به طور ایمن، همانطور که در زیر نشان داده شده است، هدایت میشود:
۵. مصنوعات
آنتیگراویتی همزمان با برنامهریزی و انجام کار خود، مصنوعاتی (Artifacts) ایجاد میکند تا از این طریق بتواند کارش را به کاربر انسانی منتقل کند و از او بازخورد بگیرد. این مصنوعات شامل فایلهای نشانهگذاری غنی، نمودارهای معماری، تصاویر، ضبطهای مرورگر، تفاوتهای کد و غیره هستند.
مصنوعات «شکاف اعتماد» را حل میکنند. وقتی یک عامل ادعا میکند «من اشکال را برطرف کردهام» توسعهدهنده قبلاً مجبور بود کد را برای تأیید بخواند. در Antigravity، عامل یک مصنوع تولید میکند تا آن را اثبات کند.
اینها مصنوعات اصلی تولید شده توسط Antigravity هستند:
-
Task Lists: قبل از نوشتن کد، عامل یک طرح ساختاریافته ایجاد میکند. معمولاً نیازی به ویرایش این طرح نیست، اما میتوانید آن را بررسی کنید و در برخی موارد، در صورت نیاز، برای تغییر آن، نظر اضافه کنید. -
Implementation Plan: این طرح برای معماری تغییرات در کدبیس شما برای انجام یک کار استفاده میشود. این طرحها حاوی جزئیات فنی در مورد اصلاحات لازم هستند و قرار است توسط کاربر بررسی شوند، مگر اینکه سیاست بررسی مصنوعات خود را روی «همیشه ادامه دهید» تنظیم کرده باشید. -
Walkthrough: این راهنما پس از تکمیل پیادهسازی وظیفه توسط عامل، به عنوان خلاصهای از تغییرات و نحوه آزمایش آنها ایجاد میشود. -
Code diffs: اگرچه از نظر فنی یک مصنوع محسوب نمیشوند، اما Antigravity تفاوتهای کدی نیز تولید میکند که میتوانید آنها را بررسی کرده و در موردشان نظر دهید. -
Screenshots: عامل، وضعیت رابط کاربری را قبل و بعد از تغییر ثبت میکند. -
Browser Recordings: برای تعاملات پویا (مثلاً «روی دکمه ورود کلیک کنید، منتظر چرخنده باشید، بارگذاری داشبورد را تأیید کنید»)، عامل ویدئویی از جلسه خود ضبط میکند. توسعهدهنده میتواند این ویدئو را تماشا کند تا تأیید کند که نیاز عملکردی بدون اجرای خود برنامه برآورده شده است.
مصنوعات تولید میشوند و در هر دو نمای مدیر عامل و ویرایشگر ظاهر میشوند.
در نمای ویرایشگر، در گوشه پایین سمت راست، میتوانید روی Artifacts کلیک کنید:
در نمای مدیر عامل، در بالا سمت راست، کنار Review changes ، باید بتوانید دکمهای را برای تغییر وضعیت مصنوعات ببینید یا اگر روشن باشد، میتوانید لیست مصنوعات تولید شده را مشاهده کنید:
شما باید نمای Artifacts را مطابق شکل زیر ببینید. در مورد ما، ما به Agent دستور دادیم که از صفحه antigravity.google بازدید کند و از این رو، از صفحه عکس گرفته و ویدیویی از آن ساخته است:
میتوانید تفاوتهای کد را در بخش Review Changes در نمای ویرایشگر مشاهده کنید:
توسعهدهندگان میتوانند با استفاده از «نظرات به سبک Google Docs» با این مصنوعات و تفاوتهای کد تعامل داشته باشند. شما میتوانید یک اقدام یا وظیفه خاص را انتخاب کنید، دستوری را به روشی که میخواهید ارائه دهید و سپس آن را به عامل ارسال کنید. سپس عامل این بازخورد را دریافت کرده و بر اساس آن تکرار میکند. به استفاده از Google Docs تعاملی فکر کنید، جایی که شما بازخورد را به نویسنده ارائه میدهید و نویسنده سپس آن را تکرار میکند.
۶. صندوق ورودی را دوباره بررسی کنید
اگر چند مکالمه با نمایندگان شروع کردهاید، اکنون باید نگاهی به Inbox خود در پنجره Agent Manager بیندازید. این همه مکالمات را به شما نشان میدهد. برای مشاهده تاریخچه آن مکالمه، مصنوعات تولید شده و موارد دیگر، روی هر یک از مکالمات کلیک کنید. در مورد ما، پس از اجرای اولین مکالمه، صندوق ورودی ما مکالمه فهرست شده را نشان میدهد، همانطور که در زیر نشان داده شده است:
با کلیک بر روی آن مکالمه، جزئیات آن را مشاهده خواهید کرد:
از اینجا هم میتوانید بحث را ادامه دهید.
۷. ویرایشگر
این ویرایشگر، حس آشنایی با VS Code را حفظ کرده و تضمین میکند که از حافظهی توسعهدهندگان باتجربه استفاده شود. این ویرایشگر شامل مرورگر فایل استاندارد، هایلایت سینتکس و اکوسیستم افزونهها میشود.
شما میتوانید روی دکمهی Open Editor که در بالا سمت راست در «مدیر عامل» قرار دارد کلیک کنید تا به ویرایشگر بروید.
راهاندازی و افزونهها
در یک تنظیم معمولی، ویرایشگر، ترمینال و عامل را در معرض دید خواهید داشت:
اگر اینطور نیست، میتوانید پنلهای ترمینال و عامل را به صورت زیر تغییر دهید:
- برای تغییر وضعیت پنل ترمینال، از میانبر
Ctrl + `استفاده کنید. - برای تغییر وضعیت پنل اپراتور، از میانبر
Cmd + Lاستفاده کنید.
علاوه بر این، Antigravity میتواند برخی افزونهها را در طول راهاندازی نصب کند، اما بسته به زبان برنامهنویسی که استفاده میکنید، احتمالاً باید افزونههای بیشتری نصب کنید. به عنوان مثال، برای توسعه پایتون، این افزونههایی هستند که میتوانید نصب کنید:
ویرایشگر
تکمیل خودکار
همانطور که کد را در ویرایشگر تایپ میکنید، یک تکمیل خودکار هوشمند فعال میشود که میتوانید به سادگی با کلیک کردن روی آن، کد را وارد کنید:
تب برای وارد کردن
شما تبی برای وارد کردن پیشنهاد برای اضافه کردن وابستگیهای از دست رفته دریافت میکنید:
برای پرش، تب بزنید
شما با استفاده از تب، پیشنهادهایی برای پرش دریافت میکنید تا مکاننما را به مکان منطقی بعدی در کد ببرید:
دستورات
شما میتوانید با استفاده از Cmd + I در ویرایشگر یا ترمینال، دستورات را برای تکمیل درونخطی با استفاده از زبان طبیعی اجرا کنید.
در ویرایشگر، میتوانید روشی برای محاسبه اعداد فیبوناچی درخواست کنید و سپس آن را بپذیرید یا رد کنید:
در ترمینال، میتوانید پیشنهادهای دستور ترمینال را دریافت کنید:
پنل کناری نماینده
از ویرایشگر، میتوانید پنل کناری نماینده را به روشهای مختلف تغییر دهید.
باز شدن دستی
شما میتوانید با استفاده از میانبر Cmd + L پنل اپراتور را در سمت راست به صورت دستی تغییر دهید.
میتوانید شروع به پرسیدن سوال کنید، از @ برای اضافه کردن زمینههای بیشتر مانند فایلها، دایرکتوریها، سرورهای MCP استفاده کنید، یا از / برای ارجاع به یک گردش کار (یک اعلان ذخیره شده) استفاده کنید:
همچنین میتوانید بین دو حالت مکالمه یکی را انتخاب کنید: Fast یا Planning :
برای کارهای سریع Fast توصیه میشود، در حالی که برای کارهای پیچیدهتر که در آنها نماینده، طرحی را ایجاد میکند که شما میتوانید آن را تأیید کنید، Planning توصیه میشود.
همچنین میتوانید مدلهای مختلفی را برای مکالمه انتخاب کنید:
توضیح و رفع اشکال
راه دیگر برای فعال کردن عامل، بردن ماوس روی یک مشکل و انتخاب گزینه Explain and fix است:
ارسال مشکلات به نماینده
همچنین میتوانید به بخش Problems بروید و گزینه Send all to Agent انتخاب کنید تا نماینده سعی در رفع آن مشکلات داشته باشد:
ارسال خروجی ترمینال به اپراتور
شما حتی میتوانید بخشی از خروجی ترمینال را انتخاب کرده و با Cmd + L آن را برای اپراتور ارسال کنید:
جابجایی بین ویرایشگر و مدیر عامل
در هر لحظه، میتوانید از طریق دکمه Open Agent Manager در بالا سمت راست، وقتی در حالت ویرایشگر هستید، بین حالت ویرایشگر و حالت مدیریت کامل عامل جابجا شوید و وقتی در حالت مدیریت عامل هستید، با کلیک روی دکمه Open Editor در بالا سمت راست، به حالت قبل برگردید.
همچنین، میتوانید از میانبر صفحهکلید Cmd + E برای تغییر بین این دو حالت استفاده کنید.
۸. بازخورد ارائه دهید
در قلب Antigravity، توانایی آن در جمعآوری آسان بازخورد شما در هر مرحله از تجربه نهفته است. همانطور که عامل روی یک کار کار میکند، در طول مسیر مصنوعات مختلفی ایجاد میکند:
- یک طرح اجرایی و یک لیست وظایف (قبل از کدنویسی)
- تفاوتهای کد (هنگام تولید کد)
- یک بررسی اجمالی برای تأیید نتایج (پس از کدنویسی)
این مصنوعات راهی برای Antigravity هستند تا برنامهها و پیشرفتهای خود را به اشتراک بگذارند. مهمتر از آن، آنها همچنین راهی برای شما هستند تا در قالب نظرات به سبک Google docs به عامل بازخورد دهید. این امر برای هدایت مؤثر عامل در جهتی که میخواهید بسیار مفید است.
بیایید سعی کنیم یک برنامه ساده برای فهرست کارها بسازیم و ببینیم چگونه میتوانیم در طول مسیر به Antigravity بازخورد ارائه دهیم.
حالت برنامهریزی
ابتدا باید مطمئن شوید که Antigravity در حالت Planning (به جای حالت Fast ) قرار دارد. میتوانید این حالت را در چت پنل کناری اپراتور انتخاب کنید. این کار باعث میشود که Antigravity قبل از شروع کدنویسی، یک برنامه پیادهسازی و یک لیست وظایف ایجاد کند. سپس، یک اعلان، چیزی شبیه به این را امتحان کنید: Create a todo list web app using Python . این کار اپراتور را برای شروع برنامهریزی و تولید یک برنامه پیادهسازی، فعال میکند.
طرح اجرایی
یک طرح اجرایی، مروری بر آنچه Antigravity قصد انجام آن را دارد، فناوریهای مورد استفاده آن و شرحی سطح بالا از تغییرات پیشنهادی است.
Implementation Plan - Python Todo App
Goal
Create a simple, functional, and aesthetically pleasing Todo List web application using Python (Flask).
Tech Stack
Backend: Python with Flask
Frontend: HTML5, CSS3 (Vanilla), Jinja2 templates
...
این همچنین اولین جایی است که میتوانید بازخورد خود را ارائه دهید. در مورد ما، عامل میخواهد از Flask به عنوان چارچوب وب پایتون استفاده کند. میتوانیم یک نظر به طرح پیادهسازی اضافه کنیم تا به جای آن از FastAPI استفاده کند. پس از افزودن نظر، یا نظر را ارسال کنید یا از Antigravity بخواهید که طرح پیادهسازی بهروز شده را Proceed .
فهرست وظایف
پس از بهروزرسانی طرح پیادهسازی، Antigravity یک لیست وظایف ایجاد میکند. این یک لیست مشخص از مراحلی است که Antigravity برای ایجاد و تأیید برنامه دنبال خواهد کرد.
Task Plan
Create requirements.txt
Create directory structure (static/css, templates)
Create static/css/style.css
Create templates/index.html
Create main.py with FastAPI setup and Database logic
Verify application
این دومین جایی است که میتوانید بازخورد ارائه دهید.
برای مثال، در مورد استفاده ما، میتوانید با اضافه کردن کامنت زیر، دستورالعملهای تأیید دقیقتری اضافه کنید: Verify application by adding, editing, and deleting a todo item and taking a screenshot.
تغییرات کد
در این مرحله، Antigravity تعدادی کد در فایلهای جدید تولید میکند. شما میتوانید بدون بررسی جزئیات، Reject all این تغییرات را در پنل کناری چت اپراتور Accept all یا رد کنید.
همچنین میتوانید روی Review changes کلیک کنید تا جزئیات تغییرات را ببینید و نظرات دقیقی در مورد کد اضافه کنید. برای مثال، میتوانیم نظر زیر را در main.py اضافه کنیم: Add basic comments to all methods
این یک روش عالی برای تکرار کد با Antigravity است.
پیاده روی
وقتی Antigravity کدنویسیاش تمام شد، سرور را اجرا میکند، یک مرورگر باز میکند تا برنامه را تأیید کند. این برنامه برخی آزمایشهای دستی مانند اضافه کردن وظایف، بهروزرسانی وظایف و غیره را انجام میدهد. همه اینها به لطف افزونه مرورگر Antigravity است. در نهایت، یک فایل راهنما ایجاد میکند تا خلاصهای از کارهایی که برای تأیید برنامه انجام داده است را ارائه دهد. این شامل یک اسکرینشات یا یک جریان تأیید با ضبط مرورگر است.
شما میتوانید در مورد اسکرینشات یا ویدیوی ضبطشده توسط مرورگر در راهنمای گامبهگام نیز نظر بدهید. برای مثال، میتوانیم یک نظر اضافه کنیم Change the blue theme to orange theme و آن را ارسال کنیم. پس از ارسال نظر، Antigravity تغییرات را اعمال میکند، نتایج را تأیید میکند و راهنمای گامبهگام را بهروزرسانی میکند.
لغو تغییرات
در آخر، اگر بعد از هر مرحله از تغییر راضی نبودید، میتوانید آن را از چت لغو کنید. کافیست تا Undo changes up to this point .
۹. قوانین و گردشهای کاری
آنتیگراویتی با چند گزینه سفارشیسازی ارائه میشود: قوانین و گردشهای کاری .
در حالت ویرایشگر ، روی ... در گوشه بالا سمت راست کلیک کنید و Customizations انتخاب کنید، Rules و Workflows مشاهده خواهید کرد:
قوانین به هدایت رفتار عامل کمک میکنند. اینها دستورالعملهایی هستند که میتوانید ارائه دهید تا مطمئن شوید عامل هنگام تولید کد و آزمایشها از آنها پیروی میکند. به عنوان مثال، ممکن است بخواهید عامل از یک سبک کد خاص پیروی کند یا همیشه روشها را مستند کند. میتوانید این موارد را به عنوان قوانین اضافه کنید و عامل آنها را در نظر میگیرد.
گردشهای کاری، اعلانهای ذخیرهشدهای هستند که میتوانید در صورت نیاز با / ، هنگام تعامل با عامل، آنها را فعال کنید. آنها همچنین رفتار عامل را هدایت میکنند، اما توسط کاربر در صورت نیاز فعال میشوند.
یک قیاس خوب این است که قوانین بیشتر شبیه دستورالعملهای سیستمی هستند در حالی که گردشهای کاری بیشتر شبیه اعلانهای ذخیرهشدهای هستند که میتوانید بنا به تقاضا انتخاب کنید.
هر دوی قوانین و گردشهای کاری میتوانند به صورت سراسری یا برای هر فضای کاری اعمال شوند و در مکانهای زیر ذخیره شوند:
- قانون سراسری:
~/.gemini/GEMINI.md - گردش کار سراسری:
~/.gemini/antigravity/global_workflows/global-workflow.md - قوانین فضای کاری:
your-workspace/.agent/rules/ - گردشهای کاری فضای کاری:
your-workspace/.agent/workflows/
بیایید چند قانون و گردش کار به فضای کاری اضافه کنیم.
یک قانون اضافه کنید
ابتدا، بیایید یک قانون سبک کد اضافه کنیم. به Rules بروید و دکمه +Workspace را انتخاب کنید. نامی مانند code-style-guide با قوانین سبک کد زیر به آن بدهید:
* Make sure all the code is styled with PEP 8 style guide
* Make sure all the code is properly commented
دوم، بیایید یک قانون دیگر اضافه کنیم تا مطمئن شویم کد به صورت ماژولار و با مثالهایی در یک قانون code-generation-guide تولید میشود:
* The main method in main.py is the entry point to showcase functionality.
* Do not generate code in the main method. Instead generate distinct functionality in a new file (eg. feature_x.py)
* Then, generate example code to show the new functionality in a new method in main.py (eg. example_feature_x) and simply call that method from the main method.
دو قانون ذخیره و آماده هستند:
اضافه کردن گردش کار
همچنین بیایید یک گردش کار برای تولید تستهای واحد تعریف کنیم. این به ما امکان میدهد تا پس از رضایت از کد، تستهای واحد را آغاز کنیم (به جای اینکه عامل دائماً تستهای واحد تولید کند).
به Workflows بروید و دکمه +Workspace را انتخاب کنید. نامی مانند generate-unit-tests به آن بدهید و موارد زیر را در آن وارد کنید:
* Generate unit tests for each file and each method
* Make sure the unit tests are named similar to files but with test_ prefix
گردش کار نیز اکنون آماده است:
امتحانش کن.
حالا بیایید قوانین و گردشهای کاری را در عمل ببینیم. یک فایل main.py به صورت اسکلتبندی در فضای کاری خود ایجاد کنید:
def main():
pass
if __name__ == "__main__":
main()
حالا، به پنجره چت کارشناس بروید و از کارشناس بپرسید: Implement binary search and bubble sort.
بعد از یک یا دو دقیقه، باید سه فایل در فضای کاری داشته باشید: main.py ، bubble_sort.py ، binary_search.py . همچنین متوجه خواهید شد که تمام قوانین پیادهسازی شدهاند: فایل اصلی شلوغ نیست و کد نمونه را دارد، هر ویژگی در فایل مخصوص به خود پیادهسازی شده است، تمام کدها مستندسازی شده و با سبک خوبی نوشته شدهاند:
from binary_search import binary_search, binary_search_recursive
from bubble_sort import bubble_sort, bubble_sort_descending
def example_binary_search():
"""
Demonstrate binary search algorithm with various test cases.
"""
...
def example_bubble_sort():
"""
Demonstrate bubble sort algorithm with various test cases.
"""
...
def main():
"""
Main entry point to showcase functionality.
"""
example_binary_search()
example_bubble_sort()
print("\n" + "=" * 60)
if __name__ == "__main__":
main()
حالا که از کد راضی هستیم، بیایید ببینیم آیا میتوانیم گردش کار تست واحد تولید را فعال کنیم یا خیر.
به چت بروید و شروع به تایپ کردن /generate و Antigravity از قبل از روند کار ما مطلع است:
گزینه generate-unit-tests انتخاب کرده و enter را بزنید. پس از چند ثانیه، فایلهای جدیدی در فضای کاری خود دریافت خواهید کرد: test_binary_search.py ، test_bubble_sort.py با تعدادی تست که از قبل پیادهسازی شدهاند!
قشنگه!
۱۰. مهارتها
اگرچه مدلهای زیربنایی Antigravity (مانند Gemini) مدلهای عمومی قدرتمندی هستند، اما از زمینه پروژه خاص شما یا استانداردهای تیم اطلاعی ندارند. بارگذاری تک تک قوانین یا ابزارها در پنجره زمینه عامل منجر به "انباشت ابزار"، هزینههای بالاتر، تأخیر و سردرگمی میشود.
مهارتهای ضدجاذبه این مشکل را از طریق افشای تدریجی حل میکنند. یک مهارت ، بستهای تخصصی از دانش است که تا زمان نیاز، غیرفعال میماند. این مهارت تنها زمانی در زمینهی عامل بارگذاری میشود که درخواست خاص شما با شرح مهارت مطابقت داشته باشد.
ساختار و دامنه
مهارتها بستههای مبتنی بر دایرکتوری هستند. میتوانید بسته به نیاز خود، آنها را در دو حوزه تعریف کنید:
- محدوده سراسری (
~/.gemini/antigravity/skills/): در تمام پروژههای شما (مثلاً "Format JSON"، "General Code Review") موجود است. - محدوده فضای کاری (
<workspace-root>/.agent/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 را ایجاد کنیم که شامل فرادادهها و دستورالعملهای مهارتها خواهد بود. بیایید یک مهارت سراسری ایجاد کنیم که جزئیاتی را در اختیار عامل قرار دهد تا تغییرات کد را برای اشکالات، مشکلات سبک و بهترین شیوهها بررسی کند.
ابتدا، دایرکتوریای را ایجاد کنید که شامل این مهارت سراسری باشد.
mkdir -p ~/.gemini/antigravity/skills/code-review
یک فایل SKILL.md در دایرکتوری بالا با محتوای نشان داده شده در زیر ایجاد کنید:
---
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 بالا شامل فراداده (نام و توضیحات) در بالا و سپس دستورالعملها است. Agent هنگام بارگذاری، فقط فرادادههای مربوط به مهارتهایی را که پیکربندی کردهاید میخواند و دستورالعملهای مربوط به مهارت را، تنها در صورت نیاز، بارگذاری میکند.
امتحانش کن.
یک فایل با نام demo_bad_code.py با محتویات زیر ایجاد کنید:
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()
از نماینده بپرسید: review the @demo_bad_code.py file . نماینده باید مهارت code-review را شناسایی کند، جزئیات را بارگذاری کند و سپس طبق دستورالعملهای داده شده در فایل code-review/SKILL.md اقدام را انجام دهد.
یک نمونه خروجی در زیر نشان داده شده است:
مهارت قالب هدر کد
گاهی اوقات یک مهارت نیاز به استفاده از یک بلوک بزرگ از متن ثابت (مانند سربرگ مجوز) دارد. قرار دادن این متن مستقیماً در اعلان، اتلاف وقت است. در عوض، ما آن را در یک پوشه resources/ قرار میدهیم و به عامل دستور میدهیم که فقط در صورت لزوم آن را بخواند.
ابتدا، دایرکتوری را ایجاد کنید که شامل این مهارت فضای کاری باشد.
mkdir -p .agent/skills/license-header-adder/resources
.agent/skills/license-header-adder/resources/HEADER.txt را با متن لایسنس خود ایجاد کنید:
/*
* Copyright (c) 2026 YOUR_COMPANY_NAME LLC.
* All rights reserved.
* This code is proprietary and confidential.
*/
یک فایل .agent/skills/license-header-adder/SKILL.md با محتویات زیر ایجاد کنید:
---
name: license-header-adder
description: Adds the standard corporate license header to new source files.
---
# License Header Adder
This skill ensures that all new source files have the correct copyright header.
## Instructions
1. **Read the Template**: Read the content of `resources/HEADER.txt`.
2. **Apply to File**: When creating a new file, prepend this exact content.
3. **Adapt Syntax**:
- For C-style languages (Java, TS), keep the `/* */` block.
- For Python/Shell, convert to `#` comments.
امتحانش کن.
از نماینده موارد زیر را بپرسید: Create a new Python script named data_processor.py that prints 'Hello World'.
عامل، قالب را میخواند، نظرات به سبک C را به سبک پایتون تبدیل میکند و آنها را به طور خودکار به فایل جدید شما اضافه میکند.
By creating these skills, you have effectively turned the generalist Gemini model into a specialist for your project. You have codified your best practices, whether it's following your code review guidelines or license headers. Instead of repeatedly prompting the AI to "remember to add the license" or "fix the commit format," the agent now instinctively knows how to work on your team.
11. Securing the Agent
Giving an AI agent access to your terminal and browser is a double-edged sword. It enables autonomous debugging and deployment but also opens vectors for Prompt Injection and Data Exfiltration.
Antigravity addresses this through a granular permission system revolving around Terminal Command Auto Execution policies, Allow Lists, and Deny Lists.
When you first configure Antigravity, or via the settings menu, you must select a Terminal Command Auto Execution policy. This setting dictates the agent's autonomy regarding shell commands.
You can view your current settings for this by going to Antigravity — Settings , then Advanced Settings . You should see the Terminal section for the Agent settings. Keep this table in mind, should you want to change this setting to something else:
Policy Mode | توضیحات |
خاموش | The agent never auto-executes terminal commands unless explicitly allowed. |
خودکار | The agent decides whether to execute based on internal safety models. It asks for permission for risky commands. |
توربو | The agent always auto-executes commands unless explicitly denied. |
Configuring the Allow List
The Allow List is used primarily with the Off policy. It represents a positive security model, meaning everything is forbidden unless expressly permitted. This is the most secure configuration.
Step-by-Step Configuration
- Set the Terminal Command Auto Execution setting to Off .
- Add the following command in the Allow List Terminal Commands by clicking on the Add button next to it :
ls -al. You can add other terminal commands too, if you'd like.
Testing the Allow List
- Ask the agent:
List the files in this directory. - The agent runs
lsautomatically. - Ask the agent:
Delete the <some file> - The agent will attempt
rm <filepath>, but Antigravity will block it and force a user review becausermis not in the allow list. You should have Antigravity asking you for permission before running the command.
Configuring the Deny List
The Deny List is the safeguard for the Turbo (and sometimes Auto ) policy. It represents a negative security model, meaning everything is allowed unless expressly forbidden. This relies on the developer anticipating every possible danger, which is a risky proposition, but one that offers maximum speed.
Step-by-Step Configuration
- Set the Terminal Command Auto Execution setting to Turbo .
- Add the following commands in the Deny List Terminal Commands by clicking on the Add button next to it.
- رم
- سودو
- حلقه زدن
- دستور wget
Testing the Deny List
- Ask the agent:
Check the version of python. - The agent runs
python --versionautomatically. - Ask the agent:
Downloadwww.google.comhome page. - The agent attempts to
curl. Antigravity detectscurlin the denylist and blocks execution, prompting you for manual approval.
Browser Security
Antigravity's ability to browse the web is a superpower, but also a vulnerability. An agent visiting a compromised documentation site could encounter a prompt injection attack.
To help prevent this, you can implement a Browser URL Allowlist for the browser agent.
You can view your current settings for this by going to Antigravity — Settings and then Advanced Settings . You should see the Browser URL Allowlist section for the Browser settings as shown below:
Click on the Open Allowlist File and that opens up the file in the folder HOME/.gemini/antigravity/browserAllowlist.txt. You can ensure that only trusted domains are entered over here.
12. Conclusion and Next Steps
Congratulations! You have now successfully installed Antigravity, configured your environment, and learned how to control your agents.
What's Next? To see Antigravity in action building real-world applications, you can look at the following codelabs:
- Building with Google Antigravity : This codelab shows how to build several applications including a dynamic conference website and a productivity app.
- Build and Deploy to Google Cloud with Antigravity : This codelab shows how to design, build, and deploy a serverless application to Google Cloud.
Reference docs
- Official Site : https://antigravity.google/
- Documentation: https://antigravity.google/docs
- Usecases : https://antigravity.google/use-cases
- Download : https://antigravity.google/download
- Youtube Channel for Google Antigravity : https://www.youtube.com/@googleantigravity