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

این سند نحوه پیکربندی و استفاده از حالت عامل Gemini Code Assist را به عنوان برنامه نویس جفت در محیط توسعه یکپارچه خود (IDE) توضیح می دهد.

حالت عامل در VS Code IDE موجود است.

با حالت عامل، می توانید هر یک از موارد زیر و موارد دیگر را انجام دهید:

  • در مورد کد خود سوال بپرسید.
  • از زمینه و ابزارهای داخلی برای بهبود محتوای تولید شده استفاده کنید.
  • سرورهای MCP را برای گسترش توانایی های عامل پیکربندی کنید.
  • برای کارهای پیچیده با چند مرحله راه حل دریافت کنید.
  • کد را از اسناد طراحی، مسائل و نظرات TODO ایجاد کنید.
  • با اظهار نظر، ویرایش و تایید طرح ها و استفاده از ابزار در حین اجرا، رفتار عامل را کنترل کنید.

محدودیت ها

محدودیت های زیر هنگام استفاده از حالت عامل اعمال می شود:

  • نماینده نمی‌تواند با ابزارهای Gemini Code Assist تماس بگیرد. برای استفاده از این ابزارها باید از حالت عامل خارج شوید.
  • عامل نمی تواند از سفارشی سازی کد استفاده کند. برای استفاده از سفارشی سازی کد باید از حالت عامل خارج شوید.
  • پروژه‌های دارای چندین ریشه در حالت عامل پشتیبانی نمی‌شوند. اگر از حالت عامل در پروژه ای با دایرکتوری های ریشه متعدد استفاده می کنید، عامل فقط به اولین دایرکتوری ریشه ای که با آن برخورد می کند دسترسی دارد.
  • گزارش‌های Gemini برای Google Cloud در حالت نماینده پشتیبانی نمی‌شوند.

قبل از شروع

  1. نسخه Gemini Code Assist را که می‌خواهید در IDE خود استفاده کنید، تنظیم کنید:
  2. کانال انتشار Gemini Code Assist خود را روی بیلد Insiders تنظیم کنید:
    1. پالت Command ( Cmd + Shift + P ) را باز کنید و سپس Open User Settings JSON را انتخاب کنید.
    2. خط زیر را به تنظیمات کاربر JSON خود اضافه کنید: 
      "geminicodeassist.updateChannel": "Insiders",

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

در حالت عامل، می توانید از Gemini بخواهید که اهداف سطح بالا و کارهای پیچیده را انجام دهد.

برای استفاده حداکثری از حالت عامل، بهترین روش‌های پیشنهادی را دنبال کنید و تا حد امکان جزئیات را ارائه دهید.

برای تغییر به حالت نماینده:

کد VS

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

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

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

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

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

IntelliJ

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

ابزارها را برای حالت عامل پیکربندی کنید

ابزارها دسته وسیعی از خدمات هستند که یک نماینده می تواند برای زمینه و اقدامات در پاسخ به درخواست شما از آنها استفاده کند. برخی از ابزارهای نمونه، ابزارهای داخلی مانند خواندن یا نوشتن grep و فایل، سرورهای پروتکل بافت مدل (MCP) محلی یا راه دور و عملکردهای اجرایی آن‌ها یا اجرای خدمات سفارشی هستند.

سرورهای MCP را پیکربندی کنید

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

کد VS

  1. هر وابستگی مورد نیاز سرور MCP خود را نصب کنید.
  2. تنظیمات Gemini JSON خود را که در ~/.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

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

احراز هویت سرور MCP

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

یک فایل زمینه ایجاد کنید

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

کد VS

  1. فایلی به نام GEMINI.md در مکانی ایجاد کنید که با محدوده مورد نظر شما مطابقت داشته باشد. جدول زیر مکان های فایل های زمینه را برای حوزه های مختلف توضیح می دهد:

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

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

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

IntelliJ

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

از دستورات استفاده کنید

