Google Antigravity का इस्तेमाल शुरू करना

1. परिचय

इस कोडलैब में, आपको Google Antigravity के बारे में जानकारी मिलेगी. यह एक एजेंटिक डेवलपमेंट प्लैटफ़ॉर्म है, जो आईडीई को एजेंट-फ़र्स्ट एरा में बदल रहा है.

स्टैंडर्ड कोडिंग असिस्टेंट सिर्फ़ लाइनों को अपने-आप पूरा करते हैं. हालांकि, Antigravity में "मिशन कंट्रोल" की सुविधा मिलती है. इसकी मदद से, अपने-आप काम करने वाले एजेंट मैनेज किए जा सकते हैं. ये एजेंट, आपके प्रोजेक्ट को प्लान कर सकते हैं, कोड कर सकते हैं, और यहां तक कि वेब ब्राउज़ करके भी आपकी मदद कर सकते हैं.

Antigravity को एजेंट-फ़र्स्ट प्लैटफ़ॉर्म के तौर पर डिज़ाइन किया गया है. इससे यह पता चलता है कि एआई सिर्फ़ कोड लिखने का टूल नहीं है, बल्कि यह अपने-आप काम करने वाला एक ऐसा एजेंट है जो इंजीनियरिंग से जुड़े मुश्किल टास्क को प्लान कर सकता है, उन्हें पूरा कर सकता है, उनकी पुष्टि कर सकता है, और उन्हें दोहरा सकता है. इसके लिए, उसे इंसान की कम से कम मदद की ज़रूरत होती है.

आपको क्या सीखने को मिलेगा

  • Antigravity को इंस्टॉल और कॉन्फ़िगर करना.
  • Antigravity के मुख्य कॉन्सेप्ट के बारे में जानकारी. जैसे, एजेंट मैनेजर, एडिटर, ब्राउज़र वगैरह.
  • सुरक्षा से जुड़ी बातों के साथ-साथ, अपने नियमों और वर्कफ़्लो के हिसाब से Antigravity को पसंद के मुताबिक बनाना.

आपको इन चीज़ों की ज़रूरत होगी

फ़िलहाल, Antigravity की सुविधा निजी Gmail खातों के लिए उपलब्ध है. इसमें प्रीमियर मॉडल इस्तेमाल करने के लिए, मुफ़्त कोटा मिलता है.

Antigravity को आपके सिस्टम पर स्थानीय तौर पर इंस्टॉल किया जाना चाहिए. यह प्रॉडक्ट Mac, Windows, और Linux के कुछ वर्शन पर उपलब्ध है. अपने कंप्यूटर के अलावा, आपको इन चीज़ों की ज़रूरत होगी:

  • Chrome वेब ब्राउज़र.
  • Gmail खाता (निजी Gmail खाता).

यह कोडलैब, सभी लेवल के उपयोगकर्ताओं और डेवलपर के लिए बनाया गया है.

समस्याओं की शिकायत करना

कोडलैब और Antigravity का इस्तेमाल करते समय, आपको समस्याएं आ सकती हैं.

कोडलैब से जुड़ी समस्याओं (टाइपोग्राफ़िकल गड़बड़ियां, गलत निर्देश) के लिए, कृपया इस कोडलैब के नीचे बाएं कोने में मौजूद Report a mistake बटन पर क्लिक करके, बग की रिपोर्ट करें:

b06b582bcd847f6d.png

Antigravity से जुड़ी गड़बड़ियों या सुविधाओं के अनुरोध के लिए, कृपया Antigravity में समस्या की रिपोर्ट करें. इसके लिए, Agent Manager में जाकर सबसे नीचे बाएं कोने में मौजूद Provide Feedback लिंक पर क्लिक करें:

281ac826fb44d427.png

इसके अलावा, अपनी प्रोफ़ाइल के आइकॉन के नीचे मौजूद Report Issue लिंक पर क्लिक करके भी एडिटर पर जाया जा सकता है:

e8afd782a8f92129.png

2. इंस्टॉल करना

अगर आपने Antigravity पहले से इंस्टॉल नहीं किया है, तो चलिए इसे इंस्टॉल करते हैं. फ़िलहाल, यह प्रॉडक्ट प्रीव्यू के तौर पर उपलब्ध है. इसका इस्तेमाल शुरू करने के लिए, अपने निजी Gmail खाते का इस्तेमाल किया जा सकता है.

डाउनलोड किए गए वीडियो पेज पर जाएं. पक्का करें कि आपने अपने ऑपरेटिंग सिस्टम के लिए, v1.23.2 या इससे कम वर्शन डाउनलोड किया हो. इससे ऊपर का वर्शन डाउनलोड न करें, क्योंकि वह प्रॉडक्ट अलग है और इस कोडलैब में इस्तेमाल किए गए प्रॉडक्ट से अलग तरीके से काम करता है.

ऐप्लिकेशन इंस्टॉलर लॉन्च करें और उसे अपने कंप्यूटर पर इंस्टॉल करें. इंस्टॉल करने के बाद, Antigravity ऐप्लिकेशन लॉन्च करें. आपको इस तरह की स्क्रीन दिखेगी:

29fada39721093c.png

कृपया हर बार Next पर क्लिक करके आगे बढ़ें. यहाँ मुख्य चरणों के बारे में बताया गया है:

  • सेटअप फ़्लो चुनें: इससे आपको अपनी मौजूदा VS Code या Cursor सेटिंग इंपोर्ट करने का विकल्प मिलता है. हम नए सिरे से शुरुआत करेंगे.
  • एडिटर के लिए थीम टाइप चुनें: हम गहरे रंग वाली थीम का इस्तेमाल करेंगे, लेकिन यह पूरी तरह से आप पर निर्भर करता है.
  • आपको Antigravity एजेंट का इस्तेमाल कैसे करना है?

7ca55560ec377130.png

आइए, इसे थोड़ा और विस्तार से समझते हैं. ध्यान रखें कि Antigravity की उपयोगकर्ता सेटिंग (Linux/Windows: Ctrl + , Mac: Cmd + ,) में जाकर, सेटिंग को कभी भी बदला जा सकता है.

विकल्पों के बारे में जानने से पहले, आइए कुछ खास प्रॉपर्टी (जो आपको डायलॉग बॉक्स के दाईं ओर दिखती हैं) पर नज़र डालें.

टर्मिनल एक्ज़ीक्यूशन से जुड़ी नीति

इसका मतलब है कि एजेंट को आपके टर्मिनल में कमांड (ऐप्लिकेशन/टूल) चलाने की अनुमति देना:

  • हमेशा आगे बढ़ें: टर्मिनल कमांड हमेशा अपने-आप लागू होती हैं. हालांकि, कॉन्फ़िगर की जा सकने वाली अस्वीकार सूची में मौजूद कमांड अपने-आप लागू नहीं होती हैं.
  • समीक्षा का अनुरोध करें: टर्मिनल कमांड चलाने से पहले, उपयोगकर्ता से समीक्षा करने और मंज़ूरी लेने का अनुरोध करें.

समीक्षा की नीति

