استخدام الدردشة المستندة إلى الذكاء الاصطناعي كأداة للبرمجة الثنائية

معاينة

هذا المنتج أو الميزة في مرحلة المعاينة ومتاحان على قناة الإصدارات التجريبية في Gemini Code Assist. تتوفّر المنتجات والميزات التي تكون في مرحلة المعاينة "كما هي".

يوضّح هذا المستند كيفية ضبط وضع "البرمجة الثنائية" واستخدامه في Gemini Code Assist ضمن بيئة التطوير المتكاملة (IDE).

يتوفّر "وضع المساعد الذكي" في بيئة التطوير المتكاملة (IDE) في VS Code.

باستخدام "وضع الوكيل"، يمكنك تنفيذ أيّ من الإجراءات التالية وغيرها:

• طرح أسئلة حول الرمز البرمجي
• استخدِم السياق والأدوات المضمّنة لتحسين المحتوى الذي تم إنشاؤه.
• إعداد خوادم MCP لتوسيع قدرات الوكيل
• الحصول على حلول للمهام المعقّدة التي تتضمّن عدة خطوات
• إنشاء رموز برمجية من مستندات التصميم والمشاكل وتعليقات TODO
• التحكّم في سلوك الوكيل من خلال التعليق على الخطط وتعديلها والموافقة عليها واستخدام الأدوات أثناء التنفيذ

القيود

تنطبق القيود التالية عند استخدام "وضع الوكيل":

• لا يمكن للوكيل استدعاء أدوات Gemini Code Assist. يجب الخروج من وضع "الوكيل" لاستخدام هذه الأدوات.
• لا يمكن للوكيل استخدام تخصيص الرمز. يجب الخروج من وضع "الوكيل" لاستخدام ميزة تخصيص الرمز.
• لا تتوافق المشاريع التي تتضمّن جذورًا متعددة مع وضع "الوكيل". إذا كنت تستخدم وضع الوكيل في مشروع يتضمّن عدة أدلة جذرية، سيتمكّن الوكيل من الوصول إلى دليل الجذر الأول الذي يصادفه فقط.
• لا تتوفّر سجلّات "Gemini في Google Cloud" في وضع الوكيل.

قبل البدء

1. اضبط إصدار Gemini Code Assist الذي تريد استخدامه في بيئة التطوير المتكاملة (IDE) باتّباع الخطوات التالية:
   • ‫Gemini Code Assist للأفراد
   • ‫Gemini Code Assist Standard أو Enterprise
2. ضبط قناة إصدار Gemini Code Assist على إصدار Insiders:
   1. افتح لوحة الأوامر (Cmd + Shift + P)، ثم اختَر فتح ملف JSON لإعدادات المستخدم.
   2. أضِف السطر التالي إلى ملف JSON الخاص بإعدادات المستخدم:

      "geminicodeassist.updateChannel": "Insiders",

استخدام "وضع الوكيل"

في وضع "الوكيل"، يمكنك أن تطلب من Gemini إكمال أهداف رفيعة المستوى ومهام معقّدة.

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

تنبيه: لا يتوفّر خيار للتراجع عن التغييرات التي تم إجراؤها على الموارد خارج بيئة التطوير المتكاملة (IDE) في وضع "الوكيل"، لذا عليك توخّي الحذر عند استخدامه.

للتبديل إلى وضع "الوكيل"، اتّبِع الخطوات التالية:

VS Code

1. لفتح محادثة Gemini Code Assist، انقر على spark Gemini Code Assist في شريط الأنشطة الخاص ببيئة التطوير المتكاملة.
2. انقر على مفتاح التبديل الوكيل للدخول إلى وضع الوكيل. يتم تمييز مفتاح التبديل عند التبديل إلى وضع الدردشة مع الموظف، ويظهر باللون الرمادي عند إجراء محادثة عادية.
3. في محادثة Gemini Code Assist، أدخِل طلبك.

يقدّم لك Gemini ردًا على طلبك، أو يطلب الإذن باستخدام إحدى الأدوات.

لإيقاف العامل، انقر على إيقاف.

لاستخدام محادثة Gemini Code Assist العادية، انقر على محادثة جديدة لإنشاء محادثة جديدة.

يستند وضع وكيل Gemini Code Assist إلى واجهة سطر الأوامر (CLI) من Gemini.

IntelliJ

لا تتوفّر هذه الميزة في "أداة كتابة الرموز البرمجية من Gemini" في IntelliJ أو غيرها من بيئات التطوير المتكاملة من JetBrains.

ضبط الأدوات لوضع "الوكيل"

الأدوات هي فئة واسعة من الخدمات التي يمكن للوكيل استخدامها للحصول على السياق وتنفيذ الإجراءات في رده على طلبك. تشمل بعض الأمثلة على الأدوات، الأدوات المضمّنة مثل grep والقراءة أو الكتابة في الملفات، أو خوادم بروتوكول سياق النموذج (MCP) المحلية أو البعيدة ووظائفها القابلة للتنفيذ، أو عمليات تنفيذ الخدمات المخصّصة.

إعداد خوادم MCP

