مساعدو الترميز بالذكاء الاصطناعي فعّالون ولكن لديهم قيود، إذ تتوقف بيانات التدريب عند تاريخ معيّن، ولا تتضمّن الميزات والتغييرات الجديدة في واجهة برمجة التطبيقات. بدون الوصول إلى مستندات 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 للأغراض العامة توفّر هذه المهارة مستندات وأفضل الممارسات لما يلي:
- توجيه الطلبات إلى النماذج الحالية (مثل 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
التحقق من التثبيت
بعد التثبيت، تأكَّد من أنّ مساعد الترميز يمكنه الاتصال بخادم بروتوكول سياق النموذج (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