Antigravity Google چیست؟ آموزش نصب و اجرای اولین Agent

تحول ابزارهای Coding AI از پیشنهاد ساده کد به Agentهایی رسیده است که می‌توانند برنامه‌ریزی، ویرایش، اجرای دستور و تست را به‌صورت خودکار انجام دهند. در این جریان تازه، Antigravity به‌عنوان پلتفرم توسعه First‑Agent گوگل معرفی می‌شود؛ محیطی که امکان ساخت و اجرای Agent های هوشمند را فراهم می‌کند. در این مقاله توضیح داده می‌شود Google Antigravity چیست و چگونه نسخه مناسب را انتخاب کنید، مراحل نصب را انجام دهید، تنظیمات امنیتی را فعال کنید و اولین Task را با یک Agent اجرا کنید تا چرخه توسعه هوشمند را تجربه کنید.

Google Antigravity چیست و چگونه کار می کند؟

یک پلتفرم توسعه First‑Agent است که جریان کاری برنامه‌نویسی را از حالت IDE سنتی و ابزارهای صرفاً Autocomplete، به یک روند کاملاً هوشمند و مرحله‌به‌مرحله تبدیل می‌کند. در این مدل، Agent هدف را دریافت می‌کند، پروژه را بررسی می‌کند، یک Plan برای اعمال تغییرات می‌سازد، ابزارهای لازم را اجرا می‌کند، تست‌ها را انجام می‌دهد و در پایان یک Artifact قابل‌استفاده ارائه می‌دهد. همین ساختار باعث می‌شود توسعه‌دهنده به‌جای انجام دستی مراحل، نقش هدایت‌کننده داشته باشد و بخش عمده کار را Agent انجام دهد. در این توضیح مشخص می‌شود Google Antigravity چیست و چرا رویکرد آن با IDE های کلاسیک متفاوت است.

• دریافت هدف: Agent هدف کاربر را تحلیل می‌کند
• بررسی پروژه: فایل‌ها و ساختار پروژه ارزیابی می‌شود
• تهیه Plan: مراحل دقیق تغییرات طراحی می‌شود
• اجرای ابزار و تست: اعمال تغییرات، اجرای دستورات و تست خودکار
• ارائه Artifact: خروجی نهایی تولید و نمایش داده می‌شود

Agent Manager و Artifact چه کاربردی دارند؟

Agent Manager بخش مرکزی مدیریت در Antigravity است؛ جایی که می‌توان Agentها را ایجاد کرد، وضعیت آن‌ها را دید، پروژه‌ها را مدیریت کرد و جریان اجرای Taskها را کنترل نمود. در مقابل، Artifact خروجی قابل‌بررسی Agent است؛ یعنی هر چیزی که Agent تولید می‌کند: از Plan و کد تا Diff، تصویر، نتیجه تست یا گزارش اجرا. نقش Artifact این است که توسعه‌دهنده بتواند عملکرد Agent را مرحله‌به‌مرحله بررسی و تأیید کند. گوگل Antigravity محیطی ارائه می‌دهد که Agent در ادیتور، ترمینال و مرورگر کار می‌کند و نتیجه را به‌صورت Artifactهای قابل‌بررسی نمایش می‌دهد.

• Agent Manager: ایجاد، مشاهده و مدیریت Agentها و پروژه‌ها
• Artifact: خروجی‌هایی مانند Plan، کد، Diff، تست و گزارش اجرا
• کنترل Agent: بررسی و تأیید مرحله‌به‌مرحله عملکرد Agent
• جریان کاری Antigravity: اجرای Agent در ادیتور، ترمینال و مرورگر همراه با Artifactهای قابل‌بررسی

کدام نسخه Google Antigravity برای شما مناسب است؟

برای انتخاب نسخه مناسب، باید بدانید هر بخش از Antigravity چه نقشی دارد. Antigravity 2.0 برای هدایت و هماهنگ‌کردن Agentها طراحی شده و جریان کامل First‑Agent را مدیریت می‌کند. Antigravity IDE امکان توسعه مستقیم در محیط ویرایشگر را می‌دهد. CLI برای اجرای Taskها از ترمینال مناسب است و IDE Extensions راهی برای استفاده از قابلیت‌های Antigravity داخل محیط‌هایی مثل Vs code فراهم می‌کنند. این جدول کمک می‌کند نسخه مناسب را بر اساس نیازتان انتخاب کنید.

