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

1. परिचय

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

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

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

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

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

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

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

एजेंट की स्किल, ऐसी डायरेक्ट्री होती हैं जिनमें कम से कम एक 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 Hosting पर कोई ऐप्लिकेशन बनाएं और उसे डिप्लॉय करें

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

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

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

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

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

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

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

   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 for Firebase इंस्टॉल करना होगा.

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

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 के लिए एजेंट स्किल के बारे में ज़्यादा जानने के लिए, उपलब्ध स्किल देखें.

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

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 के लिए एजेंट स्किल का इस्तेमाल करना चाहिए. ज़रूरत के हिसाब से, एजेंट को निर्देश दें और मंज़ूरी दें.

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

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

1. अगर Antigravity CLI पहले से चालू नहीं है, तो इसे चालू करें:

   agy
   

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

   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 कंसोल में कुछ कार्रवाइयां करने के लिए कह सकता है. अगर CLI को इन कामों को करने के लिए कहा जाए, तो वह इनमें से ज़्यादातर काम कर सकता है. हालांकि, अगर आपके 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. "To Do" ऐप्लिकेशन डायरेक्ट्री मिटाएं. अगर आपने इसे बाहर बनाया है, तो:

   rm -rf ~/todo-app
   

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