مساعدو الترميز المستندون إلى الذكاء الاصطناعي فعّالون ولكن لديهم قيود، إذ تتوقف بيانات التدريب عند تاريخ معيّن، ولا تتضمّن الميزات والتغييرات الجديدة في واجهة برمجة التطبيقات. بدون الوصول إلى مستندات Gemini، قد تقترح الوكلاء أنماطًا عامة بدلاً من الأساليب المحسّنة.
للحفاظ على تحديث مساعد الترميز بما يتوافق مع Gemini API المتطورة واستخدامها المقترَح، ننصحك بإعداد خادم Gemini Docs MCP وتعزيز بيئتك باستخدام مهارات Gemini API. على الرغم من إمكانية استخدام هذه الأدوات بشكلٍ مستقل، تم تصميمها للعمل معًا لتوفير تغطية كاملة.
ربط خادم Gemini Docs MCP
تستضيف Gemini خادمًا عامًا لبروتوكول سياق النموذج (MCP) على gemini-api-docs-mcp.dev. يضمن ربط وكيل الترميز بهذا الخادم وصول جميع طلبات البحث إلى أحدث واجهات برمجة التطبيقات وتعديلات الرموز البرمجية وأمثلة الإعدادات المثالية.
نفِّذ الأمر التالي في الوحدة الطرفية للوكيل أو في جذر المشروع لتثبيت الخادم:
npx add-mcp gemini-api-docs-mcp.dev
يضيف هذا الخادم دالة search_documentation يمكن لوكيلك استخدامها لاسترداد تعريفات واجهة برمجة التطبيقات وأنماط التكامل في الوقت الفعلي من ملفات مستندات Gemini الرسمية.
إضافة مهارات تطوير واجهة برمجة التطبيقات
توفّر المهارات قواعد وأفضل الممارسات مضمّنة (مثل فرض إصدارات حزمة SDK الصحيحة وإصدارات النموذج الحالية) مباشرةً في سياق مساعدك. تعمل المهارة مع خدمة خادم Gemini Docs MCP: إذا ثبّتّ كلتيهما، تستخدم المهارة خدمة MCP للمستندات، ولكن حتى بدون تثبيت MCP، ستسترد llms.txt من ai.google.dev كحلّ احتياطي.
لتثبيت هذه المهارات، يمكنك استخدام إحدى الأدوات المتوافقة التالية. يتم توفير تعليمات التثبيت لكلتا الأداتين أسفل كل وحدة مهارة:
- skills.sh: يُنصح بها. المعيار المفتوح لسلوكيات الوكلاء المحمولة
- Context7: متوافقة مع المستخدمين الذين يستخدمون حاليًا المنظومة المتكاملة Context7
gemini-api-dev
المهارة الأساسية لتطوير Gemini للأغراض العامة توفّر هذه المهارة مستندات وأفضل الممارسات لما يلي:
- توجيه الطلبات إلى النماذج الحالية (مثل Gemini 3.1 Pro/Flash) وتجنُّب النماذج المتوقّفة نهائيًا
- إنشاء الطلبات المتعددة الوسائط واستدعاء الدوال والنتائج المنظَّمة وأنماط التكامل الشائعة
التثبيت باستخدام 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
gemini-interactions-api
مهارة لإنشاء تطبيقات باستخدام الـ Interactions API. Interactions API هي واجهة موحّدة للتفاعل مع نماذج Gemini والوكلاء، وهي مصمّمة للتطبيقات المستندة إلى وكيل. تغطّي هذه المهارة ما يلي:
- إنشاء النصوص والمحادثات المتعدّدة الجولات والبث
- استدعاء الدوال والنتائج المنظَّمة وإنشاء الصور
- التنفيذ في الخلفية والوكلاء في Deep Research
- إدارة حالة المحادثة من جهة الخادم
- أنماط حزمة SDK في Python وTypeScript
التثبيت باستخدام skills.sh
npx skills add google-gemini/gemini-skills --skill gemini-interactions-api --global
التثبيت باستخدام Context7
npx ctx7 skills install /google-gemini/gemini-skills gemini-interactions-api
التحقق من التثبيت
بعد التثبيت، تأكَّد من أنّ مساعد الترميز يمكنه الاتصال بخادم Gemini Docs MCP واستخدام المهارات التي ثبّتها.
1- التحقق من سلوك الوكيل
الطريقة الأكثر موثوقية للتحقق هي طرح سؤال فني على وكيلك حول Gemini API.
الطلب: "كيف يمكنني استخدام التخزين المؤقت للسياق مع Gemini API؟"
سيؤدي الإعداد الناجح إلى ما يلي:
- توفير رمز دقيق: يمكنك الرجوع إلى طرق Gemini محدّدة، مثل
cacheContentأوcachedContents.createمن أحدث نقاط النهاية. - استخدام أداة MCP: يمكنك إظهار أنّها متصلة بخادم Gemini Docs MCP أو تستخدم الأداة
search_documentationلاسترداد البيانات. - استدعاء المهارات المحمَّلة: يمكنك عرض مؤشر يشير إلى أنّه "يستخدم المهارة: gemini-api-dev" (إذا كان يعتمد على برنامج تضمين ثانوي).
2- التحقق من البيانات والأدوات
إذا قدّم الوكيل إجابة عامة، استخدِم أوامر Discovery أو Status المحدّدة لبيئتك للتحقق من تحميل Docs 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