جدول مقایسه نسخه‌ها

Agent Manager و Artifact چه کاربردی دارند؟

Agent Manager بخش مرکزی مدیریت در Antigravity است؛ جایی که می‌توان Agentها را ایجاد کرد، وضعیت آن‌ها را دید، پروژه‌ها را مدیریت کرد و جریان اجرای Taskها را کنترل نمود. در مقابل، Artifact خروجی قابل‌بررسی Agent است؛ یعنی هر چیزی که Agent تولید می‌کند: از Plan و کد تا Diff، تصویر، نتیجه تست یا گزارش اجرا. نقش Artifact این است که توسعه‌دهنده بتواند عملکرد Agent را مرحله‌به‌مرحله بررسی و تأیید کند. گوگل Antigravity محیطی ارائه می‌دهد که Agent در ادیتور، ترمینال و مرورگر کار می‌کند و نتیجه را به‌صورت Artifactهای قابل‌بررسی نمایش می‌دهد.

• Agent Manager: ایجاد، مشاهده و مدیریت Agentها و پروژه‌ها
• Artifact: خروجی‌هایی مانند Plan، کد، Diff، تست و گزارش اجرا
• کنترل Agent : بررسی و تأیید مرحله‌به‌مرحله عملکرد Agent
• جریان کاری Antigravity: اجرای Agent در ادیتور، ترمینال و مرورگر همراه با Artifactهای قابل‌بررسی

مدل‌ها، پلن‌ها و هزینه Google Antigravity

پلن‌های Google Antigravity بر پایه پلن‌های Google AI ارائه می‌شوند. تا ۱۳ اکتبر ۲۰۲۶ یک پلن فردی رایگان و چند پلن پولی وجود دارد که تفاوتشان در محدودیت مصرف و سطح دسترسی به مدل‌ها است. صفحه رسمی اکنون مدل‌هایی از خانواده Gemini، Claude و OSS‑GPT را نشان می‌دهد؛ اما این فهرست و سقف مصرف ممکن است تغییر کند.

جدول کوتاه پلن‌ها

آموزش دانلود و نصب Google Antigravity

برای نصب Google Antigravity باید ابتدا پیش‌نیازها را آماده کنید: یک حساب گوگل واجد شرایط، اتصال اینترنت پایدار، سیستم‌عامل پشتیبانی‌شده (Windows، macOS یا Linux) و بهتر است Git از قبل نصب باشد تا مدیریت پروژه‌ها روان‌تر انجام شود. نسخه دسکتاپ برای هر سه سیستم‌عامل ارائه شده و پس از نصب، Workspace به‌صورت یک محیط یکپارچه برای اجرای Agentها در اختیار شما قرار می‌گیرد.

مراحل نصب

۱. ورود به صفحه دانلود Antigravity

۲. انتخاب نسخه مناسب برای Windows / macOS / Linux

۳. اجرای فایل نصب و تکمیل مراحل Setup

۴. ورود با حساب گوگل برای فعال‌سازی محیط

۵. انتخاب پوشه پروژه و ساخت Workspace اولیه

۶. باز کردن محیط و اجرای اولین Agent در ادیتور یا ترمینال

نصب CLI یا افزونه VS Code

برای استفاده از Google Antigravity دو مسیر رایج وجود دارد: نصب CLI برای کار در ترمینال و نصب افزونه رسمی در VS Code. هر دو روش امکان اجرای Agentها را فراهم می‌کنند، اما CLI برای کاربران حرفه‌ای مناسب‌تر است و افزونه برای کسانی که می‌خواهند داخل محیط ویرایشگر کار کنند. برای جلوگیری از طولانی‌شدن مقاله، فقط مراحل اصلی آموزش داده می‌شود.

مسیر اول: نصب CLI

۱. ورود به صفحه دانلود CLI

۲. انتخاب نسخه مناسب برای سیستم‌عامل

۳. اجرای فایل نصب

۴. اجرای دستور اولیه برای فعال‌سازی:

antigravity init

۵. ورود با حساب گوگل و آماده‌سازی Workspace

مسیر دوم: نصب افزونه VS Code

۱. باز کردن VS Code

۲. جست‌وجوی افزونه Antigravity در بخش Extensions

۳. نصب افزونه رسمی

۴. ورود با حساب گوگل

۵. انتخاب پوشه پروژه و شروع کار با Agent ها

