از حالت کمکی کد جمینی استفاده کنید

کد VS

1. نسخه‌ای از Gemini Code Assist را که می‌خواهید در IDE خود استفاده کنید، تنظیم کنید:
   • کمک کد جمینی برای افراد
   • استاندارد یا سازمانی کمک کد جمینی

اینتلی جی

نسخه‌ای از Gemini Code Assist را که می‌خواهید در IDE خود استفاده کنید، تنظیم کنید:

• کمک کد جمینی برای افراد
• استاندارد یا سازمانی کمک کد جمینی

کد VS

1. برای باز کردن چت Gemini Code Assist، در نوار فعالیت IDE خود، روی spark Gemini Code Assist کلیک کنید.
2. برای ورود به حالت عامل، روی دکمه‌ی تغییر وضعیت عامل کلیک کنید. این دکمه هنگام تغییر وضعیت به حالت عامل، هایلایت و هنگام چت معمولی، خاکستری می‌شود.
3. در چت Gemini Code Assist، درخواست خود را وارد کنید.

Gemini به درخواست شما پاسخ می‌دهد، یا اجازه استفاده از یک ابزار را درخواست می‌کند.

برای متوقف کردن عامل، روی stop » کلیک کنید.

برای استفاده از چت استاندارد Gemini Code Assist، روی add چت جدید کلیک کنید تا یک چت جدید ایجاد شود.

حالت عامل Gemini Code Assist توسط رابط خط فرمان Gemini پشتیبانی می‌شود.

اینتلی جی

1. در نوار ابزار پنجره، روی spark Gemini کلیک کنید. در صورت درخواست، وارد سیستم شوید.
2. برگه نماینده را انتخاب کنید.
3. وظیفه‌ای را که می‌خواهید نماینده انجام دهد، شرح دهید.

4. همزمان با اینکه نماینده مراحل انجام وظیفه را طی می‌کند، شما می‌توانید هرگونه تغییری را بررسی و تأیید کنید.

5. اختیاری: برای تأیید خودکار تغییرات، تنظیمات گزینه‌های نماینده را انتخاب کنید و روی کادر تأیید خودکار تغییرات کلیک کنید.

کد VS

شما می‌توانید از تنظیمات coreTools و excludeTools برای کنترل ابزارهایی که Gemini در حالت عامل به آنها دسترسی دارد، استفاده کنید.

coreTools

به شما امکان می‌دهد فهرستی از ابزارهایی را که می‌خواهید در مدل در دسترس باشند، مشخص کنید. همچنین می‌توانید محدودیت‌های خاص دستور را برای ابزارهایی که از آن پشتیبانی می‌کنند، مشخص کنید. به عنوان مثال - با اضافه کردن موارد زیر به تنظیمات Gemini خود، JSON فقط اجازه اجرای دستور ls -l پوسته را می‌دهد: "coreTools": ["ShellTool(ls -l)"] .

excludeTools

به شما امکان می‌دهد فهرستی از ابزارهایی را که نمی‌خواهید در مدل در دسترس باشند، مشخص کنید. همچنین می‌توانید محدودیت‌های خاص دستوری را برای ابزارهایی که از آن پشتیبانی می‌کنند، مشخص کنید. به عنوان مثال، اضافه کردن JSON زیر به تنظیمات Gemini شما، استفاده از دستور 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. برای حذف یک ابزار از استفاده توسط عامل، خط زیر را به تنظیمات JSON جمینی خود اضافه کنید:

   "excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   TOOL_NAME_1 و TOOL_NAME_2 با نام ابزارهای داخلی که می‌خواهید از استفاده‌ی عامل مستثنی شوند، جایگزین کنید.

5. برای حذف یک دستور ابزار از استفاده توسط عامل، خط زیر را به تنظیمات JSON جمینی خود اضافه کنید:

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

   موارد زیر را جایگزین کنید:

   • TOOL_NAME : نام ابزار داخلی
   • COMMAND : نام دستور ابزار داخلی که می‌خواهید از استفاده عامل مستثنی شود.