एजेंट, टास्क पूरा करते समय कई आर्टफ़ैक्ट बनाता है. जैसे, टास्क प्लान, लागू करने का प्लान वगैरह. समीक्षा करने की नीति इस तरह से सेट की जाती है कि यह तय किया जा सके कि समीक्षा करने का फ़ैसला कौन करेगा. क्या आपको हमेशा इसकी समीक्षा करनी है या एजेंट को यह तय करने देना है. इसलिए, यहां भी तीन विकल्प दिए गए हैं.

  • हमेशा आगे बढ़ें: एजेंट कभी भी समीक्षा के लिए नहीं कहता.
  • एजेंट तय करेगा: एजेंट यह तय करेगा कि समीक्षा के लिए कब अनुरोध करना है.
  • समीक्षा का अनुरोध करना: एजेंट हमेशा समीक्षा का अनुरोध करता है.

JavaScript को चलाने से जुड़ी नीति

इस सुविधा को चालू करने पर, एजेंट ब्राउज़र टूल का इस्तेमाल करके यूआरएल खोल सकता है, वेब पेज पढ़ सकता है, और ब्राउज़र के कॉन्टेंट से इंटरैक्ट कर सकता है. इस नीति से यह कंट्रोल किया जाता है कि ब्राउज़र में JavaScript कैसे काम करे.

  • हमेशा आगे बढ़ें: एजेंट, ब्राउज़र में JavaScript चलाने की अनुमति मांगने के लिए नहीं रुकेगा. इससे एजेंट को ब्राउज़र में मुश्किल कार्रवाइयां करने और पुष्टि करने की ज़्यादा से ज़्यादा स्वतंत्रता मिलती है. हालांकि, इससे सुरक्षा से जुड़ी गड़बड़ियों का खतरा भी सबसे ज़्यादा होता है.
  • समीक्षा का अनुरोध करें: एजेंट, ब्राउज़र में JavaScript कोड चलाने की अनुमति मांगने के लिए हमेशा रुकेगा.
  • बंद है: एजेंट, ब्राउज़र में कभी भी JavaScript कोड नहीं चलाएगा.

अब जब हमने अलग-अलग नीतियों के बारे में जान लिया है, तो बाईं ओर दिए गए चार विकल्प, टर्मिनल एक्ज़ीक्यूशन, समीक्षा, और JavaScript एक्ज़ीक्यूशन की नीतियों के लिए खास सेटिंग के अलावा कुछ और नहीं हैं. इनमें से तीन के लिए, चौथा विकल्प उपलब्ध है. इसमें हम इसे पूरी तरह से कस्टम कंट्रोल कर सकते हैं. ये चार विकल्प इसलिए उपलब्ध हैं, ताकि हम यह चुन सकें कि आपको टर्मिनल में कमांड चलाने और टास्क को आगे बढ़ाने से पहले आर्टफ़ैक्ट की समीक्षा कराने के लिए, एजेंट को कितना कंट्रोल देना है.

ये चार विकल्प हैं:

  • सुरक्षित मोड: सुरक्षित मोड, एजेंट के लिए बेहतर सुरक्षा कंट्रोल उपलब्ध कराता है. इससे, एजेंट के बाहरी संसाधनों और संवेदनशील कार्रवाइयों के ऐक्सेस को सीमित किया जा सकता है. सुरक्षित मोड चालू होने पर, आपके एनवायरमेंट को सुरक्षित रखने के लिए कई सुरक्षा उपाय लागू किए जाते हैं.
  • समीक्षा के आधार पर डेवलपमेंट (सुझाया गया): एजेंट बार-बार समीक्षा करने के लिए कहेगा.
  • एजेंट की मदद से डेवलपमेंट: एजेंट कभी भी समीक्षा करने के लिए नहीं कहेगा.
  • कस्टम कॉन्फ़िगरेशन

समीक्षा के आधार पर डेवलपमेंट विकल्प, एक अच्छा विकल्प है. साथ ही, हम इसे इस्तेमाल करने का सुझाव देते हैं. इसकी मदद से एजेंट, फ़ैसला ले सकता है और उपयोगकर्ता से मंज़ूरी लेने के लिए वापस आ सकता है.

इसके बाद, Editor को कॉन्फ़िगर करें सेटिंग पेज खुलता है. यहां अपनी पसंद के मुताबिक ये सेटिंग चुनी जा सकती हैं:

  • कीबोर्ड शॉर्टकट: कीबोर्ड शॉर्टकट को कॉन्फ़िगर किया जा सकता है.
  • एक्सटेंशन: भाषा और अन्य सुझाई गई सुविधाओं से जुड़े लोकप्रिय एक्सटेंशन इंस्टॉल किए जा सकते हैं.
  • कमांड लाइन: agy की मदद से Antigravity खोलने के लिए, कमांड लाइन टूल इंस्टॉल किया जा सकता है.

अब Google में साइन इन करें. जैसा कि पहले बताया गया है, Antigravity को प्रीव्यू मोड में इस्तेमाल किया जा सकता है. अगर आपके पास निजी Gmail खाता है, तो इसे मुफ़्त में इस्तेमाल किया जा सकता है. अब अपने खाते से साइन इन करें. इससे ब्राउज़र खुल जाएगा और आपको साइन इन करने का विकल्प मिलेगा. पुष्टि हो जाने के बाद, आपको नीचे दिए गए मैसेज जैसा मैसेज दिखेगा. इसके बाद, आपको वापस Antigravity ऐप्लिकेशन पर भेज दिया जाएगा. अपने हिसाब से काम करें.

आखिर में, इस्तेमाल की शर्तें. आपके पास यह तय करने का विकल्प होता है कि आपको इस सुविधा के लिए ऑप्ट-इन करना है या नहीं. इसके बाद, Next पर क्लिक करें.

इससे आपको सच्चाई का पता चलेगा. साथ ही, Antigravity आपके साथ मिलकर काम करने के लिए तैयार होगा.

3. एजेंट मैनेजर

हम शुरू करने के लिए तैयार हैं!

Antigravity, ओपन-सोर्स Visual Studio Code (VS Code) पर आधारित है. हालांकि, यह उपयोगकर्ता अनुभव को पूरी तरह से बदल देता है. इसमें टेक्स्ट में बदलाव करने के बजाय, एजेंट को मैनेज करने पर ज़्यादा ध्यान दिया जाता है. इंटरफ़ेस को दो अलग-अलग मुख्य विंडो में बांटा गया है: Editor और Agent Manager. यह, किसी व्यक्ति के योगदान और इंजीनियरिंग मैनेजमेंट के बीच के अंतर को दिखाता है.

एजेंट मैनेजर: मिशन कंट्रोल

Antigravity लॉन्च करने पर, उपयोगकर्ता को आम तौर पर फ़ोल्डर खोलें, एजेंट मैनेजर खोलें और क्लोन रिपॉज़िटरी का विकल्प दिखता है.

2afba3ba858adf03.png