تنظیمات امنیتی قبل از اجرای Agent

پیش از اجرای هر Agent در Antigravity باید مطمئن شوید که سطح دسترسی‌ها کنترل‌شده است. Agent می‌تواند به فایل‌ها، ترمینال، شبکه، مرورگر و MCP دسترسی داشته باشد و خروجی‌های خود را به‌صورت Artifact ارائه دهد؛ بنابراین بررسی امنیتی ضروری است. تازه‌کارها بهتر است پروژه را داخل Git نگه دارند، فقط پوشه پروژه را در اختیار Agent قرار دهند، تأیید دستی دستورات حساس را فعال بگذارند و کلیدهای API را محافظت کنند. نقش Artifact در این مرحله کلیدی است، چون امکان بازبینی و تأیید هر اقدام Agent را فراهم می‌کند.

جدول تنظیمات امنیتی

چک‌لیست امنیتی پیشنهادی

• قرار دادن پروژه در Git: امکان بازگشت و کنترل تغییرات
• محدود کردن Workspace: فقط پوشه پروژه
• تأیید دستورات حساس: جلوگیری از اجرای ناخواسته
• محافظت از API Key: استفاده از فایل‌های محیطی
• بررسی Artifact: تأیید هر مرحله قبل از اعمال

Turbo Mode آیا امن است؟

Turbo یک حالت دسترسی گسترده در Antigravity است؛ یعنی وقتی فعال می‌شود، Agent می‌تواند در بخش‌های بیشتری از سیستم خواندن و نوشتن انجام دهد. این حالت برای همه پروژه‌ها مناسب نیست و طبق مستندات، گسترش Permissionها می‌تواند ریسک ایجاد تغییرات ناخواسته را افزایش دهد. بنابراین Turbo باید فقط زمانی فعال شود که پروژه نیاز به سرعت بالا و دسترسی وسیع دارد. تفاوت سیستم‌عامل‌ها نیز مهم است: در Windows سطح دسترسی فایل‌ها و ترمینال معمولاً بازتر است، در macOS محدودیت‌های امنیتی سخت‌گیرانه‌تر وجود دارد و در Linux کنترل دسترسی‌ها کاملاً وابسته به تنظیمات کاربر و سطح Permission هاست.

جدول کوتاه امنیت Turbo Mode

اجرای اولین پروژه با Google Antigravity (Quick Start عملی)

برای شروع کار عملی با Antigravity بهتر است یک پروژه کوچک و واقعی انتخاب شود؛ مثلاً رفع خطای اعتبارسنجی یک API. در این مسیر، Agent تمام مراحل را با Plan، Diff، Artifact و تست هدایت می‌کند و شما فقط تصمیم‌گیرنده هستید. این بخش عملی‌ترین قسمت مقاله است و دقیقاً نشان می‌دهد چرخه First‑Agent چگونه در عمل کار می‌کند.

مراحل اجرای اولین پروژه

۱. باز کردن پروژه

پوشه پروژه را در Antigravity انتخاب کنید تا Workspace ساخته شود.

۲. ساخت شاخه Git

اجرای دستور git checkout -b fix/api-validation برای کنترل تغییرات.

۳. تعریف Task

مثال: رفع خطای اعتبارسنجی ورودی در endpoint /login.

۴. درخواست Plan

Agent ساختار پروژه را بررسی کرده و یک Plan مرحله‌به‌مرحله ارائه می‌دهد.

۵. بازبینی Plan

بررسی کنید که تغییرات پیشنهادی دقیقاً همان چیزی باشد که می‌خواهید.

۶. اجازه اجرای تغییرات

با تأیید شما، Agent تغییرات را اعمال می‌کند.

۷. مشاهده Diff

فایل‌های تغییر یافته، خطوط اضافه/حذف‌شده و اصلاحات نمایش داده می‌شود.

۸. اجرای تست

Agent تست‌ها را اجرا می‌کند تا مطمئن شوید خطا رفع شده است.

۹. Commit نهایی

پس از تأیید Artifact، تغییرات را Commit کنید:

git commit -m “Fix: API validation error”

Prompt نمونه برای اولین Agent

