Antigravity CLI और Agent Skills for Firebase की मदद से, एआई एजेंट की क्षमताओं का इस्तेमाल कैसे करें

1. परिचय

इस लैब में, आपको Agent Skills बनाने का तरीका बताया जाएगा. इससे एआई एजेंटों को, खास जानकारी और वर्कफ़्लो का ऐक्सेस मिलेगा. इसे एक लोकल स्किल के तौर पर बनाया जाएगा, जिसे Antigravity CLI से ऐक्सेस किया जा सकता है.

आपको क्या करना होगा

• अपनी पसंदीदा चीज़ों के लिए, Agent Skills बनाना.
• अपनी स्किल के बारे में क्वेरी करने के लिए, Antigravity CLI का इस्तेमाल करना.
• Firebase के लिए, आधिकारिक Agent Skills इंस्टॉल करना. साथ ही, उनका इस्तेमाल करके कोई ऐप्लिकेशन बनाना और उसे डिप्लॉय करना.

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

• किसी स्किल को स्ट्रक्चर करने का तरीका.
• SKILL.md फ़ाइल लिखने का तरीका.
• Antigravity CLI के साथ लोकल स्किल का इस्तेमाल करने का तरीका.

2. प्रोजेक्ट सेट अप करना

1. अगर आपके पास पहले से कोई Google खाता नहीं है, तो आपको Google खाता बनाना होगा.
   • ऑफ़िस या स्कूल वाले खाते के बजाय, निजी खाते का इस्तेमाल करें. ऑफ़िस और स्कूल वाले खातों पर पाबंदियां हो सकती हैं. इनकी वजह से, इस लैब के लिए ज़रूरी एपीआई चालू नहीं किए जा सकते.
2. Google Cloud Console में साइन इन करें.
3. Cloud Console में बिलिंग की सुविधा चालू करें.
   • इस लैब को पूरा करने में, Cloud के संसाधनों पर एक डॉलर से कम खर्च आएगा.
   • अतिरिक्त शुल्क से बचने के लिए, इस लैब के आखिर में दिए गए चरणों को पूरा करके, संसाधनों को मिटाया जा सकता है.
   • नए उपयोगकर्ताओं को, 300 डॉलर का क्रेडिट मुफ़्त मिलेगा.
4. एक नया प्रोजेक्ट बनाएं या किसी मौजूदा प्रोजेक्ट का फिर से इस्तेमाल करें.
   • अगर आपको प्रोजेक्ट के कोटा से जुड़ी कोई गड़बड़ी दिखती है, तो नया प्रोजेक्ट बनाने के लिए, किसी मौजूदा प्रोजेक्ट का फिर से इस्तेमाल करें या किसी मौजूदा प्रोजेक्ट को मिटाएं.

3. Cloud Shell Editor खोलना

1. Cloud Shell Editor पर सीधे जाने के लिए, इस लिंक पर क्लिक करें
2. अगर आज किसी भी समय अनुमति देने के लिए कहा जाता है, तो जारी रखने के लिए अनुमति दें पर क्लिक करें.
3. अगर टर्मिनल, स्क्रीन के सबसे नीचे नहीं दिखता है, तो इसे खोलें:
   • देखें पर क्लिक करें
   • टर्मिनल पर क्लिक करें
4. टर्मिनल में, इस कमांड से अपना प्रोजेक्ट सेट करें:
   • फ़ॉर्मैट:

     gcloud config set project [PROJECT_ID]
     

   • उदाहरण:

     gcloud config set project lab-project-id-example
     

   • अगर आपको अपने प्रोजेक्ट का आईडी याद नहीं है, तो:
     • इन कमांड से, अपने सभी प्रोजेक्ट आईडी की सूची देखी जा सकती है:

       gcloud projects list | awk '/PROJECT_ID/{print $2}'
       

     
5. आपको यह मैसेज दिखेगा:

   Updated property [core/project].
   

   अगर आपको WARNING दिखता है और Do you want to continue (Y/n)? पूछा जाता है, तो हो सकता है कि आपने प्रोजेक्ट आईडी गलत डाला हो. n दबाएं, Enter दबाएं, और gcloud config set project कमांड को फिर से चलाने की कोशिश करें.

