توضّح هذه المستندات وضع الوكيل في Gemini Code Assist.
تتوفّر أداة Agent Mode في بيئتَي التطوير المتكاملتَين (IDE) VS Code وIntelliJ. لبدء استخدام "وضع الوكيل"، يُرجى الاطّلاع على استخدام "وضع الوكيل" في Gemini Code Assist.
يستند "وضع الوكيل" في VS Code إلى Gemini CLI.
لا يستخدم "وضع الوكيل" في IntelliJ واجهة Gemini CLI.
باستخدام "وضع الوكيل"، يمكنك تنفيذ أيّ من الإجراءات التالية وغيرها:
- طرح أسئلة حول الرمز البرمجي
- استخدِم السياق والأدوات المضمّنة لتحسين المحتوى الذي تم إنشاؤه.
- ضبط خوادم MCP لتوسيع قدرات الوكيل
- الحصول على حلول للمهام المعقّدة التي تتضمّن عدة خطوات
- إنشاء رموز برمجية من مستندات التصميم والمشاكل وتعليقات
TODO - التحكّم في سلوك الوكيل من خلال التعليق على الخطط وتعديلها والموافقة عليها واستخدام الأدوات أثناء التنفيذ
طريقة عمل "وضع الوكيل"
في وضع "الوكيل"، يتم إرسال طلبك إلى Gemini API مع قائمة بالأدوات المتاحة. يعالج Gemini API الطلب ويعرض ردًا. قد تكون الاستجابة عبارة عن إجابة مباشرة أو طلب لاستخدام أداة متاحة.
عند طلب استخدام أداة، يستعد الوكيل لاستخدامها ويتحقّق مما إذا كان مسموحًا له باستخدامها بإذن صريح أو بدونه:
- بالنسبة إلى طلبات الأدوات التي تعدّل نظام الملفات أو تنفّذ عمليات تغيير على أي موارد، سيطلب منك Gemini السماح بالعملية ما لم تكن قد ضبطت Gemini على السماح دائمًا بالأداة أو الأدوات.
- قد لا تطلب أدوات القراءة فقط الإذن قبل إكمال المهمة.
عندما يُطلب منك السماح باستخدام إحدى الأدوات، يمكنك اختيار السماح بالعملية أو رفضها. قد يقدّم لك الوكيل أيضًا خيارات للسماح دائمًا باستخدام أداة أو خادم أو السماح بعمليات مشابهة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة السماح دائمًا بإجراءات الوكيل.
بعد منح الإذن باستخدام الأداة أو منحه ذاتيًا، يستخدم الوكيل الأداة لإكمال الإجراء المطلوب، ويتم إرسال نتيجة هذا الإجراء إلى Gemini API. يعالج Gemini نتيجة إجراء الأداة وينشئ ردًا آخر. وتتكرر دورة الإجراء والتقييم هذه إلى أن تكتمل المهمة.
بالنسبة إلى المهام المعقّدة، قد يعرض Gemini خطة عامة لتوافق عليها. يمكنك تحسين الخطة وطرح الأسئلة في المحادثة قبل بدء العملية. بعد أن تصبح راضيًا عن الخطة، يمكنك الموافقة عليها. بعد الموافقة على الخطة، يبدأ الوكيل في العمل على المهمة الأولى، وسيطلب منك توضيحات أو أذونات حسب الحاجة أثناء تنفيذ الخطة.
سياق "وضع الوكيل"
يسمح السياق للوكيل بإنشاء ردود أفضل على طلب معيّن. يمكن استخلاص السياق من الملفات في بيئة التطوير المتكاملة (IDE) ومن الملفات في مجلدات النظام المحلية ومن ردود الأدوات ومن تفاصيل طلبك.
قد تتوفّر سياقات مختلفة للوكيل استنادًا إلى بيئة التطوير المتكاملة والإعدادات.
توضّح علامات التبويب التالية كيفية جمع السياق لمختلف بيئات التطوير المتكاملة.
VS Code
تتوفّر عادةً الطرق التالية للحصول على السياق في وضع الوكيل في Gemini Code Assist:
- المعلومات في مساحة عمل بيئة التطوير المتكاملة (IDE)
- ردود الأدوات من الأدوات المضمّنة، مثل grep أو الوحدة الطرفية أو قراءة الملفات أو كتابة الملفات
- ردود "بحث Google"
- محتوى من عنوان URL محدّد تم تقديمه في طلب أو بواسطة أداة
- ملفات السياق التي تنشئها في Markdown
IntelliJ
تتوفّر عادةً الطرق التالية للحصول على السياق في وضع الوكيل في Gemini Code Assist:
- المعلومات الواردة في مشروع بيئة التطوير المتكاملة (IDE)، بما في ذلك الملفات والرموز المفهرسة واستخدام الرموز في مشروعك
- ردود الأدوات من الأدوات المضمّنة، مثل grep أو قراءة الملفات أو كتابة الملفات
- التحكّم بالإصدار في IntelliJ
- الخوادم والأدوات التي تم إعدادها في "برنامج شركاء المحتوى"
- ملفات السياق التي تنشئها في Markdown
يمكنك الاطّلاع على السياق المتاح للوكيل في درج السياق في منطقة طلب المحادثة في "وضع الوكيل".
الأدوات
الأدوات هي فئة واسعة من الخدمات التي يمكن أن يستخدمها الوكيل للحصول على السياق وتنفيذ الإجراءات في رده على طلبك. تتيح الأدوات للوكلاء الوصول إلى معلومات حديثة من خلال استدعاء الدوال إلى نقاط نهاية واجهة برمجة التطبيقات أو إلى وكلاء آخرين. قد توفّر الأدوات وظيفة واحدة فقط، أو قد توفّر وظائف متعدّدة ذات صلة.
تشمل بعض الأمثلة على الأدوات، الأدوات المضمّنة مثل grep وقراءة الملفات أو كتابتها، وخوادم بروتوكول سياق النموذج (MCP) المحلية أو البعيدة ووظائفها القابلة للتنفيذ، واستدعاءات واجهة برمجة التطبيقات RESTful.
الأدوات المضمّنة
في وضع الوكيل، يمكن لـ Gemini الوصول إلى أدوات النظام المدمجة. اختَر بيئة التطوير المتكاملة (IDE) للاطّلاع على قائمة بالأدوات المضمّنة المتاحة في Gemini في وضع "الوكيل".
VS Code
تتوفّر جميع الأدوات المضمَّنة في Gemini CLI في "وضع الوكيل" في 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 المصادر، ولا يمكنك إيقاف اقتراحات الرموز البرمجية التي تتطابق مع المصادر المذكورة.