برای ساخت اولین Agent، باید پرامپتی داشته باشید که هدف، محدوده فایل‌ها، محدودیت تغییرات، معیار موفقیت، اجرای تست و توقف قبل از تغییرات حساس را مشخص کند. این ساختار باعث می‌شود Agent دقیقاً همان کاری را انجام دهد که شما می‌خواهید و هیچ تغییری خارج از کنترل ایجاد نشود. نمونه زیر یک پرامپت عملی برای رفع خطای اعتبارسنجی endpoint ثبت‌نام است.

پرامپت نمونه (کادر قابل کپی)

`

هدف: خطای اعتبارسنجی endpoint ثبت‌نام را بررسی و رفع کن.

محدوده فایل‌ها: فقط فایل‌های پوشه auth را تغییر بده.

محدودیت‌ها: ساختار دیتابیس تغییر نکند؛ فایل‌های خارج از Workspace دستکاری نشود.

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

مراحل: ابتدا Plan بده؛ قبل از هر تغییر منتظر تأیید من بمان؛ پس از اعمال تغییرات، تست‌ها را اجرا کن.

خروجی: در پایان Diff را خلاصه کن و Artifact نهایی را ارائه بده.

`

نکته‌های کلیدی

• هدف دقیق باعث می‌شود Agent مسیر را درست انتخاب کند.
• محدوده فایل‌ها از تغییرات ناخواسته جلوگیری می‌کند.
• معیار موفقیت کیفیت خروجی را تضمین می‌کند.
• توقف قبل از تغییرات حساس امنیت پروژه را بالا می‌برد.
• خلاصه Diff بررسی سریع تغییرات را ممکن می‌کند.

چگونه خروجی Agent را بررسی کنیم؟

برای ارزیابی خروجی یک Agent در Antigravity باید تمام مراحل تولید Artifact را دقیق و مرحله‌به‌مرحله بررسی کنید. موفق‌بودن تست‌ها به‌تنهایی کافی نیست؛ چون ممکن است تغییرات ناامن، خارج از محدوده یا ناسازگار با معماری پروژه اعمال شده باشد. بنابراین باید Plan، فایل‌های تغییرکرده، Diff، دستورات اجراشده، نتیجه تست‌ها و محتوای Artifact را با دقت کنترل کنید و مطمئن شوید هیچ اطلاعات محرمانه در خروجی ظاهر نشده است.

جدول بررسی خروجی Agent

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

• Plan را تأیید کنید: قبل از هر تغییر
• Diff را خط‌به‌خط بخوانید: مخصوصاً بخش‌های امنیتی
• تست‌ها را دوباره اجرا کنید: فقط موفقیت Agent کافی نیست
• Artifact را کامل مرور کنید: گزارش‌ها، لاگ‌ها، تغییرات
• اطلاعات حساس را بررسی کنید: جلوگیری از نشت داده

محدودیت‌ها و مشکلات رایج Antigravity

کار با Antigravity بسیار قدرتمند است، اما مانند هر ابزار First‑Agent مجموعه‌ای از محدودیت‌ها و چالش‌های رایج دارد که باید از ابتدا بشناسید. این موارد معمولاً به اینترنت، کیفیت پرامپت، سطح دسترسی، مصرف Quota و بررسی‌نکردن خروجی‌ها مربوط می‌شوند. همچنین طبق صفحات پشتیبانی فعلی، استفاده برای افراد بالای ۱۸ سال و دستورهای انگلیسی اعلام شده است.

• نیاز به اینترنت: اجرای Agent بدون اتصال پایدار ممکن نیست.
• اشتباه احتمالی Agent: ممکن است Plan اشتباه بدهد یا فایل نامربوط را تغییر دهد.
• مصرف Quota: اجرای Taskهای سنگین سهمیه مدل‌ها را سریع مصرف می‌کند.
• پرامپت مبهم: باعث تغییرات ناخواسته یا Plan غیرمرتبط می‌شود.
• اعطای دسترسی زیاد: Turbo یا دسترسی خارج از Workspace می‌تواند خطرناک باشد.
• استفاده بدون Git: نبود نسخه‌سازی امکان بازگشت از تغییرات را سخت می‌کند.
• بررسی‌نکردن Diff: خطر اعمال تغییرات ناامن یا ناسازگار با پروژه.
• محدودیت زبان دستورها: فعلاً دستورهای انگلیسی بهترین عملکرد را دارند.
• شرط سنی حساب: صفحات رسمی استفاده را برای افراد بالای ۱۸ سال اعلام کرده‌اند.

خطای Location و دسترسی از ایران

