إعداد مساعد الترميز باستخدام Gemini MCP و"المهارات"

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

للحفاظ على تحديث مساعد الترميز بما يتوافق مع Gemini API المتطورة واستخدامها المقترَح، ننصحك بإعداد بروتوكول سياق النموذج (MCP) لمستندات Gemini وتحسين بيئتك باستخدام مهارات Gemini API. على الرغم من إمكانية استخدام هذه الأدوات بشكل مستقل، تم تصميمها للعمل معًا لتوفير تغطية كاملة.

ربط بروتوكول سياق النموذج (MCP) لمستندات Gemini

تستضيف Gemini خادمًا عامًا لبروتوكول سياق النموذج (MCP) على https://gemini-api-docs-mcp.dev. يضمن ربط وكيل الترميز بهذا الخادم إمكانية وصول جميع طلبات البحث إلى أحدث واجهات برمجة التطبيقات وتعديلات الرموز البرمجية وأمثلة الإعدادات المثالية.

نفِّذ الأمر التالي في الوحدة الطرفية للوكيل أو في جذر المشروع لتثبيت الخادم:

npx add-mcp "https://gemini-api-docs-mcp.dev"

يضيف هذا الخادم دالة search_documentation يمكن لوكيلك استخدامها لاسترداد تعريفات واجهة برمجة التطبيقات وأنماط التكامل في الوقت الفعلي من ملفات مستندات Gemini الرسمية.

إضافة مهارات تطوير واجهات برمجة التطبيقات

توفّر المهارات قواعد وأفضل الممارسات مضمّنة (مثل فرض إصدارات حزمة SDK والنموذج الحالية الصحيحة) مباشرةً في سياق مساعدك. تعمل المهارة مع خدمة بروتوكول سياق النموذج (MCP) لمستندات Gemini: إذا ثبَّتّ الخدمة والمهارة، ستستخدم المهارة خدمة بروتوكول سياق النموذج (MCP) للحصول على المستندات، ولكن حتى بدون تثبيت بروتوكول سياق النموذج (MCP)، ستسترد المهارة ملف llms.txt من ai.google.dev كحلّ احتياطي.

لتثبيت هذه المهارات، يمكنك استخدام إحدى الأدوات المتوافقة التالية. يتم توفير تعليمات التثبيت لكلتا الأداتَين أسفل كل وحدة مهارة:

  • skills.sh: ننصح باستخدامها. المعيار المفتوح لسلوكيات الوكلاء القابلة للنقل
  • Context7: متوافقة مع المستخدمين الذين يستخدمون حاليًا المنظومة المتكاملة Context7

‫gemini-api-dev

مهارة لإنشاء التطبيقات باستخدام Gemini API (واجهة برمجة تطبيقات التفاعلات) واجهة برمجة تطبيقات التفاعلات هي أبسط طريقة وأفضلها للإنشاء باستخدام نماذج Gemini والوكلاء. تغطّي هذه المهارة ما يلي:

  • إنشاء النصوص والمحادثات المترابطة والبث
  • استدعاء الدوال والناتج المنظَّم وإنشاء الصور
  • التنفيذ في الخلفية ووكلاء Deep Research
  • إدارة حالة المحادثة من جهة الخادم
  • توجيه الطلبات إلى النماذج الحالية وتجنُّب النماذج التي تم إيقافها
  • أنماط حزمة SDK بلغتَي Python وTypeScript

التثبيت باستخدام skills.sh

npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

التثبيت باستخدام Context7

npx ctx7 skills install /google-gemini/gemini-skills gemini-api-dev

gemini-live-api-dev

مهارة لإنشاء تطبيقات ذكاء اصطناعي محادثة في الوقت الفعلي باستخدام Gemini Live API توفّر هذه المهارة مستندات وأفضل الممارسات لما يلي:

  • اتصالات WebSocket للبث بزمن انتقال منخفض
  • بث الصوت والفيديو والنص
  • رصد النشاط الصوتي ودعم المقاطعة

