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

VS Code

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

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

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

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

IntelliJ

1. टूल विंडो बार में, spark Gemini पर क्लिक करें. अगर आपसे कहा जाए, तो साइन इन करें.
2. एजेंट टैब चुनें.
3. उस टास्क के बारे में जानकारी दें जिसे एजेंट को पूरा करना है.

4. जब एजेंट किसी टास्क को पूरा करने के लिए एक चरण से दूसरे चरण पर जाता है, तो आपके पास हर बदलाव की समीक्षा करने और उसे स्वीकार करने का विकल्प होता है.

5. ज़रूरी नहीं: बदलावों को अपने-आप मंज़ूरी देने के लिए, सेटिंग एजेंट के विकल्प को चुनें. इसके बाद, बदलावों को अपने-आप मंज़ूरी दें के बगल में मौजूद चेकबॉक्स पर क्लिक करें.

VS Code

coreTools और excludeTools की सेटिंग का इस्तेमाल करके, यह कंट्रोल किया जा सकता है कि एजेंट मोड में Gemini किन टूल को ऐक्सेस कर सकता है.

coreTools

इसकी मदद से, उन टूल की सूची बनाई जा सकती है जिन्हें आपको मॉडल के लिए उपलब्ध कराना है. इसके अलावा, उन टूल के लिए कमांड के हिसाब से पाबंदियां भी तय की जा सकती हैं जिनमें यह सुविधा काम करती है. उदाहरण के लिए—Gemini की सेटिंग वाले JSON में यह जानकारी जोड़ने पर, सिर्फ़ ls -l shell कमांड को एक्ज़ीक्यूट किया जा सकेगा:"coreTools": ["ShellTool(ls -l)"].

excludeTools

इस सेटिंग की मदद से, उन टूल की सूची तय की जा सकती है जिन्हें मॉडल के लिए उपलब्ध नहीं कराना है. इसके अलावा, उन टूल के लिए कमांड के हिसाब से पाबंदियां भी तय की जा सकती हैं जिनमें यह सुविधा काम करती है. उदाहरण के लिए—Gemini की सेटिंग वाले JSON में यह जानकारी जोड़ने पर, rm -rf कमांड का इस्तेमाल नहीं किया जा सकेगा: "excludeTools": ["ShellTool(rm -rf)"].

excludeTools और coreTools, दोनों में शामिल टूल को बाहर रखा जाता है.

एजेंट मोड में उपलब्ध बिल्ट-इन टूल को कॉन्फ़िगर करने के लिए, यह तरीका अपनाएं:

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

2. एजेंट के लिए, मंज़ूरी पा चुके टूल की सूची में शामिल टूल के इस्तेमाल को सीमित करने के लिए, Gemini की सेटिंग वाले JSON में यह लाइन जोड़ें:

   "coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   TOOL_NAME_1 और TOOL_NAME_2 की जगह, पहले से मौजूद टूल के नाम डालें. ये वे टूल होने चाहिए जिनका ऐक्सेस आपको एजेंट को देना है.

   आपके पास जितने चाहें उतने बिल्ट-इन टूल की सूची बनाने का विकल्प होता है. डिफ़ॉल्ट रूप से, एजेंट के लिए सभी बिल्ट-इन टूल उपलब्ध होते हैं.

3. अगर आपको एजेंट टूल के इस्तेमाल को टूल के कुछ खास निर्देशों तक सीमित रखना है, तो Gemini की सेटिंग वाले JSON में यह लाइन जोड़ें:

   "coreTools": ["TOOL_NAME(COMMAND)"]
   

   इनकी जगह ये डालें:

   • TOOL_NAME: पहले से मौजूद टूल का नाम
   • COMMAND: बिल्ट-इन टूल कमांड का वह नाम जिसे आपको एजेंट के लिए इस्तेमाल करने की अनुमति देनी है.

4. किसी टूल को एजेंट के इस्तेमाल से बाहर रखने के लिए, Gemini की सेटिंग वाले JSON में यह लाइन जोड़ें:

   "excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   TOOL_NAME_1 और TOOL_NAME_2 की जगह, उन बिल्ट-इन टूल के नाम डालें जिन्हें एजेंट के इस्तेमाल से बाहर रखना है.

5. किसी टूल कमांड को एजेंट के इस्तेमाल से बाहर रखने के लिए, Gemini की सेटिंग वाले JSON में यह लाइन जोड़ें:

   "excludeTools": ["TOOL_NAME(COMMAND)"]
   

   इनकी जगह ये डालें:

   • TOOL_NAME: पहले से मौजूद टूल का नाम
   • COMMAND: बिल्ट-इन टूल कमांड का वह नाम जिसे आपको एजेंट के इस्तेमाल से बाहर रखना है.