برای اطلاعات بیشتر در مورد تنظیمات پیکربندی coreTools و excludeTools ، به مستندات پیکربندی Gemini CLI مراجعه کنید.

اینتلی جی

این ویژگی در Gemini Code Assist برای IntelliJ یا سایر IDE های JetBrains پشتیبانی نمی‌شود.

کد VS

برای اینکه سرورهای MCP برای استفاده در حالت عامل در دسترس باشند، پیکربندی هر سرور را طبق مستندات هر سرور، در فایل JSON تنظیمات Gemini خود اضافه کنید.

1. هرگونه وابستگی مورد نیاز سرورهای MCP که اضافه می‌کنید را نصب کنید.
2. فایل JSON تنظیمات Gemini خود را که در ~/.gemini/settings.json قرار دارد، باز کنید. در اینجا ~ دایرکتوری خانگی شماست.

3. هر سرور MCP محلی یا راه دور را در فایل JSON تنظیمات Gemini، طبق دستورالعمل‌های هر سرور، پیکربندی کنید.

   فایل JSON تنظیمات Gemini در مثال زیر، دو سرور Cloudflare MCP از راه دور، یک سرور GitLab MCP از راه دور و یک سرور GitHub MCP محلی را برای استفاده با Gemini Code Assist در VS Code پیکربندی می‌کند.

   {
     "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 را انتخاب کنید.

سرورهای MCP پیکربندی‌شده شما برای استفاده توسط عامل در حالت عامل در دسترس هستند.

اینتلی جی

برای اینکه سرورهای MCP برای استفاده در حالت عامل در دسترس باشند، پیکربندی هر سرور را در یک فایل mcp.json اضافه کنید و فایل mcp.json را در دایرکتوری پیکربندی IDE خود قرار دهید.

1. هرگونه وابستگی مورد نیاز سرورهای MCP که اضافه می‌کنید را نصب کنید.
2. فایلی با نام mcp.json در پوشه‌ی پیکربندی IDE خود ایجاد کنید.

3. هر سرور MCP محلی یا راه دور را در فایل mcp.json ، طبق دستورالعمل‌های هر سرور، پیکربندی کنید.

   فایل mcp.json مثال زیر، دو سرور Cloudflare MCP از راه دور، یک سرور GitLab MCP از راه دور و یک سرور GitHub MCP محلی را برای استفاده با Gemini Code Assist در IntelliJ پیکربندی می‌کند.

   {
     "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"]
       }
     }
   }
   

سرورهای MCP پیکربندی‌شده شما برای استفاده توسط عامل در حالت عامل در دسترس هستند.

کد VS

برای سرورهای MCP که نیاز به احراز هویت دارند، می‌توانید آنها را به تنظیمات Gemini خود با فرمت JSON اضافه کنید.

مثال زیر نحوه تعیین یک توکن دسترسی شخصی برای سرورهای محلی و راه دور MCP در 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 توکن دسترسی کاربر است.

اینتلی جی

برای سرورهای MCP که نیاز به احراز هویت دارند، می‌توانید آنها را به فایل 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

1. فایلی با نام GEMINI.md در مکانی که با محدوده‌ای که می‌خواهید context در آن اعمال شود، مطابقت دارد، ایجاد کنید. جدول زیر جزئیات مکان فایل‌های context را برای محدوده‌های مختلف نشان می‌دهد:

   محدوده	مکان
   تمام پروژه‌های شما	~/.gemini/GEMINI.md
   یک پروژه مشخص	دایرکتوری کاری شما یا هر دایرکتوری والد دیگری تا ریشه پروژه شما (که با پوشه .git مشخص می‌شود) یا دایرکتوری خانگی شما.
   یک جزء، ماژول یا زیربخش خاص از یک پروژه	زیرشاخه‌های دایرکتوری کاری شما.

   سیستم حافظه عامل با بارگذاری فایل‌های زمینه از چندین مکان ایجاد می‌شود. زمینه از فایل‌های خاص‌تر، مانند فایل‌های مربوط به اجزا یا ماژول‌های خاص، محتوای فایل‌های زمینه عمومی‌تر مانند فایل زمینه سراسری در ~/.gemini/GEMINI.md را لغو یا تکمیل می‌کند.