यह एजेंट मैनेजर, मिशन कंट्रोल डैशबोर्ड के तौर पर काम करता है. इसे बेहतर तरीके से ऑर्केस्ट्रेशन के लिए डिज़ाइन किया गया है. इससे डेवलपर, अलग-अलग वर्कस्पेस या टास्क में एसिंक्रोनस तरीके से काम करने वाले कई एजेंट को स्पॉन, मॉनिटर, और उनके साथ इंटरैक्ट कर सकते हैं.

इस व्यू में, डेवलपर एक आर्किटेक्ट की तरह काम करता है. ये बड़े लक्ष्यों को तय करते हैं. उदाहरण के लिए:

  • पुष्टि करने वाले मॉड्यूल को फिर से फ़ैक्टर करना
  • डिपेंडेंसी ट्री को अपडेट करना
  • Billing API के लिए टेस्ट सुइट जनरेट करना

इनमें से हर अनुरोध के लिए, एजेंट का एक अलग इंस्टेंस शुरू होता है. यूज़र इंटरफ़ेस (यूआई) में, इन पैरलल वर्क स्ट्रीम को विज़ुअलाइज़ किया जाता है. इसमें हर एजेंट की स्थिति, उनके बनाए गए आर्टफ़ैक्ट (प्लान, नतीजे, अंतर) और इंसानों से मंज़ूरी पाने के लिए किए गए सभी लंबित अनुरोधों को दिखाया जाता है.

इस आर्किटेक्चर से, पिछले आईडीई की एक मुख्य समस्या हल हो जाती है. पिछले आईडीई में चैटबॉट की तरह काम करने की सुविधा होती थी. ये आईडीई, लीनियर और सिंक्रोनस होते थे. पारंपरिक चैट इंटरफ़ेस में, डेवलपर को अगला सवाल पूछने से पहले, एआई के कोड जनरेट करने का इंतज़ार करना पड़ता है. Antigravity के मैनेजर व्यू में, डेवलपर एक साथ पांच अलग-अलग एजेंट को पांच अलग-अलग बग पर काम करने के लिए भेज सकता है. इससे, डेवलपर की थ्रूपुट क्षमता बढ़ जाती है.

Open Folder पर क्लिक करने से, आपके पास कोई वर्कस्पेस खोलने का विकल्प होता है.

इसे VS Code में मौजूद वर्कस्पेस की तरह समझें. इसलिए, हम बटन पर क्लिक करके कोई लोकल फ़ोल्डर खोल सकते हैं. इसके बाद, शुरू करने के लिए कोई फ़ोल्डर चुनें. मेरे मामले में, मेरे होम फ़ोल्डर में my-agy-projects नाम का एक फ़ोल्डर था और मैंने उसे चुना. आपके पास किसी दूसरे फ़ोल्डर का इस्तेमाल करने का विकल्प होता है. ध्यान दें, अगर आपको यह चरण पूरा नहीं करना है, तो इसे स्किप किया जा सकता है. इसके अलावा, बाद में भी कोई वर्कस्पेस खोला जा सकता है.

यह चरण पूरा करने के बाद, आपको एजेंट मैनेजर विंडो दिखेगी. यह विंडो यहां दिखाई गई है:

156224e223eeda36.png

आपको दिखेगा कि ऐप्लिकेशन, चुने गए फ़ाइल फ़ोल्डर (my-agy-projects) में नई बातचीत शुरू करने के लिए तुरंत तैयार हो गया है. आपके पास अन्य एआई ऐप्लिकेशन (Cursor, Gemini CLI) के साथ काम करने का अनुभव है. इसलिए, आपको Gemini के साथ काम करने में आसानी होगी. साथ ही, प्रॉम्प्ट देते समय ज़्यादा जानकारी शामिल करने के लिए, @ और अन्य तरीकों का इस्तेमाल किया जा सकता है.

Model Selection ड्रॉपडाउन देखें. 'मॉडल चुनें' ड्रॉपडाउन की मदद से, अपने एजेंट के लिए फ़िलहाल उपलब्ध मॉडल में से कोई एक मॉडल चुना जा सकता है. सूची यहां दी गई है:

ca0b386cb97d1661.png

इसी तरह, हमें पता चलता है कि एजेंट डिफ़ॉल्ट रूप से Fast मोड में होगा. हालांकि, हम Plan मोड का भी इस्तेमाल कर सकते हैं.

b2b81488960677c2.png

आइए, देखते हैं कि इस बारे में दस्तावेज़ में क्या लिखा है:

  • Planning: एजेंट, टास्क पूरे करने से पहले प्लान बना सकता है. इसका इस्तेमाल, गहरी रिसर्च, मुश्किल टास्क या साथ मिलकर काम करने के लिए करें. इस मोड में, एजेंट अपने काम को टास्क ग्रुप में व्यवस्थित करता है, आर्टफ़ैक्ट बनाता है, और पूरी तरह से रिसर्च करने, सोचने, और अपने काम की योजना बनाने के लिए अन्य ज़रूरी कदम उठाता है, ताकि वह बेहतर क्वालिटी का काम कर सके. आपको यहां ज़्यादा आउटपुट दिखेगा.
  • Fast: एजेंट सीधे तौर पर टास्क पूरे करेगा. इसका इस्तेमाल ऐसे सामान्य कामों के लिए करें जिन्हें तेज़ी से पूरा किया जा सकता है. जैसे, वैरिएबल का नाम बदलना, कुछ बैश कमांड शुरू करना या अन्य छोटे-मोटे काम. यह तब मददगार होता है, जब स्पीड एक अहम फ़ैक्टर हो और काम इतना आसान हो कि क्वालिटी खराब होने की चिंता कम हो.

अगर आपको एजेंट में थिंकिंग बजट और इसी तरह के अन्य शब्दों के बारे में पता है, तो इसे एजेंट की सोच को कंट्रोल करने की क्षमता के तौर पर देखें. इससे थिंकिंग बजट पर सीधा असर पड़ता है. फ़िलहाल, हम डिफ़ॉल्ट सेटिंग का इस्तेमाल करेंगे. हालांकि, यह ध्यान रखें कि लॉन्च के समय, Gemini 3 Pro मॉडल की उपलब्धता सभी के लिए सीमित कोटा के हिसाब से होती है. इसलिए, आपको ऐसे मैसेज मिल सकते हैं जिनसे पता चलता है कि आपने Gemini 3 को इस्तेमाल करने के लिए, मुफ़्त कोटा खत्म कर दिया है.

अब हम यहां एजेंट मैनेजर (विंडो) के बारे में कुछ समय बात करेंगे और कुछ चीज़ों को समझेंगे, ताकि बुनियादी बिल्डिंग ब्लॉक के बारे में जानकारी मिल सके. साथ ही, यह भी पता चल सके कि Antigravity में कैसे नेविगेट किया जाता है और अन्य चीज़ें कैसे की जाती हैं. नीचे एजेंट मैनेजर विंडो दिखाई गई है:

eaba0c6ee17369e2.png

