وضع الوكيل

تم تصميم ميزة Agent Mode ضمن "Gemini في استوديو Android" للتعامل مع مهام التطوير المعقّدة والمتعدّدة المراحل التي تتجاوز ما يمكنك تجربته من خلال الدردشة مع Gemini فقط. يمكنك وصف هدف رفيع المستوى، وسينشئ الوكيل خطة وينفّذها، ويستدعي الأدوات اللازمة، ويجري تغييرات على عدة ملفات، ويصلح الأخطاء بشكل متكرر. يتيح لك سير العمل هذا الذي يقدّمه وكيل التغلّب على التحديات المعقّدة وتسريع عملية التطوير.

الشكل 1: Gemini في ميزة Agent Mode ضمن "استوديو Android".

البدء

للبدء في "وضع الوكيل" في Android Studio، اتّبِع الخطوات التالية:

  1. انقر على Gemini في شريط نافذة الأدوات. سجِّل الدخول وأكمِل عملية الإعداد إذا لزم الأمر.
  2. انقر على علامة التبويب الوكيل.
  3. قدِّم وصفًا للمَهمة التي تريد أن ينفّذها الوكيل.
  4. راجِع أي تغييرات ووافِق عليها أثناء عمل الوكيل لإنجاز المهمة.
ينتظر "وضع الوكيل" موافقتك على التغيير أو رفضه.
الشكل 2: ينتظرك "وضع الوكيل" للموافقة على التغيير أو رفضه.
  1. اختياري: للموافقة على التغييرات تلقائيًا، انقر على خيارات الوكيل > الموافقة التلقائية على التغييرات.
الموافقة تلقائيًا على التغييرات التي يقترحها الوكيل
الشكل 3: الموافقة تلقائيًا على التغييرات التي يقترحها البرنامج

حالات الاستخدام

في ما يلي بعض الأمثلة على حالات الاستخدام التي يمكن أن يساعدك فيها الوكيل:

  • أصلِح أخطاء الإنشاء. عندما تطلب من الوكيل إصلاح خطأ في الإصدار باستخدام طلب مثل "إصلاح أخطاء الإصدار في مشروعي"، سيطبّق الوكيل إصلاحًا مقترَحًا، وينشئ المشروع للتحقّق من الحلّ، ويكرّر العملية إلى أن يتم حلّ المشكلة.
يبني الوكيل مشروعك ويقيّم ما إذا كانت هناك أخطاء.
الشكل 4: ينشئ الوكيل مشروعك ويقيّم ما إذا كانت هناك أخطاء.
  • إضافة عناصر واجهة المستخدم أو تعديلها: يمكن للوكيل إضافة عناصر واجهة المستخدم أو تعديلها. على سبيل المثال، يمكنك أن تطلب من الوكيل "ضبط المظهر الداكن كإعداد تلقائي في إعدادات المستخدم"، وسيبحث الوكيل عن الملفات ذات الصلة ويقترح تغييرات لإكمال المهمة. يمكنك معاينة تعديلات واجهة المستخدم على الفور في نافذة أداة الأجهزة قيد التشغيل.
الشكل 5: الوكيل يعدّل عناصر واجهة المستخدم.
  • إنشاء بيانات وهمية عند إنشاء نماذج أولية واختبار تطبيقك، يمكنك أن تطلب من الوكيل إنشاء بيانات وهمية بدلاً من إنشائها يدويًا. على سبيل المثال، عندما يُطلب من الوكيل "إضافة جلستَين أخريَين إلى البيانات الوهمية"، يعثر الوكيل على الملف ذي الصلة ويضيف حدثَين آخرَين إلى قائمة mockSessions.
الشكل 6: الوكيل ينشئ بيانات وهمية.

إليك بعض الطلبات الأخرى التي يمكنك تجربتها:

  • "اكتب اختبارات وحدات لـ <class> في <module>"
  • "إنشاء مستندات للملف المفتوح"
  • "تغيير عنوان التطبيق من <الاسم الحالي> إلى <الاسم الجديد>"
  • "حلّ مشكلة استثناء المؤشر الفارغ"
  • أريد إعادة تصميم الرمز البرمجي من خلال نقل الدالة البرمجية القابلة للإنشاء <اسم الدالة البرمجية القابلة للإنشاء> إلى ملف جديد. التأكّد من تعديل جميع عمليات الاستيراد"
  • "أريد إضافة زر جديد إلى الشاشة الرئيسية للتطبيق باسم "متابعة" ينقلني إلى قائمة بالمواضيع".
  • "في العنصر القابل للإنشاء <composable name>، قلِّل مساحة الحشو الخاصة بالمعدِّل <modifier name>"
  • "إنشاء زر مشاركة على وسائل التواصل الاجتماعي"

طريقة عمل الوكيل

في "وضع الوكيل"، يتم إرسال طلبك إلى Gemini API مع قائمة بالأدوات المتاحة. يمكنك اعتبار الأدوات مهارات، فهي تشمل القدرة على البحث عن الملفات وقراءتها والبحث عن النص داخل الملفات واستخدام أي خوادم MCP تم إعدادها وغير ذلك.

عندما تمنح الوكيل مهمة، ينشئ خطة ويحدد الأدوات المطلوبة. قد تتطلّب منك بعض هذه الأدوات منح الإذن قبل أن يتمكّن الوكيل من استخدامها. بعد منح الإذن، يستخدم الوكيل الأداة لتنفيذ الإجراء اللازم وإرسال النتيجة إلى Gemini API. يعالج Gemini نتيجة الإجراء وينشئ ردًا آخر. وتستمر دورة العمل والتقييم هذه إلى أن تكتمل المهمة.