از چت عاملی به عنوان برنامه نویس جفت استفاده کنید

کد VS

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

IntelliJ

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

• Gemini Code Assist برای افراد
• Gemini Code Assist Standard یا Enterprise

کد VS

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

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

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

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

حالت عامل Gemini Code Assist توسط Gemini CLI ارائه می شود.

IntelliJ

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

4. همانطور که نماینده مراحل انجام کار را طی می کند، شما می توانید هر تغییری را بررسی و تایید کنید.

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

کد VS

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

coreTools

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

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

کد VS

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

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

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

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

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

IntelliJ

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

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

3. طبق دستورالعمل هر سرور، هر سرور MCP محلی یا راه دور را در فایل mcp.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"]
       }
     }
   }
   

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

کد VS

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

IntelliJ

برای سرورهای 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 در مکانی ایجاد کنید که با محدوده مورد نظر شما مطابقت داشته باشد. جدول زیر مکان های فایل های زمینه را برای حوزه های مختلف توضیح می دهد:

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

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

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

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

IntelliJ

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

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

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

کد VS

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

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

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

IntelliJ

این ویژگی در 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 استفاده می‌کند و قبل از انجام اقداماتی که برای آن درخواست ارسال می‌کنید، اجازه نمی‌خواهد. هنگام استفاده از یک فضای کاری محدود ، نماینده قبل از انجام اقدامات بدون توجه به این تنظیم، از شما درخواست می کند.

IntelliJ

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

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