कृपया ऊपर दिए गए डायग्राम में दिए गए नंबर देखें:

  1. Start Conversation: नई बातचीत शुरू करने के लिए, इस पर क्लिक करें. इससे आपको सीधे उस इनपुट पर ले जाया जाएगा जहां Ask anything लिखा है.
  2. Workspaces: हमने फ़ाइल फ़ोल्डर के बारे में बताया है. साथ ही, यह भी बताया है कि आपके पास किसी भी फ़ाइल फ़ोल्डर में काम करने का विकल्प है. आपके पास किसी भी समय ज़्यादा वर्कस्पेस जोड़ने का विकल्प होता है. साथ ही, बातचीत शुरू करते समय कोई भी वर्कस्पेस चुना जा सकता है.
  3. Editor View: एडिटर व्यू पर कभी भी स्विच किया जा सकता है. इससे आपको अपना फ़ाइल फ़ोल्डर और जनरेट की गई कोई भी फ़ाइल दिखेगी. आपके पास सीधे तौर पर उन फ़ाइलों में बदलाव करने का विकल्प होता है. इसके अलावा, एडिटर में इनलाइन निर्देश या कमांड भी दी जा सकती है, ताकि एजेंट आपके बदले गए सुझावों/निर्देशों के मुताबिक कोई कार्रवाई कर सके या बदलाव कर सके. हम बाद के सेक्शन में, एडिटर व्यू के बारे में विस्तार से बताएंगे.

4. Antigravity Browser

दस्तावेज़ के मुताबिक, जब एजेंट को ब्राउज़र से इंटरैक्ट करना होता है, तो वह ब्राउज़र सब-एजेंट को चालू करता है, ताकि वह टास्क को पूरा कर सके. ब्राउज़र सब-एजेंट, Antigravity की ओर से मैनेज किए गए ब्राउज़र में खुले पेजों पर काम करने के लिए, खास तौर पर तैयार किए गए मॉडल का इस्तेमाल करता है. यह मॉडल, मुख्य एजेंट के लिए चुने गए मॉडल से अलग होता है.

इस सब-एजेंट के पास कई ऐसे टूल का ऐक्सेस होता है जो आपके ब्राउज़र को कंट्रोल करने के लिए ज़रूरी होते हैं. जैसे, क्लिक करना, स्क्रोल करना, टाइप करना, कंसोल लॉग पढ़ना वगैरह. यह खुले हुए पेजों को भी पढ़ सकता है. इसके लिए, यह DOM कैप्चर, स्क्रीनशॉट या मार्कडाउन पार्सिंग का इस्तेमाल करता है. साथ ही, वीडियो भी बना सकता है.

इसका मतलब है कि हमें Antigravity ब्राउज़र एक्सटेंशन को लॉन्च और इंस्टॉल करना होगा. आइए, बातचीत शुरू करके और चरणों को पूरा करके, ऐसा करते हैं.

किसी वर्कस्पेस में नई बातचीत शुरू करें और यह टास्क असाइन करें: go to antigravity.google

टास्क सबमिट करें. आपको दिखेगा कि एजेंट, टास्क का विश्लेषण कर रहा है. साथ ही, आपको यह भी दिखेगा कि वह किस तरह से सोच-विचार कर रहा है. कुछ समय बाद, यह सही तरीके से आगे बढ़ेगा और बताएगा कि इसे ब्राउज़र एजेंट को सेट अप करने की ज़रूरत है. यह जानकारी नीचे दी गई है. Setup पर क्लिक करें.

e7119f40e093afd2.png

इससे ब्राउज़र खुल जाएगा और एक्सटेंशन इंस्टॉल करने के लिए एक मैसेज दिखेगा. यह मैसेज यहां दिखाया गया है:

82fb87d7d75b4a6c.png

आगे बढ़ें. इसके बाद, आपको Chrome एक्सटेंशन पर ले जाया जाएगा. इसे इंस्टॉल किया जा सकता है.

f3468f0e5f3bb075.png

एक्सटेंशन को इंस्टॉल करने के बाद, Antigravity Agent काम करना शुरू कर देगा. साथ ही, यह बताएगा कि उसे अपना काम करने के लिए आपकी अनुमति चाहिए. आपको खुली हुई ब्राउज़र विंडो में कुछ गतिविधि दिखेगी:

7f0367e00ac36d5a.png

एजेंट मैनेजर व्यू पर वापस जाएं. आपको यह दिखेगा:

b9d89e1ebefcfd76.png

हमें ठीक यही नतीजे मिलने की उम्मीद थी, क्योंकि हमने एजेंट को antigravity.google वेबसाइट पर जाने के लिए कहा था. इसे अनुमति दें. इसके बाद, आपको पता चलेगा कि वेबसाइट पर सुरक्षित तरीके से नेविगेट किया गया है. जैसा कि यहां दिखाया गया है:

77fcc38b5fb4ca7c.png

5. कलाकृतियां

Antigravity, प्लान बनाने और काम करने के दौरान आर्टफ़ैक्ट बनाता है. ऐसा इसलिए, ताकि वह अपने काम के बारे में बता सके और लोगों से सुझाव/राय पा सके या शिकायतें दर्ज करा सके. ये रिच मार्कडाउन फ़ाइलें, आर्किटेक्चर डायग्राम, इमेज, ब्राउज़र रिकॉर्डिंग, कोड में अंतर वगैरह होते हैं.

आर्टफ़ैक्ट, "भरोसे की कमी" की समस्या को हल करते हैं. जब कोई एजेंट यह दावा करता है कि "मैंने गड़बड़ी ठीक कर दी है", तो डेवलपर को पुष्टि करने के लिए कोड पढ़ना पड़ता था. एंटीग्रैविटी में, एजेंट इस बात को साबित करने के लिए एक आर्टफ़ैक्ट बनाता है.

Antigravity से ये मुख्य आर्टफ़ैक्ट जनरेट होते हैं:

  • Task Lists: कोड लिखने से पहले, एजेंट एक स्ट्रक्चर्ड प्लान जनरेट करता है. आम तौर पर, आपको इस प्लान में बदलाव करने की ज़रूरत नहीं होती. हालांकि, आपके पास इसकी समीक्षा करने का विकल्प होता है. साथ ही, अगर ज़रूरी हो, तो कुछ मामलों में इसमें बदलाव करने के लिए टिप्पणी भी जोड़ी जा सकती है.
  • Implementation Plan: इसका इस्तेमाल, किसी टास्क को पूरा करने के लिए अपने कोडबेस में बदलाव करने के लिए किया जाता है. इन प्लान में तकनीकी जानकारी शामिल होती है. इसमें बताया जाता है कि कौनसे बदलाव ज़रूरी हैं. साथ ही, इन्हें उपयोगकर्ता को देखना होता है. हालांकि, अगर आपने आर्टफ़ैक्ट की समीक्षा करने की नीति को "हमेशा आगे बढ़ें" पर सेट किया है, तो ऐसा नहीं होता.
  • Walkthrough: यह तब बनाया जाता है, जब एजेंट टास्क को लागू कर देता है. इसमें बदलावों की खास जानकारी और उन्हें टेस्ट करने का तरीका शामिल होता है.
  • Code diffs: तकनीकी तौर पर, यह कोई आर्टफ़ैक्ट नहीं है. हालांकि, Antigravity कोड में अंतर भी दिखाता है. इस पर समीक्षा की जा सकती है और टिप्पणी की जा सकती है.
  • Screenshots: एजेंट, बदलाव से पहले और बाद में यूज़र इंटरफ़ेस (यूआई) की स्थिति को कैप्चर करता है.
  • Browser Recordings: डाइनैमिक इंटरैक्शन (जैसे, "लॉगिन बटन पर क्लिक करें, स्पिनर के दिखने का इंतज़ार करें, पुष्टि करें कि डैशबोर्ड लोड हो गया है") के लिए, एजेंट अपने सेशन का वीडियो रिकॉर्ड करता है. डेवलपर इस वीडियो को देखकर यह पुष्टि कर सकता है कि ऐप्लिकेशन को खुद चलाए बिना, फ़ंक्शन से जुड़ी ज़रूरी शर्तें पूरी की गई हैं.

