حالت عامل

این سند حالت عامل را در Gemini Code Assist توضیح می‌دهد.

حالت عامل در محیط توسعه یکپارچه VS Code (IDE) موجود است. برای شروع استفاده از حالت عامل، به استفاده از گپ عامل به عنوان برنامه نویس جفتی مراجعه کنید.

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

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

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

حالت عامل چگونه کار می کند

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

هنگامی که یک ابزار درخواست می شود، عامل برای استفاده از ابزار آماده می شود و بررسی می کند که آیا مجاز به استفاده از ابزار با یا بدون مجوز صریح است:

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

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

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

برای کارهای پیچیده، Gemini ممکن است یک برنامه سطح بالا برای تایید شما نشان دهد. می‌توانید قبل از شروع فرآیند، طرح را تنظیم کنید و در چت سؤال بپرسید. هنگامی که از طرح راضی بودید، می توانید آن را تأیید کنید. پس از تایید طرح، کارگزار شروع به کار بر روی اولین وظیفه می کند و در صورت لزوم از شما توضیحات یا مجوزها را در هنگام اجرای طرح می خواهد.

زمینه حالت عامل

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

بسته به IDE و تنظیمات شما، زمینه های مختلفی ممکن است در دسترس نماینده باشد.

برگه های زیر نحوه جمع آوری متن برای IDE های مختلف را توضیح می دهند.

کد VS

روش‌های زیر برای دریافت زمینه معمولاً برای Gemini Code Assist در حالت عامل موجود است:

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

حافظه عامل

حالت عامل Gemini Code Assist در VS Code از سرویس کشف حافظه Gemini CLI برای یافتن و بارگیری فایل‌های GEMINI.md استفاده می‌کند که زمینه را برای عامل فراهم می‌کند. سرویس کشف حافظه این فایل ها را به صورت سلسله مراتبی جستجو می کند، از دایرکتوری فعلی شروع می شود و به سمت ریشه پروژه و دایرکتوری خانه شما حرکت می کند. همچنین در زیر شاخه ها جستجو می کند.

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

می‌توانید از دستور /memory show برای مشاهده محتوای ترکیبی همه فایل‌های GEMINI.md بارگذاری‌شده و دستور /memory refresh برای بارگذاری مجدد آنها استفاده کنید.

پسوندهای جمینی CLI

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

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

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

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

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

IntelliJ

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

ابزار

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

بعدش چی