استخدام "وضع الوكيل" في Gemini Code Assist

VS Code

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

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

لإيقاف الوكيل، انقر على رمز الإيقافstopإيقاف.

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

IntelliJ

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

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

5. اختياري: للموافقة تلقائيًا على التغييرات، انقر على الإعدادات خيارات الوكيل ثم على مربّع الاختيار بجانب الموافقة تلقائيًا على التغييرات.

VS Code

يمكنك استخدام إعدادَي coreTools وexcludeTools للتحكّم في الأدوات التي يمكن لـ Gemini الوصول إليها في "وضع الوكيل".

coreTools

يسمح لك بتحديد قائمة بالأدوات التي تريد أن تكون متاحة للنموذج. يمكنك أيضًا تحديد قيود خاصة بالأوامر للأدوات التي تتيح ذلك. على سبيل المثال، إذا أضفت ما يلي إلى ملف JSON لإعدادات Gemini، سيتم السماح بتنفيذ أمر shell ls -l فقط:"coreTools": ["ShellTool(ls -l)"].

excludeTools

يسمح لك بتحديد قائمة بالأدوات التي لا تريد أن تكون متاحة للنموذج. يمكنك أيضًا تحديد قيود خاصة بالأوامر للأدوات التي تتيح ذلك. على سبيل المثال، إذا أضفت ما يلي إلى ملف JSON لإعدادات Gemini ، سيتم حظر استخدام الأمر rm -rf: "excludeTools": ["ShellTool(rm -rf)"].

يتم استبعاد أي أداة مدرَجة في كل من excludeTools وcoreTools.

لضبط الأدوات المضمّنة المتاحة في "وضع الوكيل"، اتّبِع الخطوات التالية:

1. افتح ملف JSON لإعدادات Gemini الموجود في ~/.gemini/settings.json حيث ~ هو دليل المستخدم الرئيسي.

2. لتقييد استخدام الوكيل للأدوات بقائمة من الأدوات المُوافق عليها، أضِف السطر التالي إلى ملف JSON لإعدادات Gemini:

   "coreTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   استبدِل TOOL_NAME_1 و TOOL_NAME_2 بأسماء الأدوات المضمّنة التي تريد أن يتمكّن الوكيل من الوصول إليها.

   يمكنك إدراج أي عدد تريده من الأدوات المضمّنة. تكون جميع الأدوات المضمّنة متاحة للوكيل تلقائيًا.

3. لتقييد استخدام الوكيل للأدوات بأوامر أدوات معيّنة، أضِف السطر التالي إلى ملف JSON لإعدادات Gemini:

   "coreTools": ["TOOL_NAME(COMMAND)"]
   

   غيِّر القيم في السلسلة على الشكل التالي:

   • TOOL_NAME: اسم الأداة المضمّنة
   • COMMAND: اسم أمر الأداة المضمّنة الذي تريد أن يتمكّن الوكيل من استخدامه

4. لاستبعاد أداة من استخدام الوكيل، أضِف السطر التالي إلى ملف JSON لإعدادات Gemini:

   "excludeTools": ["TOOL_NAME_1,TOOL_NAME_2"]
   

   استبدِل TOOL_NAME_1 و TOOL_NAME_2 بأسماء الأدوات المضمّنة التي تريد استبعادها من استخدام الوكيل.

5. لاستبعاد أمر أداة من استخدام الوكيل، أضِف السطر التالي إلى ملف JSON لإعدادات Gemini:

   "excludeTools": ["TOOL_NAME(COMMAND)"]
   

   غيِّر القيم في السلسلة على الشكل التالي:

   • TOOL_NAME: اسم الأداة المضمّنة
   • COMMAND: اسم أمر الأداة المضمّنة الذي تريد استبعاده من استخدام الوكيل

لمزيد من المعلومات حول إعدادات الضبط coreTools وexcludeTools، اطّلِع على مستندات ضبط Gemini CLI.

IntelliJ

هذه الميزة غير متاحة في Gemini Code Assist for IntelliJ أو بيئات تطوير متكاملة (IDE) أخرى من JetBrains.

VS Code