للتحكّم في الخوادم المتاحة في وضع البرنامج الوكيل، أضِفها إلى ملف JSON الخاص بإعدادات Gemini وفقًا لوثائق الخادم.

تنبيه: يمكن لخوادم MCP تنفيذ أي رمز باستخدام الأذونات المتاحة لحساب المستخدم. تأكَّد من أنّ مصدر أي خوادم MCP تستخدمها موثوق به.

VS Code

ملاحظة: لا يمكنك استخدام لوحة الأوامر لتثبيت خوادم MCP لوضع "الوكيل". يجب إضافة خوادم MCP إلى ملف JSON الخاص بإعدادات Gemini.

1. ثبِّت أي عناصر تابعة يتطلّبها خادم MCP.
2. افتح ملف JSON الخاص بإعدادات Gemini والموجود في ~/.gemini/settings.json حيث ~ هو دليل منزلك.

3. أضِف خوادم MCP محلية أو بعيدة إلى ملف JSON الخاص بإعدادات Gemini وفقًا لتعليمات الخادم.

   يضيف المثال التالي خادم Cloudflare MCP البعيد، ويُثبّت خادمي GitHub وGitLab على الجهاز المحلي.

   {
       "mcpServers": {
       "github": {
         "command": "npx",
         "args": [
           "-y",
           "@modelcontextprotocol/server-github"
         ],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": [
             "-y",
             "@modelcontextprotocol/server-gitlab"
         ]
       },
           "cloudflare-observability": {
               "command": "npx",
               "args": ["mcp-remote", "https://observability.mcp.cloudflare.com/sse"]
           },
           "cloudflare-bindings": {
               "command": "npx",
               "args": ["mcp-remote", "https://bindings.mcp.cloudflare.com/sse"]
           }
       }
   }
   

4. افتح لوحة الأوامر واختَر Developer: Reload Window.

تتوفّر خوادم MCP التي تم ضبطها للوكيل لاستخدامها في وضع الوكيل.

IntelliJ

لا تتوفّر هذه الميزة في "أداة كتابة الرموز البرمجية من Gemini" في IntelliJ أو غيرها من بيئات التطوير المتكاملة من JetBrains.

مصادقة خادم MCP

بالنسبة إلى خوادم MCP التي تتطلّب المصادقة، يمكنك إضافتها إلى ملف JSON الخاص بإعدادات Gemini.

يضيف المثال التالي رمزًا مميزًا للدخول الشخصي إلى GitHub:

{
//other settings...

"github": {
  "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
  "args": ["stdio"],
  "env": {
    "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
  }
},

// other settings...
}

حيث ACCESS_TOKEN هو رمز الدخول الخاص بالمستخدم.

إنشاء ملف سياق

يسمح السياق للوكيل بإنشاء ردود أفضل على طلب معيّن. يمكن استخلاص السياق من الملفات في بيئة التطوير المتكاملة (IDE) ومن الملفات في مجلدات النظام المحلية ومن ردود الأدوات ومن تفاصيل طلبك. لمزيد من المعلومات، يُرجى الاطّلاع على سياق وضع "الوكيل".

VS Code

1. أنشئ ملفًا باسم GEMINI.md في موقع جغرافي يتطابق مع النطاق الذي تريد تطبيق السياق عليه. يوضّح الجدول التالي المواقع الجغرافية لملفات السياق الخاصة بالنطاقات المختلفة:

   النطاق	الموقع الجغرافي
   كل مشاريعك	~/.gemini/GEMINI.md
   مشروع محدّد	دليل العمل أو أي أدلة رئيسية تصل إلى جذر مشروعك (المحدّد بواسطة مجلد .git) أو دليلك الرئيسي
   جزء أو وحدة أو قسم فرعي معيّن من مشروع	الأدلة الفرعية لدليل العمل

   يتم إنشاء نظام ذاكرة الوكيل من خلال تحميل ملفات السياق من مواقع متعدّدة. يحلّ السياق من الملفات الأكثر تحديدًا، مثل الملفات الخاصة بالمكوّنات أو الوحدات النمطية، محلّ المحتوى من ملفات السياق الأكثر عمومية، مثل ملف السياق العام في ~/.gemini/GEMINI.md، أو يضيف إليه.

2. اكتب أي قواعد أو معلومات دليل الأسلوب أو سياق تريد أن يستخدمه العميل بتنسيق Markdown واحفظ الملف. لمزيد من المعلومات، اطّلِع على ملف السياق النموذجي على GitHub.

IntelliJ

لا تتوفّر هذه الميزة في "أداة كتابة الرموز البرمجية من Gemini" في IntelliJ أو غيرها من بيئات التطوير المتكاملة من JetBrains.

استخدام الطلبات

تتيح لك الأوامر التي تبدأ بشرطة مائلة / تنفيذ أوامر بسرعة مشابهة للأوامر في نافذة طرفية.

يمكنك استخدام أوامر Gemini CLI التالية في وضع "الوكيل":

