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

1. परिचय

इस कोडलैब में, आपको Google Antigravity के बारे में जानकारी मिलेगी. इसे इस दस्तावेज़ में 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 खाते का इस्तेमाल किया जा सकता है.

डाउनलोड पेज पर जाएं और अपने ऑपरेटिंग सिस्टम के उस वर्शन पर क्लिक करें जो आपके डिवाइस के लिए सही है. ऐप्लिकेशन इंस्टॉलर लॉन्च करें और उसे अपने कंप्यूटर पर इंस्टॉल करें. इंस्टॉल करने के बाद, 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 लॉन्च करने पर, उपयोगकर्ता को आम तौर पर फ़ाइल ट्री नहीं, बल्कि एजेंट मैनेजर दिखता है. इसे यहां दिखाया गया है:

d5ae91fc746e1bba.png

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

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

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

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

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

ऊपर दिए गए Next पर क्लिक करने से, आपके पास कोई वर्कस्पेस खोलने का विकल्प होता है.

ec72712ea24bf6d5.png

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

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

156224e223eeda36.png

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

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

fb0744dc43911365.png

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

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

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

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

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

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

  • ग्लोबल नियम: ~/.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 को पहली बार कॉन्फ़िगर करते समय या सेटिंग मेन्यू के ज़रिए, आपको Terminal Command Auto Execution नीति चुननी होगी. इस सेटिंग से यह तय होता है कि शेल कमांड के बारे में एजेंट को कितनी स्वायत्तता मिलेगी. Antigravity — Settings पर जाकर, इसकी मौजूदा सेटिंग देखी जा सकती हैं. आपको Terminal सेक्शन और Terminal Command Auto Execution नीति के साथ ये विकल्प दिखने चाहिए:

नीति मोड

ब्यौरा

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

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

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

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

अनुमति वाली सूची को कॉन्फ़िगर करना

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

चरण-दर-चरण कॉन्फ़िगरेशन

  1. टर्मिनल कमांड अपने-आप लागू होने की सुविधा सेटिंग को समीक्षा का अनुरोध करें पर सेट करें.
  2. अनुमति वाली टर्मिनल कमांड की सूची में, यह कमांड जोड़ें. इसके लिए, इसके बगल में मौजूद जोड़ें बटन पर क्लिक करें : ls -al . अगर चाहें, तो अन्य टर्मिनल कमांड भी जोड़ी जा सकती हैं.

अनुमति वाली सूची की जांच करना

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

अनुमति न देने वाली सूची को कॉन्फ़िगर करना

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

चरण-दर-चरण कॉन्फ़िगरेशन

  1. टर्मिनल कमांड अपने-आप एक्ज़ीक्यूट होने की सेटिंग को हमेशा आगे बढ़ें पर सेट करें.
  2. इसके बगल में मौजूद जोड़ें बटन पर क्लिक करके, टर्मिनल के उन निर्देशों की सूची में ये निर्देश जोड़ें जिन्हें अनुमति नहीं दी गई है.
  3. rm
  4. sudo
  5. curl
  6. wget

बिना अनुमति वाली सूची की जांच करना

  • एजेंट से पूछें: Check the version of python.
  • python --version अपने-आप चलता है.
  • एजेंट से पूछें: Download www.google.com home page.
  • एजेंट, curl की कोशिश करता है. Antigravity, डेनायल लिस्ट में curl का पता लगाता है और उसे लागू होने से रोकता है. साथ ही, आपसे मैन्युअल तरीके से मंज़ूरी लेने के लिए कहता है.

ब्राउज़र की सुरक्षा

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

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

7bd38b2b02df521d.png

11. निष्कर्ष और अगले चरण

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

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

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