توضّح هذه المستندات وضع الوكيل في Gemini Code Assist.
تتوفّر أداة Agent Mode في بيئتَي التطوير المتكاملتَين (IDE) VS Code وIntelliJ. لبدء استخدام "وضع الوكيل"، راجِع مقالة استخدام الدردشة المستندة إلى الوكيل كأداة للبرمجة الثنائية.
يستند وضع "الوكيل" في VS Code إلى Gemini CLI.
لا يستخدم "وضع الوكيل" في IntelliJ واجهة سطر الأوامر في Gemini.
باستخدام "وضع الوكيل"، يمكنك تنفيذ أيّ من الإجراءات التالية وغيرها:
- طرح أسئلة حول الرمز البرمجي
- استخدِم السياق والأدوات المضمّنة لتحسين المحتوى الذي تم إنشاؤه.
- إعداد خوادم MCP لتوسيع قدرات الوكيل
- الحصول على حلول للمهام المعقّدة التي تتضمّن عدة خطوات
- إنشاء رموز برمجية من مستندات التصميم والمشاكل وتعليقات
TODO - التحكّم في سلوك الوكيل من خلال التعليق على الخطط وتعديلها والموافقة عليها واستخدام الأدوات أثناء التنفيذ
طريقة عمل "وضع الوكيل"
في وضع "الوكيل"، يتم إرسال طلبك إلى Gemini API مع قائمة بالأدوات المتاحة. يعالج Gemini API الطلب ويعرض ردًا. قد تكون الاستجابة عبارة عن إجابة مباشرة أو طلب لاستخدام أداة متاحة.
عند طلب استخدام أداة، يستعد الوكيل لاستخدامها ويتحقّق مما إذا كان مسموحًا له باستخدامها بإذن صريح أو بدونه:
- بالنسبة إلى طلبات الأدوات التي تعدّل نظام الملفات أو تنفّذ عمليات تغيير على أي موارد، سيطلب منك Gemini السماح بالعملية ما لم تكن قد ضبطت Gemini على السماح دائمًا بالأداة أو الأدوات.
- قد لا تطلب أدوات القراءة فقط الإذن قبل إكمال المهمة.
عندما يُطلب منك السماح باستخدام إحدى الأدوات، يمكنك اختيار السماح بالعملية أو رفضها. قد يمنحك البرنامج أيضًا خيارات للسماح دائمًا لأداة أو خادم أو السماح بعمليات مشابهة. لمزيد من المعلومات، يُرجى الاطّلاع على السماح دائمًا بإجراءات الوكيل.
بعد منح الإذن باستخدام الأداة أو منحه ذاتيًا، يستخدم الوكيل الأداة لإكمال الإجراء المطلوب، ويتم إرسال نتيجة هذا الإجراء إلى Gemini API. يعالج Gemini نتيجة إجراء الأداة وينشئ ردًا آخر. وتستمر دورة العمل والتقييم هذه إلى أن تكتمل المهمة.
بالنسبة إلى المهام المعقّدة، قد يعرض Gemini خطة عامة لتوافق عليها. يمكنك تحسين الخطة وطرح الأسئلة في المحادثة قبل بدء العملية. بعد أن تصبح راضيًا عن الخطة، يمكنك الموافقة عليها. بعد الموافقة على الخطة، يبدأ الوكيل في العمل على المهمة الأولى، وسيطلب منك توضيحات أو أذونات حسب الحاجة أثناء تنفيذ الخطة.
سياق "وضع الوكيل"
يسمح السياق للوكيل بإنشاء ردود أفضل على طلب معيّن. يمكن استخلاص السياق من الملفات في بيئة التطوير المتكاملة (IDE) ومن الملفات في مجلدات النظام المحلي ومن ردود الأدوات ومن تفاصيل طلبك.
قد تتوفّر سياقات مختلفة للوكيل استنادًا إلى بيئة التطوير المتكاملة والإعدادات.
توضّح علامات التبويب التالية كيفية جمع السياق لمختلف بيئات التطوير المتكاملة.
VS Code
تتوفّر عادةً الطرق التالية للحصول على السياق في Gemini Code Assist في وضع "الوكيل":
- المعلومات في مساحة عمل بيئة التطوير المتكاملة (IDE)
- ردود الأدوات من الأدوات المضمّنة، مثل grep أو الوحدة الطرفية أو قراءة الملفات أو كتابة الملفات
- ردود "بحث Google"
- المحتوى من عنوان URL معيّن تم تقديمه في طلب أو بواسطة أداة
- ملفات السياق التي تنشئها في Markdown
ذاكرة موظّف الدعم
يستفيد وضع "الوكيل" في Gemini Code Assist في VS Code من خدمة اكتشاف الذاكرة في Gemini CLI للعثور على الملفات التي توفّر السياق للوكيل وتحميلها.GEMINI.md تبحث خدمة استكشاف الذاكرة عن هذه الملفات بشكل هرمي، بدءًا من دليل العمل الحالي، ثم تنتقل إلى جذر المشروع ودليل المنزل. يبحث أيضًا في الأدلة الفرعية.
يمكنك إنشاء ملفات سياق عامة وعلى مستوى المشروع وعلى مستوى المكوّن، ويتم دمجها كلها لتزويد النموذج بأكثر المعلومات ملاءمةً.
يمكنك استخدام الأمر /memory show للاطّلاع على المحتوى المدمج لجميع ملفات GEMINI.md التي تم تحميلها، والأمر /memory refresh لإعادة تحميلها.
IntelliJ
تتوفّر عادةً الطرق التالية للحصول على السياق في Gemini Code Assist في وضع "الوكيل":
- المعلومات الواردة في مشروع بيئة التطوير المتكاملة (IDE)، بما في ذلك الملفات والرموز المفهرسة واستخدام الرموز في مشروعك
- ردود الأدوات المضمّنة، مثل grep أو قراءة الملفات أو كتابة الملفات
- التحكّم بالإصدار في IntelliJ
- الخوادم والأدوات التي تم إعدادها في "برنامج إدارة العملاء"
- ملفات السياق التي تنشئها في Markdown
يمكنك الاطّلاع على السياق المتاح للوكيل في درج السياق في منطقة طلب المحادثة في "وضع الوكيل".
الأدوات
الأدوات هي فئة واسعة من الخدمات التي يمكن أن يستخدمها الوكيل للحصول على السياق وتنفيذ الإجراءات في رده على طلبك. تتيح الأدوات للوكلاء الوصول إلى معلومات حديثة من خلال استدعاء الدوال إلى نقاط نهاية واجهة برمجة التطبيقات أو إلى وكلاء آخرين. قد توفّر الأدوات وظيفة واحدة فقط، أو قد توفّر وظائف متعدّدة ذات صلة.
تشمل بعض الأمثلة على الأدوات، الأدوات المضمّنة مثل grep والقراءة أو الكتابة في الملفات، وخوادم بروتوكول سياق النموذج (MCP) المحلية أو البعيدة ووظائفها القابلة للتنفيذ، واستدعاءات واجهة برمجة التطبيقات (API) المتوافقة مع REST.
الأدوات المضمَّنة
في وضع "الوكيل"، يمكن لـ Gemini الوصول إلى أدوات النظام المضمّنة. اختَر بيئة التطوير المتكاملة (IDE) للاطّلاع على قائمة بالأدوات المضمّنة المتاحة في Gemini في وضع "الوكيل".
VS Code
تتوفّر جميع الأدوات المضمّنة في واجهة سطر الأوامر من Gemini في وضع "الوكيل" في Gemini Code Assist.
IntelliJ
read_file- يستردّ المحتوى النصي لملف باستخدام مساره المطلق.
write_file- يكتب النص المحدّد في ملف معيّن، وينشئ الملف إذا لم يكن متوفّرًا.
analyze_current_file- تحلّل الملف المفتوح في المحرّر بحثًا عن الأخطاء والتحذيرات.
find_files- العثور على المسار المطلق للملفات باستخدام اسم الملف أو جزء من المسار
grep- للعثور على جميع الملفات داخل المشروع التي تحتوي على نمط نص أو تعبير عادي معيّن.
list_files- تعرض هذه السمة قائمة بجميع الملفات والأدلة في مسار مطلق معيّن.
resolve_symbol- يحلّ مرجع رمز معيّنًا إلى تعريفاته الأصلية.
find_usages- يبحث في المشروع عن جميع المراجع لتعريف رمز معيّن.
git- تُنفِّذ أمرًا من واجهة سطر الأوامر (CLI) في Git وتعرض النتيجة.
list_vcs_roots- تعرض هذه السمة جميع جذور نظام التحكّم في الإصدارات (VCS)، مثل مستودعات Git، في المشروع الحالي.
القيود
قد لا تتوفّر بعض ميزات محادثة Gemini Code Assist العادية في وضع "الوكيل"، أو قد تعمل بشكل مختلف عن طريقة عملها في المحادثة العادية.
لا تتوفّر ميزة التلاوة في وضع "المساعد الذكي". عند استخدام وضع "الوكيل"، لا يذكر Gemini المصادر، ولا يمكنك إيقاف اقتراحات الرموز البرمجية التي تتطابق مع المصادر المذكورة.