एजेंटिक चैट का इस्तेमाल, पेयर प्रोग्रामर के तौर पर करना

झलक देखें

इस प्रॉडक्ट या सुविधा को झलक के तौर पर देखा जा सकता है. यह Gemini Code Assist के insiders channel पर उपलब्ध है. झलक के तौर पर उपलब्ध कराए गए प्रॉडक्ट और सुविधाएं, "जैसी हैं वैसी" ही उपलब्ध कराई जाती हैं.

इस दस्तावेज़ में, इंटिग्रेटेड डेवलपमेंट एनवायरमेंट (आईडीई) में, Gemini Code Assist के एजेंट मोड को पेयर प्रोग्रामर के तौर पर कॉन्फ़िगर करने और इस्तेमाल करने का तरीका बताया गया है.

एजेंट मोड, VS Code आईडीई में उपलब्ध है.

एजेंट मोड की मदद से, इनमें से कोई भी काम किया जा सकता है. इसके अलावा, और भी काम किए जा सकते हैं:

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

सीमाएं

एजेंट मोड का इस्तेमाल करते समय, ये सीमाएं लागू होती हैं:

• एजेंट, Gemini Code Assist के टूल को कॉल नहीं कर सकता. इन टूल का इस्तेमाल करने के लिए, आपको एजेंट मोड से बाहर निकलना होगा.
• एजेंट, कोड को पसंद के मुताबिक बनाने की सुविधा का इस्तेमाल नहीं कर सकता. कोड को पसंद के मुताबिक़ बनाने की सुविधा का इस्तेमाल करने के लिए, आपको एजेंट मोड से बाहर निकलना होगा.
• एजेंट मोड में, एक से ज़्यादा रूट वाले प्रोजेक्ट इस्तेमाल नहीं किए जा सकते. अगर आपने एक से ज़्यादा रूट डायरेक्ट्री वाले प्रोजेक्ट में एजेंट मोड का इस्तेमाल किया है, तो एजेंट के पास सिर्फ़ पहली रूट डायरेक्ट्री का ऐक्सेस होगा.
• Gemini for Google Cloud के लॉग, एजेंट मोड में काम नहीं करते.

शुरू करने से पहले

1. अपने आईडीई में Gemini Code Assist के उस एडिशन को सेट अप करें जिसका आपको इस्तेमाल करना है:
   • Gemini Code Assist for individuals
   • Gemini Code Assist Standard या Enterprise
2. Gemini Code Assist के रिलीज़ चैनल को Insiders बिल्ड पर सेट करें:
   1. कमांड पैलेट (Cmd + Shift + P) खोलें. इसके बाद, Open User Settings JSON चुनें.
   2. उपयोगकर्ता की सेटिंग वाले JSON में यह लाइन जोड़ें:

      "geminicodeassist.updateChannel": "Insiders",

एजेंट मोड का इस्तेमाल करना

एजेंट मोड में, Gemini से मुश्किल टास्क पूरे करने और बड़े लक्ष्यों को हासिल करने के लिए कहा जा सकता है.

एजेंट मोड का ज़्यादा से ज़्यादा फ़ायदा पाने के लिए, प्रॉम्प्ट देने के सबसे सही तरीके अपनाएं. साथ ही, ज़्यादा से ज़्यादा जानकारी दें.

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

एजेंट मोड पर स्विच करने के लिए:

VS Code

1. Gemini Code Assist चैट खोलने के लिए, अपने आईडीई के ऐक्टिविटी बार में, spark Gemini Code Assist पर क्लिक करें.
2. एजेंट मोड में जाने के लिए, एजेंट टॉगल पर क्लिक करें. एजेंट मोड पर टॉगल करने पर, टॉगल हाइलाइट हो जाता है. वहीं, सामान्य चैट में यह स्लेटी रंग का होता है.
3. Gemini Code Assist की चैट में, अपना प्रॉम्प्ट डालें.

Gemini, आपके प्रॉम्प्ट का जवाब देता है या किसी टूल का इस्तेमाल करने की अनुमति मांगता है.

एजेंट को रोकने के लिए, बंद करें पर क्लिक करें.