4. अपनी पसंद के मुताबिक स्किल बनाना

Agent Skills, ऐसी डायरेक्ट्री होती हैं जिनमें कम से कम एक SKILL.md फ़ाइल होती है. इस फ़ाइल में, एआई एजेंट को निर्देश और जानकारी दी जाती है. इस सेक्शन में, आपको एक ऐसी स्किल बनाने का तरीका बताया जाएगा जिससे Antigravity CLI को आपकी पसंदीदा चीज़ों के बारे में जानकारी मिलेगी.

1. इस लैब के लिए एक डायरेक्ट्री बनाएं और उसमें जाएं:

   mkdir ~/agent-skills-lab && cd ~/agent-skills-lab
   

2. अपने प्रोजेक्ट की स्किल के लिए एक डायरेक्ट्री बनाएं:

   mkdir -p ~/agent-skills-lab/.agents/skills/my-favorite-things
   

3. अपनी स्किल के लिए, एक नई SKILL.md फ़ाइल बनाएं और उसे खोलें:

   cloudshell edit ~/agent-skills-lab/.agents/skills/my-favorite-things/SKILL.md
   

   cloudshell edit कमांड से, SKILL.md फ़ाइल, टर्मिनल के ऊपर मौजूद एडिटर में खुलेगी.
4. SKILL.md फ़ाइल में यह कॉन्टेंट जोड़ें:

   ---
   name: my-favorite-things
   description: Provides personal information about my favorite color, food, and programming language. Use this skill when the user asks questions about my personal preferences or favorite things.
   ---
   
   # Knowledge
   
   - **Favorite Color:** Blue
   - **Favorite Food:** Pizza
   - **Favorite Programming Language:** Python
   
   If asked about one of my favorite things, please respond with the information provided above.
   

सिर्फ़ SKILL.md फ़ाइल की मदद से, आपने अपनी पहली स्किल बना ली है! अब इस स्किल का इस्तेमाल, Antigravity CLI में करें.

5. Antigravity CLI से अपनी स्किल का इस्तेमाल करना

आपने स्किल बना ली है. इसलिए, Antigravity CLI इसे खोज सकता है, क्योंकि यह .agents/skills डायरेक्ट्री में मौजूद है.

1. Antigravity CLI शुरू करें:

   agy
   

ध्यान दें: Antigravity CLI, Cloud Shell में पहले से इंस्टॉल होता है.

1. Antigravity CLI से पुष्टि करें: पहली बार शुरू करने पर, पुष्टि करना ज़रूरी है. OAuth चुनें (Enter दबाएं).
2. लिंक पर क्लिक करें. अगर लिंक पर क्लिक नहीं किया जा सकता, तो Cloud Shell में यूआरएल को हाइलाइट करके उसे कॉपी करें. इसके बाद, उसे अपने ब्राउज़र में चिपकाएं
3. अपने Google खाते में साइन इन करें
4. कोड को कॉपी करें
5. कोड को Cloud Shell Editor के टर्मिनल में चिपकाएं
6. Enter दबाएं.
7. कुछ डिफ़ॉल्ट सेटिंग स्वीकार करने के लिए, Enter दबाएं.
8. Antigravity CLI से, उसके कॉन्टेक्स्ट में उपलब्ध स्किल की सूची पाएं

   /skills
   

   आपको उपलब्ध स्किल की सूची में, my-favorite-things दिखेगी.
9. स्किल का व्यू बंद करने के लिए, ESC दबाएं
10. Antigravity CLI से अपने पसंदीदा रंग के बारे में पूछें:

    What is my favorite color?
    

    Antigravity CLI को आपके सवाल का जवाब देने के लिए, my-favorite-things स्किल का इस्तेमाल करना चाहिए. अगर कहा जाए, तो Antigravity CLI को स्किल का इस्तेमाल करने की अनुमति दें.

आउटपुट में दिखना चाहिए कि Antigravity CLI ने आपकी स्किल का इस्तेमाल किया है और "नीला" या "मेरा पसंदीदा रंग नीला है" जैसा जवाब दिया है.

आपने कर दिखाया! आपने एक स्किल बना ली है और Antigravity CLI का इस्तेमाल करके उसकी जांच कर ली है.