आर्टफ़ैक्ट बनाए जाते हैं और ये एजेंट मैनेजर और एडिटर, दोनों के व्यू में दिखते हैं.

एडिटर व्यू में, सबसे नीचे दाएं कोने में मौजूद Artifacts पर क्लिक करके ये काम किए जा सकते हैं:

5deff47fe0a93aa1.png

एजेंट मैनेजर व्यू में, सबसे ऊपर दाईं ओर, Review changes के बगल में, आपको आर्टफ़ैक्ट टॉगल करने का बटन दिखेगा. अगर यह टॉगल चालू है, तो आपको जनरेट किए गए आर्टफ़ैक्ट की सूची दिखेगी:

5320f447471c43eb.png

आपको नीचे दी गई इमेज की तरह, आर्टफ़ैक्ट व्यू दिखेगा. यहां हमने एजेंट को antigravity.google पेज पर जाने का निर्देश दिया है. इसलिए, एजेंट ने इसका स्क्रीनशॉट कैप्चर किया है और इसका एक वीडियो बनाया है:

19d9738bb3c7c0c9.png

एडिटर व्यू में Review Changes में जाकर, कोड में हुए अंतर देखे जा सकते हैं:

e1d8fd6e7df4daf3.png

डेवलपर, "Google Docs की तरह टिप्पणी करने" की सुविधा का इस्तेमाल करके, इन आर्टफ़ैक्ट और कोड में अंतर के साथ इंटरैक्ट कर सकते हैं. आपके पास कोई खास ऐक्शन या टास्क चुनने का विकल्प होता है. इसके बाद, अपनी पसंद के मुताबिक कमांड दें और उसे एजेंट को सबमिट करें. इसके बाद, एजेंट इस फ़ीडबैक को प्रोसेस करेगा और उसके हिसाब से जवाब देगा. इंटरैक्टिव Google Docs का इस्तेमाल करने के बारे में सोचें. इसमें, लेखक को सुझाव, शिकायत या राय दी जाती है और फिर लेखक उस पर दोबारा काम करता है.

6. संपादक

एडिटर, VS Code की तरह ही काम करता है. इससे अनुभवी डेवलपर को इसे इस्तेमाल करने में आसानी होती है. इसमें स्टैंडर्ड फ़ाइल एक्सप्लोरर, सिंटैक्स हाइलाइटिंग, और एक्सटेंशन ईकोसिस्टम शामिल है.

एडिटर पर जाने के लिए, एजेंट मैनेजर में सबसे ऊपर दाईं ओर मौजूद Open Editor बटन पर क्लिक करें.

सेटअप और एक्सटेंशन

सामान्य सेटअप में, आपको एडिटर, टर्मिनल, और एजेंट दिखेगा:

7996408528de93e1.png