Gemini Code Assist की स्टैंडर्ड चैट का इस्तेमाल करने के लिए, नई चैट पर क्लिक करके नई चैट बनाएं.

Gemini Code Assist के एजेंट मोड को Gemini CLI की मदद से चलाया जाता है.

IntelliJ

यह सुविधा, IntelliJ या अन्य JetBrains IDE के लिए Gemini Code Assist में काम नहीं करती.

एजेंट मोड के लिए टूल कॉन्फ़िगर करना

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

MCP सर्वर कॉन्फ़िगर करना

यह कंट्रोल करने के लिए कि एजेंट मोड में कौनसे सर्वर उपलब्ध हैं, उन्हें सर्वर के दस्तावेज़ के मुताबिक अपने Gemini की सेटिंग वाले JSON में जोड़ें.

चेतावनी: एमसीपी सर्वर, आपके उपयोगकर्ता खाते के लिए उपलब्ध अनुमतियों के साथ कोई भी कोड चला सकते हैं. पक्का करें कि आपको इस्तेमाल किए जा रहे किसी भी एमसीपी सर्वर के सोर्स पर भरोसा हो.

VS Code

ध्यान दें: एजेंट मोड के लिए, MCP सर्वर इंस्टॉल करने के लिए कमांड पैलेट का इस्तेमाल नहीं किया जा सकता. आपको Gemini की सेटिंग वाले JSON में, एमसीपी सर्वर जोड़ने होंगे.

1. अपने एमसीपी सर्वर के लिए ज़रूरी डिपेंडेंसी इंस्टॉल करें.
2. ~/.gemini/settings.json में मौजूद Gemini की सेटिंग वाला JSON खोलें. यहाँ ~ आपकी होम डायरेक्ट्री है.

3. सर्वर के निर्देशों के मुताबिक, Gemini की सेटिंग वाले JSON में लोकल या रिमोट एमसीपी सर्वर जोड़ें.

   इस उदाहरण में, रिमोट Cloudflare MCP सर्वर को जोड़ा गया है. साथ ही, लोकल मशीन पर GitHub और GitLab सर्वर इंस्टॉल किए गए हैं.

   {
       "mcpServers": {
       "github": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-github"
         ],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": [
             "-y",
             "@modelcontextprotocol/server-gitlab"
         ]
       },
           "cloudflare-observability": {
               "command": "npx",
               "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
           },
           "cloudflare-bindings": {
               "command": "npx",
               "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
           }
       }
   }
   

4. कमांड पैलेट खोलें और Developer: Reload Window चुनें.

कॉन्फ़िगर किए गए एमसीपी सर्वर, एजेंट मोड में एजेंट के लिए उपलब्ध होते हैं.

IntelliJ

यह सुविधा, IntelliJ या अन्य JetBrains IDE के लिए Gemini Code Assist में काम नहीं करती.

MCP सर्वर की पुष्टि करना

पुष्टि करने की सुविधा की ज़रूरत वाले एमसीपी सर्वर को, Gemini की सेटिंग वाले JSON में जोड़ा जा सकता है.

यहां दिए गए उदाहरण में, GitHub के लिए निजी ऐक्सेस टोकन जोड़ा गया है:

{
//other settings...

"github": {
  "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
  "args": ["stdio"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
  }
},

// other settings...
}

यहाँ ACCESS_TOKEN, उपयोगकर्ता का ऐक्सेस टोकन है.

कॉन्टेक्स्ट फ़ाइल बनाना

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

VS Code