जब आपको अपना सेशन खत्म करना हो, तो /exit टाइप करें. इसके बाद, Antigravity CLI से बाहर निकलने के लिए Enter दबाएं.

6. (ज़रूरी नहीं) किसी ऐप्लिकेशन को Firebase होस्टिंग पर बनाना और डिप्लॉय करना

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

Firebase के लिए Agent Skills, इन पोर्टेबल मॉड्यूल का एक बेहतरीन उदाहरण हैं. इन्हें इस तरह डिज़ाइन किया गया है कि एआई असिस्टेंट, Firebase के सबसे सही तरीकों को समझ सकें. साथ ही, मुश्किल टास्क को ज़्यादा सटीक तरीके से और कम टोकन लागत में पूरा कर सकें.

अब Firebase के लिए Agent Skills का इस्तेमाल करके, "टू डू" वेब ऐप्लिकेशन बनाएं. इसमें उपयोगकर्ता की पुष्टि करने और डेटाबेस की सुविधा शामिल करें. इसके बाद, इसे Firebase होस्टिंग पर डिप्लॉय करें.

अपना प्रोजेक्ट सेट अप करना

1. अगर अब भी Antigravity CLI में हैं, तो उससे बाहर निकलने के लिए /exit टाइप करें.
2. अपने प्रोजेक्ट के लिए एक नई डायरेक्ट्री बनाएं और उसमें जाएं:

   mkdir ~/todo-app && cd ~/todo-app
   

3. अपने Google खाते का इस्तेमाल करके, Firebase में लॉग इन करें. --no-localhost फ़्लैग का इस्तेमाल करें, क्योंकि आप Cloud Shell में हैं:

   firebase login --no-localhost
   

   1. सीएलआई के प्रॉम्प्ट के साथ इंटरैक्ट करें:
      • जब Enable Gemini in Firebase features? पूछा जाए, तो Y (हां के लिए) टाइप करें और Enter दबाएं.
      • जब Allow Firebase to collect CLI and Emulator Suite usage and error reporting information? पूछा जाए, तो Y (हां के लिए) टाइप करें और Enter दबाएं.
   2. ब्राउज़र में अनुमति दें:
      • आपको टर्मिनल में एक यूआरएल दिखेगा. लॉगिन पेज को नए ब्राउज़र टैब में खोलने के लिए, लिंक पर क्लिक करें. अगर लिंक पर क्लिक नहीं किया जा सकता, तो Cloud Shell में यूआरएल को हाइलाइट करके उसे कॉपी करें. इसके बाद, उसे अपने ब्राउज़र में चिपकाएं.
      • तीन में से पहला चरण (कमांड की पुष्टि करना): हां, मैंने अभी-अभी यह कमांड चलाई है पर क्लिक करें.
      • तीन में से दूसरा चरण (सेशन आईडी की पुष्टि करना): पक्का करें कि सेशन आईडी आपके टर्मिनल में दिखाए गए आईडी से मेल खाता हो. इसके बाद, हां, यह मेरा सेशन आईडी है पर क्लिक करें.
      • तीन में से तीसरा चरण (कोड कॉपी करना): ऑथराइज़ेशन कोड को क्लिपबोर्ड पर कॉपी करने के लिए, कॉपी करें पर क्लिक करें.
   3. लॉगिन पूरा करें:
      • Cloud Shell के टर्मिनल पर वापस जाएं और ? Enter authorization code: प्रॉम्प्ट पर ऑथराइज़ेशन कोड चिपकाएं.
      • Enter दबाएं.
   आपको 'हो गया' मैसेज दिखेगा: ✔ Success! Logged in as .

अहम जानकारी: Cloud Shell में ऑथराइज़ेशन कोड चिपकाते समय, Chrome के उस डायलॉग पर ध्यान दें जिसमें क्लिपबोर्ड की अनुमतियां मांगी जाती हैं. पक्का करें कि यह सुविधा चालू हो. टर्मिनल में कोड चिपकाने के लिए, Ctrl+Shift+V (Windows) या CMD+Shift+V (Mac) का इस्तेमाल किया जा सकता है.

Firebase के लिए Agent Skills इंस्टॉल करना

आपने अपने प्रोजेक्ट की डायरेक्ट्री बना ली है. अब आपको इसमें Firebase के लिए Agent Skills इंस्टॉल करनी होंगी.

