एआई एजेंट की सुविधाओं का इस्तेमाल कैसे करें (Gemini CLI और Firebase के लिए एजेंट की सुविधाओं के साथ)

1. परिचय

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

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

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

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

• किसी स्किल को स्ट्रक्चर करने का तरीका.
• SKILL.md फ़ाइल लिखने का तरीका.
• Gemini 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 फ़ाइल होती है. इस फ़ाइल में, एआई एजेंट को निर्देश और जानकारी दी जाती है. इस सेक्शन में, आपको एक ऐसी स्किल बनानी होगी जिससे Gemini 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 फ़ाइल की मदद से, आपने अपनी पहली स्किल बना ली है! अब इस स्किल का इस्तेमाल, Gemini CLI में किया जा सकता है.

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

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

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

   gemini
   

   आपको दिखेगा कि Gemini CLI ने नई स्किल को पहचान लिया है. कुछ डिफ़ॉल्ट सेटिंग स्वीकार करने के लिए, आपको Enter दबाना पड़ सकता है.

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

1. Gemini से, उसके कॉन्टेक्स्ट में उपलब्ध स्किल की सूची दिखाने के लिए कहें

   /skills
   

   आपको उपलब्ध स्किल की सूची में, my-favorite-things दिखेगी.
2. Gemini से अपने पसंदीदा रंग के बारे में पूछें:

   What is my favorite color?
   

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

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

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

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

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

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

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

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

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

1. अगर अब भी Gemini CLI में हैं, तो उससे बाहर निकलने के लिए /quit टाइप करें.
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-basics
• firebase-hosting-basics
• firebase-auth-basics
• firebase-firestore-enterprise-native-mode

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

इस कमांड से, firebase-basics और firebase-hosting-basics जैसी स्किल डाउनलोड और इंस्टॉल हो जाएंगी. इससे, Gemini 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. Gemini CLI शुरू करें:

   gemini
   

4. Gemini से, एक बेसिक 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.
   

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

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

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

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

   gemini
   

   Gemini, "क्या आपको इस फ़ोल्डर पर भरोसा है?" जैसे सवाल पूछ सकता है. डिफ़ॉल्ट सेटिंग स्वीकार करने के लिए, Enter दबाएं.
2. अब Gemini से, 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 the user.
   

   Gemini, index.html, style.css, और script.js जैसी फ़ाइलें बनाने या अपडेट करने के लिए कह सकता है. उसे ऐसा करने की अनुमति दें. Gemini, 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. अगर Gemini CLI पहले से शुरू नहीं है, तो उसे शुरू करें:

   gemini
   

   Gemini, "क्या आपको इस फ़ोल्डर पर भरोसा है?" जैसे सवाल पूछ सकता है. डिफ़ॉल्ट सेटिंग स्वीकार करने के लिए, Enter दबाएं.
2. टास्क सेव करने के लिए, Gemini से 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 the user.
   

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

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

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

अगर आपका ऐप्लिकेशन उम्मीद के मुताबिक काम नहीं करता है, तो अपनी ज़रूरत के हिसाब से फ़ंक्शनैलिटी पाने के लिए, Gemini 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. नतीजा

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

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

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

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

gcloud projects delete $GOOGLE_CLOUD_PROJECT

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

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

   rm -rf ~/agent-skills-lab
   

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

   rm -rf ~/todo-app
   

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