2. هر قانون، اطلاعات راهنمای سبک یا زمینه‌ای را که می‌خواهید عامل از آن استفاده کند، در Markdown بنویسید و فایل را ذخیره کنید. برای اطلاعات بیشتر، به فایل زمینه نمونه در GitHub مراجعه کنید.

عامل، اطلاعات موجود در فایل زمینه شما را به همراه هرگونه درخواستی که برای آن ارسال می‌کنید، درج می‌کند.

اینتلی جی

1. فایلی با نام GEMINI.md یا AGENT.md در ریشه پروژه خود ایجاد کنید.

2. هر قانون، اطلاعات راهنمای سبک یا زمینه‌ای را که می‌خواهید عامل از آن در Markdown استفاده کند، بنویسید و فایل را ذخیره کنید.

عامل، اطلاعات موجود در فایل context شما را به همراه هر گونه درخواستی که به آن ارسال می‌کنید، در خود جای می‌دهد. همچنین می‌توانید با افزودن دستی یک فایل با سینتکس @ FILENAME که در آن FILENAME نام فایلی است که اطلاعات context مورد نظر شما در آن قرار دارد، context را اضافه کنید.

کد VS

می‌توانید از دستورات داخلی Gemini CLI زیر در حالت عامل استفاده کنید:

• /tools : فهرستی از ابزارهای موجود در جلسه حالت عامل شما را نمایش می‌دهد.
• /mcp : فهرستی از سرورهای پیکربندی‌شده‌ی پروتکل زمینه مدل (MCP)، وضعیت اتصال آنها، جزئیات سرور و ابزارهای موجود را نمایش می‌دهد.

برای اطلاعات بیشتر در مورد دستورات Gemini CLI، به دستورات Gemini CLI و دستورات سفارشی Gemini مراجعه کنید. توجه داشته باشید که همه دستورات Gemini CLI در حالت عامل در دسترس نیستند.

اینتلی جی

این ویژگی در Gemini Code Assist برای IntelliJ یا سایر IDE های JetBrains پشتیبانی نمی‌شود.

کد VS

از حالت yolo برای مجاز کردن خودکار تمام اقدامات عامل استفاده کنید. حالت Yolo فقط در یک فضای کاری قابل اعتماد قابل استفاده است.

برای پیکربندی حالت yolo:

1. فایل JSON تنظیمات کاربری VS Code خود را باز کنید:

   1. پالت Command را باز کنید ( ctrl / command + Shift + P ).
   2. تنظیمات برگزیده را انتخاب کنید: تنظیمات کاربر (JSON) را باز کنید .

2. موارد زیر را به فایل JSON تنظیمات کاربر VS Code خود اضافه کنید:

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

3. پالت فرمان را باز کنید و Developer: Reload Window را انتخاب کنید.

حالت عامل از حالت yolo استفاده می‌کند و قبل از انجام اقدامات، وقتی به آن اعلان ارسال می‌کنید، اجازه نمی‌گیرد. هنگام استفاده از یک فضای کاری محدود، عامل صرف نظر از این تنظیم، قبل از انجام اقدامات، اعلان می‌کند.

اینتلی جی

برای تأیید خودکار تغییرات، در برگه «نماینده چت Gemini»، «تنظیمات» «گزینه‌های نماینده» را انتخاب کنید و سپس روی کادر تأیید خودکار تغییرات کلیک کنید.

حالت عامل (Agent mode) به طور خودکار همه درخواست‌ها را تأیید می‌کند و قبل از انجام اقدامات، وقتی که برای آن درخواستی ارسال می‌کنید، اجازه نمی‌گیرد.