अपने टर्मिनल में, skills CLI की मदद से Firebase के लिए Agent Skills इंस्टॉल की जा सकती हैं:

npx skills add firebase/agent-skills

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

• firebase-auth-basics
• firebase-basics
• firebase-firestore
• firebase-hosting-basics
• firebase-security-rules-auditor

इसके बाद के प्रॉम्प्ट के लिए, Enter दबाकर डिफ़ॉल्ट सेटिंग को स्वीकार किया जा सकता है.

इस कमांड से, firebase-basics और firebase-hosting-basics जैसी स्किल डाउनलोड और इंस्टॉल हो जाएंगी. इससे, Antigravity CLI में आपकी my-favorite-things स्किल के साथ इनका इस्तेमाल किया जा सकेगा.

Firebase के लिए Agent Skills के बारे में ज़्यादा जानने के लिए, उपलब्ध स्किल देखें.

एक बेसिक वेब ऐप्लिकेशन बनाना और उसे डिप्लॉय करना

1. अपने प्रोजेक्ट के लिए ज़रूरी एपीआई चालू करें:

   gcloud services enable \
     cloudresourcemanager.googleapis.com \
     firebase.googleapis.com
   

2. अपने मौजूदा Google Cloud प्रोजेक्ट पर Firebase चालू करें:

   firebase projects:addfirebase ${GOOGLE_CLOUD_PROJECT}
   

3. Antigravity CLI शुरू करें:

   agy
   

4. Antigravity CLI से, एक बेसिक index.html जनरेट करने के लिए कहें:

   Generate an index.html file with the content "Hello Firebase Hosting" and
   deploy the application to Firebase Hosting using the current Google Cloud
   Project.
   

   ऐप्लिकेशन जनरेट और डिप्लॉय करते समय, Antigravity CLI अनुमतियां मांगेगा. ऐसा करने की अनुमति देने के लिए, Enter दबाएं. आपको "approve" टाइप करके Enter दबाना पड़ सकता है.Antigravity CLI को आपकी वेबसाइट बनाने और उसे डिप्लॉय करने के लिए, Firebase के लिए Agent Skills का इस्तेमाल करना चाहिए. ज़रूरत के मुताबिक, एजेंट को मंज़ूरी के साथ निर्देश दें.

डिप्लॉयमेंट पूरा होने के बाद, उसे आपके वेब ऐप्लिकेशन के लिए एक यूआरएल देना चाहिए. Cloud Shell Editor के टर्मिनल में लिंक खोलने के लिए, ctrl+click (Windows/Linux) या cmd+click (Mac) का इस्तेमाल करें. डिप्लॉय किए गए अपने ऐप्लिकेशन का यूआरएल देखें!

Firebase से पुष्टि करने की सुविधा जोड़ना

1. अगर Antigravity CLI पहले से शुरू नहीं है, तो उसे शुरू करें:

   agy
   

   Antigravity CLI, "क्या आपको इस फ़ोल्डर पर भरोसा है?" जैसे सवाल पूछ सकता है. डिफ़ॉल्ट सेटिंग स्वीकार करने के लिए, Enter दबाएं.
2. अब Antigravity CLI से, Google से साइन इन करने की सुविधा जोड़ने के लिए कहें:

   Generate HTML, CSS, and Javascript for a single page application.
   It should use Google Sign-in with Firebase Authentication.
   A user should be able to sign in with their Google Account.
   Deploy when you are done and give the URL to me.
   

   Antigravity CLI, index.html, style.css, और script.js जैसी फ़ाइलें बनाने या अपडेट करने के लिए कह सकता है. उसे ऐसा करने की अनुमति दें. Antigravity CLI, Firebase कंसोल में कुछ कार्रवाइयां करने के लिए कह सकता है. सीएलआई इनमें से ज़्यादातर कार्रवाइयां कर सकता है, अगर उससे ऐसा करने के लिए कहा जाए. हालांकि, अगर आपके Cloud Shell इंस्टेंस में Firebase CLI का पुराना वर्शन इंस्टॉल है, तो आपको मैन्युअल तरीके से चरण पूरे करने पड़ सकते हैं. जैसे, Google OAuth चालू करना.