دستورات اسلش / به شما امکان می دهد دستورات مشابه دستورات را در پنجره ترمینال به سرعت اجرا کنید.

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

  • /tools : فهرستی از ابزارهایی را که در جلسه حالت عامل شما در دسترس هستند را نمایش می دهد. دستورات فرعی شامل موارد زیر است:
    • desc or descriptions : توضیحات مفصل هر ابزار را نشان می دهد.
    • nodesc یا nodescriptions : توضیحات ابزار را پنهان می کند و فقط نام ابزار را نشان می دهد.
  • /memory : زمینه آموزشی عامل بارگیری شده از فایل های GEMINI.md را مدیریت می کند. دستورات فرعی شامل موارد زیر است:
    • show : محتوای کامل و به هم پیوسته حافظه فعلی بارگیری شده از همه فایل های موجود GEMINI.md را نمایش می دهد.
    • refresh : حافظه همه فایل های GEMINI.md را در مکان های موجود دوباره بارگیری می کند. برای اطلاعات در مورد نحوه کمک فایل‌های GEMINI.md به حافظه سلسله مراتبی عامل، به مستندات پیکربندی Gemini CLI مراجعه کنید.
  • /mcp : سرورهای پیکربندی شده پروتکل بافت مدل (MCP)، وضعیت اتصال آنها، جزئیات سرور و ابزارهای موجود را فهرست می کند. دستورات فرعی شامل موارد زیر است:
    • desc or descriptions : توضیحات مفصلی از سرورها و ابزارهای MCP را نشان می دهد.
    • nodesc یا nodescriptions : توضیحات سرور MCP را پنهان می کند و فقط نام سرور MCP را نشان می دهد.
    • schema : طرح کامل JSON را برای پارامترهای پیکربندی شده سرور MCP نشان می دهد.
  • /stats : آمار جلسه و مدت زمان دقیق حالت نماینده را نمایش می دهد.

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

همیشه به اقدامات نماینده اجازه دهید

می‌توانید به‌طور خودکار به همه اقدامات عامل اجازه دهید.

برای مجاز کردن خودکار همه اقدامات عامل:

  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 CLI ایجاد کنید

می‌توانید از برنامه‌های افزودنی Gemini CLI برای پیکربندی و گسترش عملکرد حالت عامل Gemini Code Assist استفاده کنید.

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

  • WORKSPACE /.gemini/extensions که در آن WORKSPACE فضای کاری فعلی شماست.
  • ~/.gemini/extensions که در آن ~ فهرست اصلی شماست.

عامل همه برنامه‌های افزودنی را از هر دو مکان بارگیری می‌کند، اما اگر افزونه‌ای با نام یکسان در هر دو وجود داشته باشد، پسوندی در فهرست فضای کاری اولویت دارد. هر پسوند یک دایرکتوری است که حاوی یک فایل gemini-extension.json است. این فایل شامل پیکربندی برای پسوند است.

برای اطلاعات بیشتر، برنامه‌های افزودنی CLI Gemini را ببینید.

درخواست های اضافی

دستورات زیر را با اطلاعات خود امتحان کنید:

  • "این مخزن چه کاری انجام می دهد؟ به من در درک معماری کمک کنید."
  • "این [کلاس/عملکرد] چه می کند؟"
  • "یک ویژگی به این پایگاه کد - "[link-or-path-to-codebase]" اضافه کنید."
  • "توابع Refactor [A] و [B] برای استفاده از روش رایج [C]."
  • "مشکل GitHub [link-to-github-issue] را برطرف کنید."
  • "یک برنامه کاربردی برای انجام [هدف] با یک رابط کاربری بسازید که به کاربر اجازه می دهد [وظیفه] را در [محیط] انجام دهد."
  • "نسخه های کتابخانه موجود در این مخزن را از [X] به [Y] منتقل کنید."
  • "عملکرد این کد Go را بهینه کنید تا سریعتر اجرا شود."
  • "از [name-of-API] برای ایجاد این ویژگی استفاده کنید."
  • "الگوریتمی را برای انجام [x]، [Y] و [Z] اجرا کنید."

بعدش چی