अगर ऐसा नहीं है, तो टर्मिनल और एजेंट पैनल को इस तरह टॉगल किया जा सकता है:

  • टर्मिनल पैनल को टॉगल करने के लिए, Ctrl + ` शॉर्टकट का इस्तेमाल करें.
  • एजेंट पैनल को टॉगल करने के लिए, Cmd + L शॉर्टकट का इस्तेमाल करें.

इसके अलावा, Antigravity सेटअप के दौरान कुछ एक्सटेंशन इंस्टॉल कर सकता है. हालांकि, इस्तेमाल की जा रही प्रोग्रामिंग भाषा के हिसाब से, आपको शायद ज़्यादा एक्सटेंशन इंस्टॉल करने पड़ें. उदाहरण के लिए, Python डेवलपमेंट के लिए, ये एक्सटेंशन इंस्टॉल किए जा सकते हैं:

bd33a79837b5a12a.png

संपादक

स्‍वत: पूर्ण

एडिटर में कोड टाइप करते समय, स्मार्ट तरीके से अपने-आप पूरा होने वाली सुविधा काम करती है. इसे स्वीकार करने के लिए, Tab दबाएं:

e90825ed7a009350.png

इंपोर्ट करने के लिए, Tab का इस्तेमाल करें

डिपेंडेंसी जोड़ने के लिए, आपको इंपोर्ट करने के लिए टैब का सुझाव मिलता है:

bcab60794caa0aec.png

जंप करने के लिए टैब दबाएं

आपको टैब दबाकर आगे बढ़ने के सुझाव मिलते हैं, ताकि कर्सर को कोड में अगली सही जगह पर ले जाया जा सके:

8610ae5217be7fe5.png

निर्देश

एडिटर या टर्मिनल में Cmd + I का इस्तेमाल करके, आम बोलचाल की भाषा में इनलाइन सुझाव पाने के लिए कमांड ट्रिगर की जा सकती हैं.

एडिटर में, फ़िबोनाची संख्याओं को कैलकुलेट करने का तरीका पूछा जा सकता है. इसके बाद, इसे स्वीकार या अस्वीकार किया जा सकता है:

13a615e515cea100.png

टर्मिनल में, आपको टर्मिनल कमांड के सुझाव मिल सकते हैं:

5a75e560f998cedc.png

एजेंट साइड पैनल

एडिटर में, एजेंट साइड पैनल को कई तरीकों से टॉगल किया जा सकता है.

मैन्युअल तरीके से खोला गया

Cmd + L शॉर्टकट का इस्तेमाल करके, दाईं ओर मौजूद एजेंट पैनल को मैन्युअल तरीके से टॉगल किया जा सकता है.

सवाल पूछने के लिए, @ का इस्तेमाल करके फ़ाइलें, डायरेक्ट्री, एमसीपी सर्वर जैसे ज़्यादा कॉन्टेक्स्ट शामिल करें. इसके अलावा, / का इस्तेमाल करके किसी वर्कफ़्लो (सेव किया गया प्रॉम्प्ट) का रेफ़रंस दें:

95c5a6d31d771748.png

आपके पास बातचीत के दो मोड में से कोई एक चुनने का विकल्प भी है: Fast या Planning :

d3d1449f12510e3e.png

Fast का इस्तेमाल, तुरंत किए जाने वाले टास्क के लिए किया जाता है. वहीं, Planning का इस्तेमाल ज़्यादा मुश्किल टास्क के लिए किया जाता है. इसमें एजेंट एक प्लान बनाता है, जिसे आपको मंज़ूरी देनी होती है.

बातचीत के लिए, अलग-अलग मॉडल भी चुने जा सकते हैं:

af709bcc03c1e21e.png

समस्या के बारे में जानकारी दो और उसे ठीक करो

एजेंट को ट्रिगर करने का दूसरा तरीका यह है कि किसी समस्या पर कर्सर घुमाएं और Explain and fix को चुनें:

e45cbe02ed76b9c1.png

समस्याएं एजेंट को भेजें

इसके अलावा, Problems सेक्शन में जाकर Send all to Agent को चुना जा सकता है, ताकि एजेंट उन समस्याओं को ठीक करने की कोशिश कर सके:

e4992d14708005d0.png

टर्मिनल आउटपुट को एजेंट को भेजना

टर्मिनल आउटपुट के किसी हिस्से को भी चुना जा सकता है और Cmd + L का इस्तेमाल करके, उसे एजेंट को भेजा जा सकता है:

c40293bab474c9b1.png

एडिटर और एजेंट मैनेजर के बीच टॉगल करना

एडिटर मोड में रहते हुए, सबसे ऊपर दाईं ओर मौजूद Open Agent Manager बटन पर क्लिक करके, कभी भी एडिटर मोड और एजेंट मैनेजर मोड के बीच स्विच किया जा सकता है. इसके अलावा, एजेंट मैनेजर मोड में रहते हुए, सबसे ऊपर दाईं ओर मौजूद Open Editor बटन पर क्लिक करके, एडिटर मोड पर वापस जाया जा सकता है.

इसके अलावा, दोनों मोड के बीच टॉगल करने के लिए, Cmd + E कीबोर्ड शॉर्टकट का भी इस्तेमाल किया जा सकता है.

7. फ़ीडबैक प्रदान करें

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
...

यह पहली जगह है, जहां सुझाव/राय दी जा सकती है या शिकायत की जा सकती है. इस मामले में, एजेंट को Python वेब फ़्रेमवर्क के तौर पर 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 नई फ़ाइलों में कुछ कोड जनरेट करेगा. ज़्यादा जानकारी देखे बिना, एजेंट चैट के साइड पैनल में इन बदलावों को Accept all या Reject 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 को चुनना है.

8. नियम और वर्कफ़्लो

Antigravity में, कस्टमाइज़ेशन के कुछ विकल्प मिलते हैं: नियम और वर्कफ़्लो.

एडिटर मोड में, सबसे ऊपर दाएं कोने में मौजूद ... पर क्लिक करें. इसके बाद, Customizations चुनें. आपको Rules और Workflows दिखेगा:

ff8babd8d8bcfa83.png

नियमों से, एजेंट के व्यवहार को सही दिशा में ले जाने में मदद मिलती है. ये ऐसे दिशा-निर्देश हैं जिन्हें दिया जा सकता है, ताकि एजेंट कोड जनरेट करते समय और उसकी जांच करते समय इनका पालन करे. उदाहरण के लिए, हो सकता है कि आपको एजेंट से किसी खास कोड स्टाइल का पालन करने या हमेशा तरीकों के बारे में जानकारी देने के लिए कहना हो. इन्हें नियमों के तौर पर जोड़ा जा सकता है. एजेंट इन नियमों को ध्यान में रखेगा.

Workflows, सेव किए गए ऐसे प्रॉम्प्ट होते हैं जिन्हें / की मदद से, ज़रूरत के हिसाब से ट्रिगर किया जा सकता है. ऐसा तब किया जाता है, जब एजेंट से इंटरैक्ट किया जा रहा हो. ये एजेंट के व्यवहार को भी गाइड करते हैं. हालांकि, इन्हें उपयोगकर्ता के अनुरोध पर ट्रिगर किया जाता है.

इसे इस तरह समझें कि नियम, सिस्टम के निर्देशों की तरह होते हैं. वहीं, वर्कफ़्लो, सेव किए गए प्रॉम्प्ट की तरह होते हैं, जिन्हें ज़रूरत के हिसाब से चुना जा सकता है.

नियम और वर्कफ़्लो, दोनों को ग्लोबल लेवल पर या हर वर्कस्पेस के हिसाब से लागू किया जा सकता है. इन्हें इन जगहों पर सेव किया जा सकता है:

  • ग्लोबल नियम: ~/.gemini/GEMINI.md
  • ग्लोबल वर्कफ़्लो: ~/.gemini/antigravity/global_workflows/<YOUR_WORKFLOW_NAME>.md
  • Workspace के नियम: your-workspace/.agents/rules/
  • Workspace Workflows: your-workspace/.agents/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.

दोनों नियम सेव हो गए हैं और इस्तेमाल के लिए तैयार हैं:

bfd179dfef6b2355.png

वर्कफ़्लो जोड़ना

आइए, यूनिट टेस्ट जनरेट करने के लिए एक वर्कफ़्लो भी तय करें. इससे हमें कोड से संतुष्ट होने के बाद, यूनिट टेस्ट को ट्रिगर करने की अनुमति मिलेगी. ऐसा इसलिए, ताकि एजेंट हर समय यूनिट टेस्ट जनरेट न करे.

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

वर्कफ़्लो भी अब इस्तेमाल के लिए तैयार है:

d22059258592f0e1.png

इसे आज़माएं

चलिए, अब देखते हैं कि नियम और वर्कफ़्लो कैसे काम करते हैं. अपने वर्कस्पेस में एक स्केलेटन 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 को हमारे वर्कफ़्लो के बारे में पहले से ही पता है:

8a3efd9e3be7eb6f.png

generate-unit-tests को चुनें और एंटर करें. कुछ सेकंड बाद, आपको अपने Workspace में नई फ़ाइलें मिलेंगी: test_binary_search.py, test_bubble_sort.py. इनमें पहले से ही कई टेस्ट लागू किए गए होंगे!

11febd7940ef8199.png

बढ़िया!

9. कौशल

Antigravity के बुनियादी मॉडल (जैसे, Gemini) कई तरह के काम कर सकते हैं. हालांकि, उन्हें आपके प्रोजेक्ट के कॉन्टेक्स्ट या टीम के स्टैंडर्ड के बारे में जानकारी नहीं होती. एजेंट की कॉन्टेक्स्ट विंडो में हर नियम या टूल को लोड करने से, "टूल ब्लोट" की समस्या होती है. साथ ही, लागत बढ़ जाती है, इंतज़ार का समय बढ़ जाता है, और भ्रम की स्थिति पैदा हो जाती है.

Antigravity Skills, प्रोग्रेसिव डिसक्लोज़र के ज़रिए इस समस्या को हल करती हैं. स्किल, जानकारी का एक खास पैकेज होता है. यह तब तक काम नहीं करता, जब तक इसकी ज़रूरत न हो. इसे सिर्फ़ तब एजेंट के कॉन्टेक्स्ट में लोड किया जाता है, जब आपका अनुरोध, स्किल के ब्यौरे से मेल खाता हो .

स्ट्रक्चर और स्कोप

स्किल, डायरेक्ट्री पर आधारित पैकेज होते हैं. अपनी ज़रूरतों के हिसाब से, इन्हें दो स्कोप में तय किया जा सकता है:

  • ग्लोबल स्कोप (~/.gemini/antigravity/skills/): यह आपके सभी प्रोजेक्ट में उपलब्ध है. उदाहरण के लिए, "JSON फ़ॉर्मैट करें", "कोड की सामान्य समीक्षा" .
  • वर्कस्पेस का दायरा (<workspace-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 फ़ाइल बनानी है. इसमें मेटाडेटा और स्किल के निर्देश शामिल होंगे. आइए, एक ग्लोबल स्किल बनाते हैं. यह एजेंट को गड़बड़ियों, स्टाइल से जुड़ी समस्याओं, और सबसे सही तरीकों के लिए कोड में किए गए बदलावों की समीक्षा करने के बारे में जानकारी देती है.

सबसे पहले, वह डायरेक्ट्री बनाएं जिसमें यह ग्लोबल स्किल शामिल होगी.

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 फ़ाइल में, सबसे ऊपर मेटाडेटा (नाम और जानकारी) और उसके बाद निर्देश दिए गए हैं. एजेंट लोड होने पर, सिर्फ़ उन स्किल का मेटाडेटा पढ़ेगा जिन्हें आपने कॉन्फ़िगर किया है. साथ ही, वह स्किल के निर्देशों को सिर्फ़ तब लोड करेगा, जब इसकी ज़रूरत होगी.

इसे आज़माएं

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 फ़ाइल में दिए गए निर्देशों के मुताबिक कार्रवाई करनी चाहिए.

यहां आउटपुट का एक सैंपल दिखाया गया है:

d90a989f4555e2fc.png

कोड हेडर टेंप्लेट स्किल

कभी-कभी किसी स्किल को स्टैटिक टेक्स्ट के बड़े ब्लॉक का इस्तेमाल करना पड़ता है. जैसे, लाइसेंस हेडर. इस टेक्स्ट को सीधे प्रॉम्प्ट में डालने से कोई फ़ायदा नहीं होता. इसके बजाय, हम इसे resources/ फ़ोल्डर में रखते हैं और एजेंट को निर्देश देते हैं कि वह इसे सिर्फ़ तब पढ़े, जब ज़रूरी हो .

सबसे पहले, वह डायरेक्ट्री बनाएं जिसमें यह Workspace स्किल शामिल होगी.

mkdir -p .agents/skills/license-header-adder/resources

लाइसेंस के टेक्स्ट का इस्तेमाल करके .agents/skills/license-header-adder/resources/HEADER.txt बनाएं:

/*
 * Copyright (c) 2026 YOUR_COMPANY_NAME LLC.
 * All rights reserved.
 * This code is proprietary and confidential.
 */

नीचे दिखाए गए कॉन्टेंट के साथ .agents/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-स्टाइल वाली टिप्पणियों को Python स्टाइल में बदलेगा और उन्हें आपकी नई फ़ाइल में अपने-आप जोड़ देगा.

इन स्किल को बनाकर, आपने Gemini के सामान्य मॉडल को अपने प्रोजेक्ट के लिए विशेषज्ञ में बदल दिया है. आपने अपने सबसे सही तरीकों को कोड में शामिल किया हो. जैसे, कोड की समीक्षा से जुड़े दिशा-निर्देशों या लाइसेंस हेडर का पालन करना. एजेंट को बार-बार यह बताने के बजाय कि "लाइसेंस जोड़ना न भूलें" या "कमिट फ़ॉर्मैट ठीक करें", अब एजेंट को अपने-आप पता चल जाता है कि आपकी टीम के लिए कैसे काम करना है.

10. सुरक्षा और कंट्रोल

एआई एजेंट को अपने फ़ाइल सिस्टम, टर्मिनल, और ब्राउज़र का ऐक्सेस देना, फ़ायदेमंद और नुकसानदेह, दोनों हो सकता है. यह कोड को अपने-आप जनरेट करने, डीबग करने, और डिप्लॉय करने की सुविधा देता है. हालांकि, इससे प्रॉम्प्ट इंजेक्शन और डेटा एक्सफ़िल्ट्रेशन के लिए भी रास्ते खुल जाते हैं. Antigravity, सुरक्षा कंट्रोल की अलग-अलग सेटिंग के ज़रिए इस समस्या को हल करता है.

Antigravity की सेटिंग पर जाएँ और Agent में मौजूद सेटिंग देखें.

सह-प्रॉडक्ट से जुड़ी नीति

पहली नीति, आर्टफ़ैक्ट की समीक्षा करने से जुड़ी नीति है. इससे यह तय होता है कि आर्टफ़ैक्ट की समीक्षा करने के लिए अनुरोध करते समय, एजेंट का व्यवहार कैसा होगा.

नीति मोड

ब्यौरा

हमेशा आगे बढ़ता है

एजेंट कभी भी समीक्षा के लिए अनुरोध नहीं करता. इससे एजेंट को ज़्यादा से ज़्यादा स्वायत्तता मिलती है. हालांकि, इससे एजेंट के असुरक्षित या इंजेक्ट किए गए आर्टफ़ैक्ट कॉन्टेंट पर काम करने का खतरा भी सबसे ज़्यादा होता है

एजेंट का फ़ैसला

एजेंट, टास्क की जटिलता और उपयोगकर्ता की पसंद के आधार पर यह तय करेगा कि समीक्षा के लिए कब पूछना है

समीक्षा का अनुरोध करता है

एजेंट हमेशा समीक्षा करने के लिए कहता है

इस नीति को Asks for Review पर सेट करना बेहतर होगा.

टर्मिनल की नीति और सैंडबॉक्स

अगली नीति, टर्मिनल कमांड के बारे में है.

Terminal Command Auto Execution नीति लागू है. इस सेटिंग से, शेल कमांड के बारे में एजेंट की स्वायत्तता तय होती है:

नीति मोड

ब्यौरा

प्रोफ़ाइल की समीक्षा का अनुरोध करें

टर्मिनल कमांड (अनुमति वाली सूची में शामिल कमांड को छोड़कर) को लागू करने से पहले, एजेंट हमेशा पुष्टि करने के लिए कहता है

हमेशा आगे बढ़ें

टर्मिनल कमांड (अनुमति न दी गई कमांड को छोड़कर) को लागू करने से पहले, एजेंट कभी पुष्टि करने के लिए नहीं कहता. इससे एजेंट को लंबे समय तक बिना किसी रुकावट के काम करने की सुविधा मिलती है. हालांकि, इसमें एजेंट के असुरक्षित टर्मिनल कमांड को लागू करने का जोखिम भी सबसे ज़्यादा होता है.

आपको शुरुआत में Request Review चुनना चाहिए. इसके बाद, एजेंट को हर वर्कस्पेस के लिए ज़्यादा टर्मिनल कमांड चलाने की अनुमति देनी चाहिए.

इसके अलावा, एक Enable Terminal Sandbox सेक्शन भी है. आपको इसे चालू करना चाहिए. इस सेटिंग को चालू करने पर, टर्मिनल कमांड सैंडबॉक्स की पाबंदियों के साथ चलती हैं.

फ़ाइल ऐक्सेस करने की नीति

डिफ़ॉल्ट रूप से, एजेंट सिर्फ़ आपके Workspace में मौजूद फ़ाइलों को ऐक्सेस कर सकता है. यह एक अच्छा तरीका है. इससे यह तय किया जा सकता है कि एजेंट के पास किन फ़ाइलों का ऐक्सेस होगा. अगर आपको कभी ज़्यादा जगह की ज़रूरत हो, तो Agent Non-Workspace File Access टॉगल का इस्तेमाल करें. इस सुविधा के चालू होने पर, एजेंट को मौजूदा फ़ाइल फ़ोल्डर के बाहर की फ़ाइलों को अपने-आप देखने और उनमें बदलाव करने की अनुमति मिल जाती है.

एजेंट की अनुमतियां

Antigravity, अनुमति देने के लिए एक ही सिस्टम का इस्तेमाल करता है. इससे यह कंट्रोल किया जा सकता है कि एजेंट आपकी ओर से कौनसी कार्रवाइयाँ कर सकता है. हर कार्रवाई को अनुमति वाले संसाधन के तौर पर दिखाया जाता है. इसे तीन सूचियों में से किसी एक में रखा जा सकता है:

  • अनुमति दें: इस कार्रवाई को बिना किसी प्रॉम्प्ट के अपने-आप स्वीकार कर लिया जाता है.
  • अस्वीकार करें: इस कार्रवाई को तुरंत ब्लॉक कर दिया जाता है.
  • पूछना: एजेंट, आगे बढ़ने से पहले रुक जाता है और आपसे अनुमति मांगता है.

'अनुमति दें', 'अनुमति न दें' या 'हर बार पूछें' सूची में मौजूद हर एंट्री इस फ़ॉर्मैट में होती है: action(target)

यहां action, कार्रवाई के लिए इस्तेमाल किए जा सकने वाले टाइप में से एक है. वहीं, target एक ऐसा पैटर्न है जिससे पता चलता है कि अनुमति किस चीज़ के लिए दी गई है.

कार्रवाई

टारगेट फ़ॉर्मैट

मैचिंग

command

command(prefix) or command(*)

यह प्रीफ़िक्स के हिसाब से कमांड मैच करता है. command(git) से git add, git commit वगैरह मैच होते हैं.

read_file

read_file(/path)

यह फ़ाइल या डायरेक्ट्री में मौजूद सभी चीज़ों से मेल खाता है. पाथ, लिटरल और ऐब्सलूट होने चाहिए. ग्लोब (*.go), रेगुलर एक्सप्रेशन, और ~ का इस्तेमाल नहीं किया जा सकता.

write_file

write_file(/path)

read_file की तरह. साथ ही, यह एक ही पाथ के लिए read_file को भी शामिल करता है.

read_url

read_url(domain) or read_url(*)

यह डोमेन और सभी सबडोमेन से मेल खाता है. यूआरएल पाथ से मेल नहीं खाता.

mcp

mcp(server/tool), mcp(server/
), or mcp()

यह सर्वर के नाम से हूबहू मेल खाता है. server/* उस सर्वर पर मौजूद सभी टूल को कवर करता है.

ज़्यादा जानकारी के लिए, दस्तावेज़ पढ़ें.

टेस्टिंग के लिए अनुमति वाली सूची

अनुमति वाली सूची का इस्तेमाल मुख्य रूप से, समीक्षा का अनुरोध करें नीति के साथ किया जाता है. यह एक पॉज़िटिव सिक्योरिटी मॉडल है. इसका मतलब है कि जब तक किसी चीज़ को साफ़ तौर पर अनुमति नहीं दी जाती, तब तक उसे इस्तेमाल करने की अनुमति नहीं होती. यह सबसे सुरक्षित कॉन्फ़िगरेशन है.

Permissions पर जाएं. इसके बाद, Always Allow सेक्शन पर जाएं और यह जोड़ें: command(ls)

इसके बाद, एजेंट से सवाल पूछें और देखें कि वह कैसे जवाब देता है:

  • एजेंट से पूछें: List the files in this directory.
  • ls अपने-आप चलता है.
  • एजेंट से पूछें: Delete the <some file>.
  • एजेंट, rm <filepath> की कोशिश करेगा. हालांकि, Antigravity, उपयोगकर्ता की समीक्षा को लागू करेगा, क्योंकि rm को अनुमति वाली सूची में शामिल नहीं किया गया है. कमांड चलाने से पहले, Antigravity को आपसे अनुमति लेनी चाहिए.

टेस्टिंग के लिए अनुमति न दी गई सूची

हमेशा आगे बढ़ें नीति के लिए, अनुमति न दें सूची सुरक्षा का काम करती है. यह एक नेगेटिव सिक्योरिटी मॉडल है. इसका मतलब है कि जब तक किसी चीज़ को साफ़ तौर पर प्रतिबंधित नहीं किया जाता, तब तक उसे अनुमति दी जाती है. इसमें डेवलपर को हर संभावित खतरे का अनुमान लगाना होता है. यह एक जोखिम भरा काम है, लेकिन इससे सबसे ज़्यादा तेज़ी से काम होता है.

Permissions पर जाएं. इसके बाद, Always Deny सेक्शन पर जाएं और यह जानकारी जोड़ें:

  • command(rm)

इसके बाद, एजेंट से सवाल पूछें और देखें कि वह कैसे जवाब देता है:

  • एजेंट से पूछें: Create a main.py.
  • एजेंट बिना किसी समस्या के फ़ाइल बनाता है.
  • एजेंट से पूछें: Delete the main.py file.
  • Antigravity, एक्ज़ीक्यूशन को ब्लॉक कर देता है और आपसे मैन्युअल तौर पर मंज़ूरी मांगता है.

ब्राउज़र से जुड़ी नीति

Antigravity के पास वेब ब्राउज़ करने की क्षमता है, जो एक सुपरपावर है. हालांकि, यह एक जोखिम भी है. अगर कोई एजेंट, हैक की गई दस्तावेज़ वाली साइट पर जाता है, तो उस पर प्रॉम्प्ट इंजेक्शन अटैक हो सकता है. इससे बचने के लिए, ब्राउज़र एजेंट के लिए ब्राउज़र के यूआरएल की अनुमति वाली सूची लागू की जा सकती है.

इसके लिए, Antigravity — Settings और फिर Browser पर जाकर, अपनी मौजूदा सेटिंग देखी जा सकती हैं. आपको Browser URL Allowlist सेक्शन दिखेगा. इसमें अन्य यूआरएल जोड़े जा सकते हैं:

7bd38b2b02df521d.png

11. नतीजा

बधाई हो! आपने Antigravity को इंस्टॉल कर लिया है, अपने एनवायरमेंट को कॉन्फ़िगर कर लिया है, और एजेंटों को कंट्रोल करने का तरीका जान लिया है.

आगे क्या करना है? Antigravity को असल दुनिया के ऐप्लिकेशन बनाने में इस्तेमाल करने के बारे में जानने के लिए, इन कोडलैब को देखें:

रेफ़रंस दस्तावेज़