لإتاحة خوادم MCP لاستخدامها في "وضع الوكيل"، أضِف إعدادات كل خادم في ملف JSON لإعدادات Gemini، وفقًا لمستندات كل خادم.

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

3. اضبط إعدادات كل خادم MCP محلي أو بعيد في ملف JSON لإعدادات Gemini، وفقًا لتعليمات كل خادم.

   يضبط ملف JSON التالي لإعدادات Gemini مثالَين لخادمي Cloudflare MCP بعيدَين، وخادم GitLab MCP بعيد، وخادم GitHub MCP محلي لاستخدامها مع Gemini Code Assist في VS Code.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
       },
       "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. افتح لوحة الأوامر وانقر على المطوّر: إعادة تحميل النافذة.

تكون خوادم MCP التي ضبطتها متاحة للوكيل لاستخدامها في "وضع الوكيل".

IntelliJ

لإتاحة خوادم MCP لاستخدامها في "وضع الوكيل"، أضِف إعدادات كل خادم في ملف mcp.json وضَع ملف mcp.json في دليل الإعدادات لبيئة التطوير المتكاملة (IDE).

1. ثبِّت أي تبعيات مطلوبة من خوادم MCP التي تضيفها.
2. أنشئ ملفًا باسم mcp.json في دليل الإعدادات لبيئة التطوير المتكاملة (IDE) .

3. اضبط إعدادات كل خادم MCP محلي أو بعيد في ملف mcp.json، وفقًا لتعليمات كل خادم.

   يضبط ملف mcp.json التالي مثالَين لخادمي Cloudflare MCP بعيدَين، وخادم GitLab MCP بعيد، وخادم GitHub MCP محلي لاستخدامها مع Gemini Code Assist في IntelliJ.

   {
     "mcpServers": {
       "github": {
         "command": "npx",
         "args": ["-y", "@modelcontextprotocol/server-github"],
         "env": {
           "GITHUB_PERSONAL_ACCESS_TOKEN": "ghp_example_personal_access_token12345"
         }
       },
       "gitlab": {
         "command": "npx",
         "args": ["mcp-remote", "https://your-gitlab-instance.com/api/v4/mcp"]
       },
       "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"]
       }
     }
   }
   

تكون خوادم MCP التي ضبطتها متاحة للوكيل لاستخدامها في "وضع الوكيل".

VS Code

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

يوضّح المثال التالي كيفية تحديد رمز دخول شخصي لخادمي GitHub MCP المحلي والبعيد:

{
  "mcpServers": {
    "github-remote": {
      "httpUrl": "https://api.githubcopilot.com/mcp/",
      "headers": {
        "Authorization": "Bearer ACCESS_TOKEN"
      }
    },
    "github-local": {
      "command": "/Users/username/code/github-mcp-server/cmd/github-mcp-server/github-mcp-server",
      "args": ["stdio"],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "ACCESS_TOKEN"
      }
    }
  }
}

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

IntelliJ

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

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

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

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

VS Code

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

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

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

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

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

IntelliJ

1. أنشئ ملفًا باسم GEMINI.md أو AGENT.md في جذر مشروعك.

2. اكتب أي قواعد أو معلومات دليل الأسلوب أو سياق تريد أن يستخدمه الوكيل بتنسيق Markdown واحفظ الملف.

يتضمّن الوكيل المعلومات الواردة في ملف السياق بالإضافة إلى أي طلبات ترسِلها إليه. يمكنك أيضًا إضافة سياق من خلال تضمين ملف يدويًا باستخدام البنية @FILENAME حيث FILENAME هو اسم الملف الذي يتضمّن المعلومات السياقية التي تريد تضمينها.

VS Code

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

• /tools: يعرض قائمة بالأدوات المتاحة في جلسة "وضع الوكيل".
• /mcp: يعرض خوادم Model Context Protocol (MCP) التي تم ضبطها وحالة اتصالها وتفاصيل الخادم والأدوات المتاحة.

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

IntelliJ

هذه الميزة غير متاحة في Gemini Code Assist for IntelliJ أو بيئات تطوير متكاملة (IDE) أخرى من JetBrains.