تتسم أدوات المساعدة في البرمجة المستندة إلى الذكاء الاصطناعي بالقوة، ولكن لها حدود، إذ إنّ بيانات التدريب تتوقف عند تاريخ معيّن، ما يؤدي إلى عدم توفّر ميزات وتغييرات جديدة في واجهة برمجة التطبيقات. بدون الوصول إلى مستندات خاصة بـ Gemini، قد تقترح الجهات الوكيلة أنماطًا عامة بدلاً من أساليب محسّنة.
لإبقاء مساعد الترميز على اطّلاع بآخر التعديلات على Gemini API وطريقة استخدامه المقترَحة، ننصحك بإعداد Gemini Docs MCP وتحسين بيئة التطوير باستخدام مهارات 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 Docs: إذا كان لديك كلتا الخدمتين مثبّتتَين، تستخدم المهارة خدمة MCP للحصول على المستندات، ولكن حتى بدون تثبيت MCP، ستجلب المهارة /gemini-api/docs/llms.txt من ai.google.dev كخيار احتياطي (حيث يمكن أيضًا جلب الصفحات الفردية بتنسيق Markdown الأولي من خلال إضافة .md.txt، مثل https://ai.google.dev/gemini-api/docs/speech-generation.md.txt).
لتثبيت هذه المهارات، يمكنك استخدام إحدى الأدوات المتوافقة التالية. يتم توفير تعليمات التثبيت لكليهما أسفل كل وحدة مهارة:
- skills.sh: يُنصح به. المعيار المفتوح لسلوكيات الوكيل القابلة للنقل
- Context7: متاح للمستخدمين الذين يستفيدون حاليًا من منظومة Context7 المتكاملة.
gemini-api-dev
مهارة إنشاء تطبيقات باستخدام Gemini API (واجهة برمجة التطبيقات للتفاعلات) توفّر واجهة برمجة التطبيقات Interactions API أبسط وأفضل طريقة لتصميم التطبيقات باستخدام نماذج Gemini ووكلاء 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 توفّر هذه المهارة مستندات وأفضل الممارسات بشأن ما يلي:
- اتصالات 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 Docs أو تستخدم أداة
search_documentationلاسترداد البيانات - تفعيل المهارات المحمَّلة: عرض مؤشر "استخدام المهارة: gemini-api-dev" (في حال الاعتماد على برنامج تضمين ثانوي)
2. التحقّق من بيانات المنتج والأدوات
إذا قدّم الوكيل ردًا عامًا أو عاديًا، استخدِم أمرَي Discovery أو Status المحدّدين لبيئتك للتأكّد من تحميل Docs MCP أو المهارة في الذاكرة.
| البيئة | تأكيد MCP | إثبات المهارات |
|---|---|---|
| Claude Code | اكتب /mcp في نافذة الوحدة الطرفية لعرض الخوادم النشطة وأدوات search_documentation. |
اكتب /skills في نافذة الوحدة الطرفية لإدراج جميع ملفات البيان النشطة. |
| المؤشر | انتقِل إلى الإعدادات > الميزات > MCP. تأكَّد من أنّ الخادم "متصل". | افتح الإعدادات > القواعد. تأكَّد من ظهور المهارة ضمن "يقرّر الوكيل". |
| Antigravity | تحقَّق من الشريط الجانبي التخصيصات > عمليات الربط لمعرفة حالة "برنامج شركاء المحتوى". | اكتب /skills list أو ضَع علامة في الشريط الجانبي التخصيصات > القواعد. |
| Gemini CLI | تشغيل gemini mcp list أو استخدام /mcp list |
نفِّذ الأمر gemini skills list أو استخدِم الأمر /skills الذي يبدأ بشرطة مائلة أثناء الجلسة. |
| Copilot | اكتب @gemini /mcp لإدراج أدوات ربط البيانات النشطة. |
اكتب @gemini /skills (أو /skills) لعرض الإضافات النشطة. |
تحديد المشاكل وحلّها
إذا كان الوكيل يقدّم معلومات عامة فقط أو لا يتعرّف على طرق خاصة بـ Gemini، يُرجى التحقّق مما يلي:
لم يكتشف الوكيل المهارة
يفهرس معظم الوكلاء المهارات عند بدء التشغيل فقط.
الحلّ: أعِد تشغيل بيئة التطوير المتكاملة (Cursor أو VS Code) بالكامل أو اخرج من الوكيل المستند إلى الجهاز (Claude Code) وأعِد فتحه.
النزاعات العالمية والمحلية
إذا تم التثبيت باستخدام العلامة --global، قد يتجاهل الوكيل هذه العلامة لصالح القواعد الخاصة بالمشروع.
الحل: جرِّب تثبيت التطبيق مباشرةً في جذر مشروعك بدون العلامة العامة:
npx skills add google-gemini/gemini-skills --skill gemini-api-dev