1. GEMINI.md नाम की फ़ाइल ऐसी जगह पर बनाएं जहां आपको कॉन्टेक्स्ट लागू करना है. यहां दी गई टेबल में, अलग-अलग स्कोप के लिए कॉन्टेक्स्ट फ़ाइलों की जगहों के बारे में जानकारी दी गई है:

   दायरा	जगह
   आपके सभी प्रोजेक्ट	~/.gemini/GEMINI.md
   कोई खास प्रोजेक्ट	आपकी वर्किंग डायरेक्ट्री या कोई भी पैरंट डायरेक्ट्री, आपके प्रोजेक्ट रूट (.git फ़ोल्डर से पहचाना जाता है) या आपकी होम डायरेक्ट्री तक.
   किसी प्रोजेक्ट का कोई कॉम्पोनेंट, मॉड्यूल या सब-सेक्शन	आपकी वर्किंग डायरेक्ट्री की सबडायरेक्ट्री.

   एजेंट के मेमोरी सिस्टम को कई जगहों से कॉन्टेक्स्ट फ़ाइलें लोड करके बनाया जाता है. ज़्यादा खास फ़ाइलों से मिले कॉन्टेक्स्ट, जैसे कि खास कॉम्पोनेंट या मॉड्यूल के लिए फ़ाइलें, ज़्यादा सामान्य कॉन्टेक्स्ट फ़ाइलों से मिले कॉन्टेंट को बदल देती हैं या उसमें कुछ और जानकारी जोड़ देती हैं. जैसे, ~/.gemini/GEMINI.md पर मौजूद ग्लोबल कॉन्टेक्स्ट फ़ाइल.

2. मार्कडाउन में कोई भी नियम, स्टाइल गाइड की जानकारी या कॉन्टेक्स्ट लिखें. इसके बाद, फ़ाइल को सेव करें. ज़्यादा जानकारी के लिए, GitHub पर उदाहरण के तौर पर दी गई कॉन्टेक्स्ट फ़ाइल देखें.

IntelliJ

यह सुविधा, IntelliJ या अन्य JetBrains IDE के लिए Gemini Code Assist में काम नहीं करती.

निर्देशों का इस्तेमाल करना

स्लैश / कमांड की मदद से, टर्मिनल विंडो में मौजूद कमांड की तरह ही कमांड को तुरंत चलाया जा सकता है.

एजेंट मोड में, Gemini CLI की इन कमांड का इस्तेमाल किया जा सकता है:

• /tools: इससे, उन टूल की सूची दिखती है जो एजेंट मोड वाले सेशन में उपलब्ध हैं. सबकमांड में ये शामिल हैं:
  • desc या descriptions: इससे हर टूल के बारे में पूरी जानकारी दिखती है.
  • nodesc या nodescriptions: इससे टूल के ब्यौरे छिप जाते हैं और सिर्फ़ टूल के नाम दिखते हैं.
• /memory: यह कुकी, एजेंट के निर्देश वाले कॉन्टेक्स्ट को मैनेज करती है. यह कॉन्टेक्स्ट, GEMINI.md फ़ाइलों से लोड किया जाता है. सबकमांड में ये शामिल हैं:
  • show: इससे, सभी उपलब्ध GEMINI.md फ़ाइलों से लोड की गई मौजूदा मेमोरी का पूरा कॉन्टेंट दिखता है.
  • refresh: यह उपलब्ध जगहों पर मौजूद सभी GEMINI.md फ़ाइलों से मेमोरी को फिर से लोड करता है. GEMINI.md फ़ाइलें, एजेंट की हैरारिकल मेमोरी में किस तरह योगदान देती हैं, इस बारे में जानने के लिए Gemini CLI कॉन्फ़िगरेशन का दस्तावेज़ देखें.
• /mcp: कॉन्फ़िगर किए गए मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, उनके कनेक्शन की स्थिति, सर्वर की जानकारी, और उपलब्ध टूल की सूची दिखाता है. सबकमांड में ये शामिल हैं:
  • desc या descriptions: इससे एमसीपी सर्वर और टूल के बारे में पूरी जानकारी मिलती है.
  • nodesc या nodescriptions: इससे एमसीपी सर्वर के ब्यौरे छिप जाते हैं और सिर्फ़ एमसीपी सर्वर के नाम दिखते हैं.
  • schema: इससे, एमसीपी सर्वर के कॉन्फ़िगर किए गए पैरामीटर के लिए पूरा JSON स्कीमा दिखता है.
• /stats: इससे एजेंट मोड के सेशन के आंकड़े और अवधि की जानकारी दिखती है.

