وضع موظّف الدعم

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

متطلبات النظام

يتوفّر "وضع الوكيل" بدءًا من الإصدار 4 من Android Studio Narwhal Feature Drop Canary. نزِّل أحدث إصدار معاينة من "استوديو Android".

البدء

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

1. انقر على Gemini في الشريط الجانبي. سجِّل الدخول وأكمِل عملية الإعداد إذا لزم الأمر.
2. انقر على علامة التبويب الوكيل.
3. قدِّم وصفًا للمَهمة التي تريد أن ينفّذها الوكيل.

4. أثناء تنفيذ الوكيل للخطوات اللازمة لإنجاز المهمة، سيكون بإمكانك مراجعة أي تغييرات والموافقة عليها.

   

5. اختياري: للموافقة على التغييرات تلقائيًا، انقر على خيارات الوكيل > الموافقة التلقائية على التغييرات.

   

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

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

• إصلاح أخطاء الإنشاء عندما تطلب من الوكيل إصلاح خطأ في الإصدار باستخدام طلب مثل "إصلاح أخطاء الإصدار في مشروعي"، سيطبّق الوكيل إصلاحًا مقترَحًا، وينشئ المشروع للتحقّق من الحلّ، ويكرّر العملية إلى أن يتم حلّ المشكلة.

  

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

• من المفيد توفير بيانات تجريبية عند إنشاء نماذج أولية واختبار تطبيقك، وبدلاً من إنشاء بيانات وهمية يدويًا، يمكنك تفويض هذه المهمة إلى الوكيل. في هذا المثال، طلبنا من الوكيل "إضافة جلستَين أخريَين إلى البيانات الوهمية". يعثر على الملف ذي الصلة ويضيف حدثَين آخرَين إلى قائمة mockSessions.

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

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

إضافة مفتاح Gemini API

يتضمّن "وضع الوكيل" التلقائي في Android Studio حصة يومية مجانية مع نافذة سياق محدودة. لتوسيع نطاق السياق، يمكنك إضافة مفتاح Gemini API الخاص بك للاستفادة من ما يصل إلى مليون رمز مميّز باستخدام Gemini 2.5 Pro.

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

للحصول على مفتاح واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

1. سجِّل الدخول إلى Google AI Studio واحصل على مفتاح من خلال النقر على الزر "الحصول على مفتاح واجهة برمجة التطبيقات".
2. في "استوديو Android"، انتقِل إلى ملف (استوديو Android على نظام التشغيل macOS) > الإعدادات > الأدوات > Gemini لإدخال مفتاح Gemini API.
3. أعِد تشغيل Gemini في Android Studio واحصل على ردود أفضل من "وضع Agent".

احرص على حماية مفتاح Gemini API لأنّه يتم فرض رسوم إضافية على استخدام Gemini API المرتبط بمفتاح واجهة برمجة تطبيقات شخصي. يمكنك تتبُّع استخدام مفتاح Gemini API في AI Studio من خلال الحصول على مفتاح API > الاستخدام والفوترة.

إضافة خادم MCP

يمكن أن يتفاعل Gemini في وكيل "استوديو Android" مع أدوات خارجية باستخدام بروتوكول سياق النموذج (MCP). توفّر هذه الميزة طريقة موحّدة لكي يستخدم &quot;وضع الوكيل&quot; الأدوات ويوسّع نطاق معرفته وقدراته ليشمل البيئة الخارجية.

هناك العديد من الأدوات التي يمكنك ربطها بمضيف MCP في "استوديو Android". على سبيل المثال، يمكنك الدمج مع خادم Github MCP لإنشاء طلبات سحب مباشرةً من Android Studio. للحصول على المزيد من الأفكار، اطّلِع على خوادم الأمثلة على MCP.

لإضافة خادم MCP، أنشئ ملف mcp.json وضعه في دليل الإعداد في Studio. يجب أن يتّبع ملف mcp.json التنسيق التالي:

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-memory"
      ]
    },
    "sequential-thinking": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sequential-thinking"
      ]
    },
    "github": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITHUB_PERSONAL_ACCESS_TOKEN",
        "ghcr.io/github/github-mcp-server"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

راجِع المستندات الخاصة بخادم MCP الذي تريد دمجه للحصول على command وargs الدقيقَين اللذين يجب إدراجهما في هذا الملف. قد تحتاج أيضًا إلى تثبيت أدوات مثل Node.js أو Docker، وذلك حسب متطلبات برنامج خادم MCP.

القيود

في ما يلي بعض القيود المهمة على دمج MCP في Android Studio:

• يجب أن تطبّق خوادم MCP عملية النقل stdio.
• لا تتوفّر بعد إمكانية استخدام بروتوكول HTTP للبث، بالإضافة إلى موارد MCP ونماذج الطلبات.

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

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

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