حالت عامل

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

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

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

حالت عامل در IntelliJ از 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 برای بارگذاری مجدد آنها استفاده کنید.

IntelliJ

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

  • اطلاعات پروژه IDE شما از جمله فایل های شما، نمادهای نمایه شده و استفاده از نمادها در پروژه شما.
  • پاسخ های ابزار از ابزارهای داخلی مانند grep، خواندن فایل یا نوشتن فایل.
  • کنترل نسخه IntelliJ.
  • سرورها و ابزارهای MCP پیکربندی شده
  • فایل های زمینه ای که در Markdown ایجاد می کنید.

می‌توانید زمینه موجود برای عامل را در کشوی زمینه در ناحیه درخواست چت حالت نماینده ببینید.

کشوی زمینه حالت عامل.

ابزار

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

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

ابزارهای داخلی

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

کد VS

همه ابزارهای داخلی Gemini CLI برای حالت عامل در Gemini Code Assist در دسترس هستند.

IntelliJ

read_file
محتوای متنی یک فایل را با استفاده از مسیر مطلق آن بازیابی می کند.
write_file
متن داده شده را در یک فایل مشخص می نویسد و در صورت عدم وجود آن فایل را ایجاد می کند.
analyze_current_file
فایل باز شده در ویرایشگر را برای خطاها و هشدارها تجزیه و تحلیل می کند.
find_files
مسیر مطلق فایل هایی که نام فایل یا بخشی از مسیر داده شده را پیدا می کند
grep
تمام فایل های داخل پروژه را که حاوی یک الگوی متنی یا عبارت منظم هستند را پیدا می کند.
list_files
تمام فایل ها و دایرکتوری ها را در یک مسیر مطلق مشخص لیست می کند.
resolve_symbol
ارجاع یک نماد خاص به اعلان اصلی خود را حل می کند.
find_usages
پروژه را برای همه ارجاعات به یک اعلان نماد معین جستجو می کند.
git
دستور رابط خط فرمان Git (CLI) را اجرا می کند و نتیجه را برمی گرداند.
list_vcs_roots
تمام ریشه های سیستم کنترل نسخه (VCS) مانند مخازن Git را در پروژه فعلی برمی گرداند.

محدودیت ها

برخی از ویژگی‌های چت استاندارد Gemini Code Assist ممکن است در حالت نماینده در دسترس نباشند یا ممکن است متفاوت از چت استاندارد کار کنند.

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

بعدش چی