coreTools और excludeTools कॉन्फ़िगरेशन सेटिंग के बारे में ज़्यादा जानने के लिए, Gemini CLI कॉन्फ़िगरेशन का दस्तावेज़ देखें.

IntelliJ

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

VS Code

एमसीपी सर्वर को एजेंट मोड में इस्तेमाल करने के लिए, अपनी Gemini सेटिंग की JSON फ़ाइल में हर सर्वर के लिए कॉन्फ़िगरेशन जोड़ें. इसके लिए, हर सर्वर के दस्तावेज़ देखें.

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

3. Gemini की सेटिंग वाली JSON फ़ाइल में, हर लोकल या रिमोट एमसीपी सर्वर को कॉन्फ़िगर करें. इसके लिए, हर सर्वर के निर्देशों का पालन करें.

   Gemini की सेटिंग वाले इस JSON फ़ाइल के उदाहरण में, VS Code में Gemini Code Assist के साथ इस्तेमाल करने के लिए, दो रिमोट Cloudflare MCP सर्वर, एक रिमोट GitLab MCP सर्वर, और एक लोकल GitHub MCP सर्वर कॉन्फ़िगर किया गया है.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
       },
       "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

एमसीपी सर्वर को एजेंट मोड में इस्तेमाल करने के लिए, हर सर्वर के कॉन्फ़िगरेशन को mcp.json फ़ाइल में जोड़ें. इसके बाद, mcp.json फ़ाइल को अपने आईडीई की कॉन्फ़िगरेशन डायरेक्ट्री में रखें.

1. जो एमसीपी सर्वर जोड़े जा रहे हैं उनके लिए ज़रूरी डिपेंडेंसी इंस्टॉल करें.
2. अपने आईडीई की कॉन्फ़िगरेशन डायरेक्ट्री में mcp.json नाम की एक फ़ाइल बनाएं.

3. हर सर्वर के निर्देशों के मुताबिक, mcp.json फ़ाइल में हर लोकल या रिमोट एमसीपी सर्वर को कॉन्फ़िगर करें.

   यहां दिए गए उदाहरण mcp.json फ़ाइल में, दो रिमोट Cloudflare एमसीपी सर्वर, एक रिमोट GitLab एमसीपी सर्वर, और एक लोकल GitHub एमसीपी सर्वर को कॉन्फ़िगर किया गया है. इनका इस्तेमाल IntelliJ में Gemini Code Assist के साथ किया जा सकता है.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
       },
       "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"]
       }
     }
   }
   

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

VS Code

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

यहां दिए गए उदाहरण में, GitHub के लोकल और रिमोट एमसीपी सर्वर के लिए निजी ऐक्सेस टोकन तय करने का तरीका बताया गया है:

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    },
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

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

IntelliJ

जिन एमसीपी सर्वर के लिए पुष्टि करना ज़रूरी है उन्हें अपनी mcp.json फ़ाइल में जोड़ा जा सकता है.

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

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

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

VS Code

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

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

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

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

एजेंट, आपकी कॉन्टेक्स्ट फ़ाइल में मौजूद जानकारी को आपके भेजे गए किसी भी प्रॉम्प्ट के साथ शामिल करता है.

IntelliJ

1. अपने प्रोजेक्ट के रूट में GEMINI.md या AGENT.md नाम की फ़ाइल बनाएं.

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

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

VS Code

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

• /tools: इससे, उन टूल की सूची दिखती है जो एजेंट मोड वाले सेशन में उपलब्ध हैं.
• /mcp: इससे कॉन्फ़िगर किए गए मॉडल कॉन्टेक्स्ट प्रोटोकॉल (एमसीपी) सर्वर, उनके कनेक्शन की स्थिति, सर्वर की जानकारी, और उपलब्ध टूल की सूची दिखती है.

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

IntelliJ

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

VS Code

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

यलो मोड को कॉन्फ़िगर करने के लिए:

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 चुनें.

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

IntelliJ

बदलावों को अपने-आप मंज़ूरी देने के लिए, Gemini Chat एजेंट टैब में जाकर, सेटिंग एजेंट के विकल्प को चुनें. इसके बाद, बदलावों को अपने-आप मंज़ूरी दें के बगल में मौजूद चेकबॉक्स पर क्लिक करें.

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