डिप्लॉयमेंट पूरा होने के बाद, उसे आपके वेब ऐप्लिकेशन के लिए एक यूआरएल देना चाहिए. Cloud Shell Editor के टर्मिनल में लिंक खोलने के लिए, ctrl+click (Windows/Linux) या cmd+click (Mac) का इस्तेमाल करें. डिप्लॉय किए गए अपने ऐप्लिकेशन का यूआरएल देखें!

अपने हाल के बदलावों को देखने के लिए, आपको ctrl+shift+R (Windows/Linux) या cmd+shift+R (Mac) की मदद से "हार्ड रीफ़्रेश" करना पड़ सकता है.

Cloud Firestore जोड़ना

1. अगर Antigravity CLI पहले से शुरू नहीं है, तो उसे शुरू करें:

   agy
   

   Antigravity CLI, "क्या आपको इस फ़ोल्डर पर भरोसा है?" जैसे सवाल पूछ सकता है. डिफ़ॉल्ट सेटिंग स्वीकार करने के लिए, Enter दबाएं.
2. टास्क सेव करने के लिए, Antigravity CLI से Firestore जोड़ने के लिए कहें:

   Update the application to save tasks in Cloud Firestore for the signed-in user.
   A user should be able to add new tasks and see a list of their tasks.
   Deploy when you are done and give the URL to to me.
   

   Antigravity CLI, फ़ाइलें अपडेट करेगा. उसे ऐसा करने की अनुमति दें.

डिप्लॉयमेंट पूरा होने के बाद, उसे आपके वेब ऐप्लिकेशन के लिए एक यूआरएल देना चाहिए. Cloud Shell Editor के टर्मिनल में लिंक खोलने के लिए, ctrl+click (Windows/Linux) या cmd+click (Mac) का इस्तेमाल करें. डिप्लॉय किए गए अपने ऐप्लिकेशन का यूआरएल देखें!

अपने हाल के बदलावों को देखने के लिए, आपको ctrl+shift+R (Windows/Linux) या cmd+shift+R (Mac) की मदद से "हार्ड रीफ़्रेश" करना पड़ सकता है.

अगर आपका ऐप्लिकेशन उम्मीद के मुताबिक काम नहीं करता है, तो अपनी ज़रूरत के मुताबिक काम करने की सुविधा पाने के लिए, Antigravity CLI का इस्तेमाल जारी रखें. उदाहरण: shell Hide the task form when the user is logged out. Update the security rules so the user can see their TODOs.

अपनी नई Firebase ऐप्लिकेशन में, अपनी पसंद की सुविधाएं जोड़ने के लिए, इस लैब के साथ एक्सपेरिमेंट करते रहें.

7. नतीजा

बधाई हो! आपने एक स्किल बना ली है. साथ ही, Antigravity CLI के लिए अतिरिक्त स्किल इंस्टॉल करने का तरीका भी सीख लिया है.

(ज़रूरी नहीं) स्टोरेज में जगह बनाएं

अगर आप स्टोरेज में जगह बनाना चाहते हैं, तो अतिरिक्त शुल्क से बचने के लिए, अपना क्लाउड प्रोजेक्ट मिटाया जा सकता है.

अगर आपको प्रोजेक्ट मिटाना है, तो यह तरीका अपनाएं:

gcloud projects delete $GOOGLE_CLOUD_PROJECT

जगह खाली करने के लिए, Cloud Shell की डिस्क से गैर-ज़रूरी संसाधन भी मिटाए जा सकते हैं.

1. लैब की डायरेक्ट्री मिटाएं. इससे स्किल और ऐप्लिकेशन, दोनों मिट जाएंगे:

   rm -rf ~/agent-skills-lab
   

2. "टू डू" ऐप्लिकेशन की डायरेक्ट्री मिटाएं. यह डायरेक्ट्री, अगर आपने इसे बाहर बनाया है, तो ही मिटाई जा सकती है:

   rm -rf ~/todo-app
   

अगर आपको कभी भी Cloud Shell को उसकी डिफ़ॉल्ट स्थिति पर रीसेट करना है, तो ऐसा सुरक्षित तरीके से करने के निर्देश पाने के लिए, आधिकारिक दस्तावेज़ देखें.