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

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

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

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

البدء

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

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

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

   

5. اختياري: للموافقة تلقائيًا على التغييرات، اختَر خيارات موظّفي الدعم > الموافقة التلقائية على التغييرات.

   

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

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

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

  

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

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

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

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

إضافة مفتاح 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 والحصول على ردود أفضل من "وضع الوكيل ".

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

إضافة خادم MCP

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

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

لإضافة خادم MCP، أنشئ ملف mcp.json وضعه في دليل الإعدادات في "استوديو YouTube". يجب أن يتّبع ملف 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 نتيجة الإجراء وينشئ ردًا آخر. وتستمر دورة الخطوات والتقييم هذه إلى أن تكتمل المهمة.