• /tools: تعرض هذه السمة قائمة بالأدوات المتاحة في جلسة وضع الوكيل. تتضمّن الأوامر الفرعية ما يلي:
  • desc أو descriptions: تعرض أوصافًا تفصيلية لكل أداة.
  • nodesc أو nodescriptions: لإخفاء أوصاف الأدوات وعرض أسماء الأدوات فقط
• ‫/memory: يدير سياق التعليمات الخاص بالوكيل الذي تم تحميله من ملفات GEMINI.md. تتضمّن الأوامر الفرعية ما يلي:
  • ‫show: تعرض هذه السمة المحتوى الكامل والمدمج للذكريات الحالية التي تم تحميلها من جميع ملفات GEMINI.md المتاحة.
  • refresh: يعيد تحميل الذاكرة من جميع ملفات GEMINI.md في المواقع الجغرافية المتاحة. لمزيد من المعلومات حول كيفية مساهمة ملفات GEMINI.md في الذاكرة الهرمية للوكيل، يُرجى الاطّلاع على مستندات إعداد Gemini CLI.
• ‫/mcp: تعرض هذه الصفحة خوادم Model Context Protocol (MCP) التي تم إعدادها وحالة اتصالها وتفاصيلها والأدوات المتاحة. تشمل الأوامر الفرعية ما يلي:
  • desc أو descriptions: يعرض أوصافًا مفصّلة لخوادم MCP وأدواته.
  • nodesc أو nodescriptions: لإخفاء أوصاف خادم MCP وعرض أسماء خادم MCP فقط
  • schema: تعرض مخطط JSON الكامل للمعلمات التي تم ضبطها في خادم MCP.
• /stats: تعرض هذه السمة إحصاءات مفصّلة عن جلسة وضع "الوكيل" ومدتها.

لمزيد من المعلومات حول أوامر Gemini CLI، يُرجى الاطّلاع على أوامر Gemini CLI. يُرجى العلم أنّ بعض أوامر Gemini CLI غير متاحة في وضع "الوكيل".

السماح دائمًا بإجراءات الوكيل

يمكنك السماح تلقائيًا بجميع إجراءات الوكيل.

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

للسماح تلقائيًا بجميع إجراءات الوكيل، اتّبِع الخطوات التالية:

1. افتح ملف JSON لإعدادات مستخدم VS Code:

   1. افتح لوحة الأوامر (ctrl/command + Shift + P).
   2. انقر على الإعدادات المفضّلة: فتح إعدادات المستخدم (JSON).

2. أضِف ما يلي إلى ملف JSON لإعدادات المستخدم في VS Code:

   //other settings...
   
   "geminicodeassist.agentYoloMode": "true",
   //other settings...
   

3. افتح لوحة الأوامر واختَر Developer: Reload Window.

يستخدم "وضع الوكيل" وضع yolo، ولن يطلب الإذن قبل اتخاذ إجراءات عندما ترسل إليه طلبًا.

إنشاء إضافات Gemini CLI

يمكنك استخدام إضافات Gemini CLI لإعداد وتوسيع وظائف وضع وكيل Gemini Code Assist.

يبحث الوكيل عن الإضافات في مكانَين:

• WORKSPACE/.gemini/extensions حيث WORKSPACE هي مساحة عملك الحالية.
• استبدِل ~/.gemini/extensions بـ ~ حيث يمثّل ~ الدليل الرئيسي.

يحمّل الوكيل جميع الإضافات من كلا الموقعَين، ولكن إذا كانت هناك إضافة بالاسم نفسه في كليهما، ستكون الأولوية للإضافة الموجودة في دليل مساحة العمل. كل إضافة هي دليل يحتوي على ملف gemini-extension.json. يحتوي هذا الملف على إعدادات الإضافة.

لمزيد من المعلومات، يُرجى الاطّلاع على إضافات Gemini CLI.

طلبات إضافية

جرِّب الطلبات التالية باستخدام معلوماتك الخاصة:

• "ما هي وظيفة هذا المستودع؟ أريد منك مساعدتي في فهم بنية هذا التطبيق".
• "ما هي وظيفة [الفئة/الدالة]؟"
• "أضِف ميزة إلى قاعدة الرموز البرمجية هذه - "[link-or-path-to-codebase]"."
• "أعِد تصميم الدالتَين [أ] و[ب] لاستخدام الطريقة الشائعة [ج]."
• "حلّ مشكلة GitHub [link-to-github-issue]"
• "أنشئ تطبيقًا لتنفيذ [الهدف] باستخدام واجهة مستخدم تتيح للمستخدم تنفيذ [المهمة] في [البيئة]".
• "نقل إصدارات المكتبة في هذا المستودع من [X] إلى [Y]"
• "أريد تحسين أداء رمز Go البرمجي هذا ليعمل بشكل أسرع".
• "استخدِم [name-of-API] لإنشاء هذه الميزة".
• "نفِّذ خوارزمية لتنفيذ [x] و[Y] و[Z]".

الخطوات التالية

• اطّلِع على نظرة عامة على Gemini Code Assist.
• استكشاف بعض أمثلة على خوادم MCP
• يمكنك العثور على المزيد من خوادم MCP على GitHub.
• إرسال ملاحظات من بيئة التطوير المتكاملة (IDE)