التثبيت باستخدام skills.sh

npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

التثبيت باستخدام Context7

npx ctx7 skills install /google-gemini/gemini-skills gemini-live-api-dev

التحقق من التثبيت

بعد التثبيت، تأكَّد من أنّ مساعد الترميز يمكنه الاتصال بخادم بروتوكول سياق النموذج (MCP) لمستندات Gemini واستخدام المهارات التي ثبَّتها.

1- التحقق من سلوك الوكيل

أكثر الطرق موثوقية للتحقق هي طرح سؤال فني على وكيلك حول Gemini API.

الطلب: "كيف يمكنني استخدام التخزين المؤقت للسياق مع Gemini API؟"

سيؤدي الإعداد الناجح إلى ما يلي:

  • توفير رمز دقيق: يمكنك الرجوع إلى طرق Gemini محدّدة، مثل cacheContent أو cachedContents.create من أحدث نقاط النهاية.
  • استخدام أداة بروتوكول سياق النموذج (MCP): يمكنك إظهار أنّها متصلة بخادم بروتوكول سياق النموذج (MCP) لمستندات Gemini أو تستخدم أداة search_documentation لاسترداد البيانات.
  • استدعاء المهارات المحمَّلة: يمكنك عرض مؤشر يشير إلى أنّه "يستخدم المهارة: gemini-api-dev" (إذا كان يعتمد على برنامج تضمين ثانوي).

2- التحقق من البيانات والأدوات

إذا قدّم الوكيل إجابة عامة، استخدِم أوامر Discovery أو Status المحدّدة لبيئتك للتحقق من تحميل بروتوكول سياق النموذج (MCP) للمستندات أو المهارة في الذاكرة.

البيئة التحقق من بروتوكول سياق النموذج (MCP) التحقق من المهارات
‫Claude Code اكتب /mcp في الوحدة الطرفية لعرض الخوادم النشطة وأدوات search_documentation. اكتب /skills في الوحدة الطرفية لعرض جميع البيانات النشطة.
‫Cursor انتقِل إلى الإعدادات > الميزات > بروتوكول سياق النموذج (MCP). تأكَّد من أنّ حالة الخادم هي "متصل". افتح الإعدادات > القواعد. تأكَّد من ظهور المهارة ضمن "يقرّر الوكيل".
Antigravity راجِع الشريط الجانبي التخصيصات > الاتصالات لمعرفة حالة بروتوكول سياق النموذج (MCP). اكتب /skills list أو راجِع الشريط الجانبي التخصيصات > القواعد.
‫Gemini CLI نفِّذ gemini mcp list أو استخدِم /mcp list. نفِّذ gemini skills list أو استخدِم أمر يبدأ بشرطة مائلة /skills أثناء الجلسة.
‫Copilot اكتب @gemini /mcp لعرض موصِّلات البيانات النشطة. اكتب @gemini /skills (أو /skills) لعرض الإضافات النشطة.

تحديد المشاكل وحلّها

إذا كان وكيلك يقدّم معلومات عامة فقط أو لا يتعرّف على طرق Gemini المحدّدة، راجِع ما يلي:

لم يعثر الوكيل على المهارة

لا تفهرس معظم الوكلاء المهارات إلا عند بدء التشغيل.

الحلّ: أعِد تشغيل بيئة IDE (Cursor/VS Code) بالكامل أو اخرج من الوكيل المستند إلى الوحدة الطرفية (Claude Code) وأعِد فتحه.

تعارض على المستوى العالمي والمحلي

إذا ثبَّتّ باستخدام العلامة --global، قد يتجاهلها وكيلك لصالح القواعد الخاصة بالمشروع.

الحلّ: حاوِل تثبيت المهارة مباشرةً في جذر مشروعك بدون العلامة العامة:

npx skills add google-gemini/gemini-skills --skill gemini-api-dev

الموارد