در صورت بروز Location Error هنگام استفاده از Google Antigravity، معمولاً مشکل به کشور یا منطقه ثبت‌شده برای حساب گوگل و فهرست رسمی مناطق پشتیبانی‌شده برمی‌گردد. دسترسی به سرویس وابسته است به این‌که حساب شما در یکی از مناطق مجاز ثبت شده باشد و سیستم موقعیت شما را مطابق همان Region تشخیص دهد. اگر احساس می‌کنید منطقه‌تان اشتباه تشخیص داده شده یا به‌صورت نادرست روی کشوری غیرپشتیبانی‌شده تنظیم شده است، باید از مسیر رسمی اصلاح Region در تنظیمات حساب گوگل و مستندات پشتیبانی استفاده کنید. هرگونه روش غیررسمی یا دورزدن محدودیت‌ها توصیه نمی‌شود و لازم است فهرست کشورها و مناطق پشتیبانی‌شده در زمان انتشار مقاله دوباره بررسی شود.

جمع‌بندی

Antigravity یک محیط توسعه هوشمند است که فراتر از یک ادیتور کدنویسی عمل می‌کند و چرخه کامل هدایت Agentها را مدیریت می‌کند. در این جمع‌بندی توضیح داده می‌شود Google Antigravity چیست و چرا بهترین تجربه زمانی به‌دست می‌آید که سرعت Agent با Git، محدودسازی Permission، تعریف دقیق Plan و بازبینی انسانی ترکیب شود. این پلتفرم با ارائه Artifactهای قابل‌بررسی، امکان کنترل تغییرات و جلوگیری از خطاهای ناخواسته را فراهم می‌کند و توسعه‌دهنده را در نقش هدایت‌کننده قرار می‌دهد تا Agent کارهای پیچیده را انجام دهد. برای کسب اطلاعات بیشتر در این زمینه و یا دریافت مشاوره می‌توانید از وب سایت منتووب کمک بگیرید.

سوالات متداول:

۱. آیا Antigravity Google رایگان است؟

Antigravity یک پلن رایگان فردی دارد که امکان اجرای Agentها را فراهم می‌کند، اما مصرف آن محدود است و سهمیه مدل‌ها ممکن است در آینده تغییر کند. برای استفاده سنگین یا پروژه‌های بزرگ باید پلن‌های پولی را بررسی کرد. همیشه صفحه رسمی را برای Quota و مدل‌های قابل‌دسترسی چک کنید.

۲. آیا Antigravity Google در ویندوز، مک و لینوکس نصب می‌شود؟

بله، نسخه دسکتاپ Antigravity برای Windows، macOS و Linux ارائه شده است. نصب آن نیازمند سیستم‌عاملی سازگار، اینترنت پایدار و رعایت حداقل نیازمندی‌های رسمی است. کاربران باید نسخه مناسب سیستم خود را از صفحه رسمی دانلود کنند و مراحل نصب استاندارد را دنبال کنند.

۳. تفاوت Antigravity 2.0 ، IDE و CLI چیست؟

Antigravity 2.0 برای هدایت و هماهنگ‌سازی Agentهاست، IDE محیط کامل توسعه با ادیتور داخلی ارائه می‌دهد و CLI اجرای Taskها را از ترمینال ممکن می‌کند. انتخاب نسخه به سبک کاری شما بستگی دارد: کنترل ترمینالی، محیط گرافیکی یا مدیریت پیشرفته Agentها.

۴. آیا می‌توان از Antigravity Google در Vs code استفاده کرد؟

بله، افزونه رسمی Antigravity برای VS Code منتشر شده است. این افزونه قابلیت اجرای Agentها را داخل محیط ویرایشگر فراهم می‌کند، اما نسخه دسکتاپ امکانات بیشتری مثل Workspace کامل، ترمینال داخلی و مدیریت پروژه دارد. افزونه برای توسعه سریع داخل VS Code مناسب است.

۵. آیا استفاده از Antigravity برای پروژه‌های واقعی امن است؟

امنیت Antigravity مشروط است. اگر Permissionها محدود شوند، Secretها محافظت شوند، پروژه تحت Git باشد و Diff هر تغییر دقیق بررسی شود، می‌توان از آن در پروژه‌های واقعی استفاده کرد. Agent قدرتمند است، اما کنترل انسانی و بازبینی مرحله‌به‌مرحله برای جلوگیری از خطاهای ناخواسته ضروری است.