Gemini CLI के निर्देशों के बारे में ज़्यादा जानने के लिए, Gemini CLI के निर्देश लेख पढ़ें. ध्यान दें कि एजेंट मोड में, Gemini CLI की सभी कमांड उपलब्ध नहीं होती हैं.

एजेंट की कार्रवाइयों को हमेशा अनुमति दें

आपके पास एजेंट की सभी कार्रवाइयों को अपने-आप अनुमति देने का विकल्प होता है.

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

एजेंट की सभी कार्रवाइयों को अपने-आप अनुमति देने के लिए:

1. VS Code की उपयोगकर्ता सेटिंग वाली JSON फ़ाइल खोलें:

   1. कमांड पैलेट (ctrl/command + Shift + P) खोलें.
   2. प्राथमिकताएं: उपयोगकर्ता सेटिंग (JSON) खोलें को चुनें.

2. VS Code की उपयोगकर्ता सेटिंग वाली JSON फ़ाइल में यह जोड़ें:

   //other settings...
   
   "geminicodeassist.agentYoloMode": "true",
   //other settings...
   

3. कमांड पैलेट खोलें और Developer: Reload Window चुनें.

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

Gemini CLI एक्सटेंशन बनाना

Gemini CLI एक्सटेंशन का इस्तेमाल करके, Gemini Code Assist के एजेंट मोड की सुविधा को कॉन्फ़िगर और बढ़ाया जा सकता है.

एजेंट, एक्सटेंशन को दो जगहों पर खोजता है:

• WORKSPACE/.gemini/extensions जहां WORKSPACE आपका मौजूदा फ़ाइल फ़ोल्डर है.
• ~/.gemini/extensions में ~ आपकी होम डायरेक्ट्री है.

एजेंट, दोनों जगहों से सभी एक्सटेंशन लोड करता है. हालांकि, अगर दोनों जगहों पर एक ही नाम का एक्सटेंशन मौजूद है, तो वर्कस्पेस डायरेक्ट्री में मौजूद एक्सटेंशन को प्राथमिकता दी जाएगी. हर एक्सटेंशन एक डायरेक्ट्री होती है, जिसमें gemini-extension.json फ़ाइल होती है. इस फ़ाइल में एक्सटेंशन का कॉन्फ़िगरेशन होता है.

ज़्यादा जानकारी के लिए, Gemini CLI एक्सटेंशन देखें.

अन्य प्रॉम्प्ट

अपनी जानकारी के साथ इन प्रॉम्प्ट को आज़माएँ:

• "यह रिपॉज़िटरी क्या करती है? इस आर्किटेक्चर को समझने में मेरी मदद करो."
• "यह [class/function] क्या करता है?"
• "इस कोडबेस में कोई सुविधा जोड़ो - "[link-or-path-to-codebase]"."
• "फ़ंक्शन [A] और [B] को फिर से फ़ैक्टर करें, ताकि वे सामान्य तरीके [C] का इस्तेमाल कर सकें."
• "GitHub से जुड़ी समस्या [link-to-github-issue] को ठीक करो."
• "[environment] में [task] करने के लिए, [goal] वाला ऐप्लिकेशन बनाओ. इसका यूज़र इंटरफ़ेस (यूआई) ऐसा होना चाहिए कि उपयोगकर्ता [task] कर सके."
• "इस रिपॉज़िटरी में मौजूद लाइब्रेरी के वर्शन को [X] से [Y] पर माइग्रेट करो."
• "इस Go कोड की परफ़ॉर्मेंस को ऑप्टिमाइज़ करो, ताकि यह तेज़ी से काम करे."
• "इस सुविधा को बनाने के लिए, [name-of-API] का इस्तेमाल करें."
• "[x], [Y], और [Z] को पूरा करने के लिए, एक एल्गोरिदम लागू करो."

आगे क्या करना है

• Gemini Code Assist के बारे में खास जानकारी पढ़ें.
• एमसीपी सर्वर के कुछ उदाहरण देखें.
• GitHub पर मौजूद ज़्यादा एमसीपी सर्वर ढूंढें.
• अपने आईडीई से सुझाव/राय दें या शिकायत करें.