إعداد وكيل الترميز ومراجع المطوّرين

تعتمد أدوات الترميز المستندة إلى الذكاء الاصطناعي على بيانات تدريب تتوقف عند تاريخ محدّد. لهذا السبب، تقترح الأدوات غالبًا نماذج متوقّفة نهائيًا (gemini-1.5) أو حِزم SDK قديمة (google-generativeai) أو أنماط رموز برمجية قديمة.

يساعد ربط وكيلك بمراجع المطوّرين الرسمية في Gemini على كتابة رموز برمجية دقيقة باستخدام النماذج الحالية وgoogle-genaiحزمة SDK وواجهة برمجة التطبيقات Interactions.

يمكنك منح وكيل الترميز إذن الوصول إلى مستندات وقواعد Gemini بأربع طرق:

ملخّص مَراجع الوكيل

تثبيت مهارات "وكيل Gemini"

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

تعمل المهارات جنبًا إلى جنب مع خادم بروتوكول سياق النموذج (MCP) في Gemini Docs. إذا لم يكن وكيلك مثبّتًا على خادم MCP، ستعود المهارة إلى llms.txt. لمزيد من المعلومات حول طريقة عمل المهارات، يُرجى الاطّلاع على دليل مهارات Gemini API.

التثبيت باستخدام واجهة سطر الأوامر (skills.sh أو Context7)

ثبِّت المهارات باستخدام skills.sh (مقترَح) أو Context7:

# List all available skills in the repository
npx skills add google-gemini/gemini-skills --list

# Install a specific skill globally with skills.sh
npx skills add google-gemini/gemini-skills --skill  --global

# Or install with Context7
npx ctx7 skills install /google-gemini/gemini-skills 

المهارات المتاحة

gemini-api-dev

مهارة إنشاء تطبيقات باستخدام واجهة برمجة التطبيقات Interactions وحِزم تطوير البرامج (SDK) الرسمية لواجهة Gemini API (google-genai لـ Python و@google/genai لـ TypeScript) تشمل هذه المهارة ما يلي:

• إنشاء النصوص، والمحادثات المترابطة، والبث، والنتائج المنظَّمة، واستدعاء الدوال
• إنشاء الصور وتحويل النص إلى كلام (TTS) والمدخلات المتعدّدة الوسائط
• إدارة حالة المحادثة من جهة الخادم والتنفيذ في الخلفية و"البحث المعمّق" والوكلاء المُدارون
• أسماء النماذج الحالية ونقل الرمز القديم generateContent أو google-generativeai

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

gemini-live-api-dev

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

• إدارة جلسات WebSocket ورموز عملاء مؤقتة واستئناف الجلسات
• بث الصوت والفيديو والنص مع ميزة رصد النشاط الصوتي (VAD) وإمكانية مقاطعة المحادثة
• الاستدلال في الخلفية (التفكير الموسّع)، وتنفيذ أدوات غير متزامنة لا تحظر التنفيذ، وتحويل الصوت إلى نص، والترجمة الفورية للكلام

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

gemini-omni-flash-api

مهارة لإنشاء الفيديوهات وتعديلها باستخدام Gemini Omni Flash من خلال واجهة برمجة التطبيقات Interactions API تتضمّن نصوصًا برمجية مساعدة (upload_file.py وgenerate_video.py وprep_video.py وinspect_video.py) وتشمل ما يلي:

• إنشاء فيديوهات من نصوص وصياغة الطلبات
• انتقالات الإطار الأول والأخير وإنشاء فيديوهات استنادًا إلى صور مرجعية
• إضافات الفيديو وطُرق المعالجة المسبقة للوسائط

npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

ربط المهارات في "الوكلاء المُدارون"

عند تشغيل وكلاء مُدارين عن بُعد باستخدام Interactions API، يمكنك ربط مستودع google-gemini/gemini-skills بمساحة عمل الوكيل. يمكنك الاطّلاع على دليل مهارات Gemini API للحصول على التفاصيل:

from google import genai

client = genai.Client()

interaction = client.interactions.create(
    agent="antigravity-preview-09-2026",
    input="Build a script that generates a 5-second video of a neon cityscape.",
    environment={
        "type": "remote",
        "sources": [
            {
                "type": "repository",
                "source": "https://github.com/google-gemini/gemini-skills",
                "target": ".agents",
            }
        ],
    },
)

ربط خادم MCP الخاص بـ "مستندات Gemini"

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

• ‫gemini_search_docs: تبحث هذه الأداة في مستندات Gemini API حسب الموضوع أو طلب البحث.
• gemini_get_doc: لقراءة محتوى Markdown الكامل لصفحة مستندات معيّنة

إعداد سريع

نفِّذ هذا الأمر في الوحدة الطرفية أو جذر المشروع لضبط وكلاء الترميز الذين تم رصدهم تلقائيًا:

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

الإعداد حسب البيئة

$ claude mcp add --transport http geminiDocs https://gemini-api-docs-mcp.dev

{
  "mcpServers": {
    "geminiDocs": {
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev

[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"

{
  "servers": {
    "geminiDocs": {
      "type": "http",
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}

إضافة Gemini API

إذا كنت تستخدم Antigravity، فإنّ المكوّن الإضافي لواجهة Gemini API هو أسرع طريقة لإعداد مساحة العمل. تتضمّن هذه الحزمة خادم MCP الخاص بـ "مستندات Gemini" وجميع مهارات Gemini الرسمية (gemini-api-dev وgemini-live-api-dev وgemini-omni-flash-api) وأدوات مفتاح واجهة برمجة التطبيقات في عملية تنزيل واحدة.

• التثبيت في Antigravity (واجهة المستخدم): انتقِل إلى الإعدادات > التخصيصات > إنشاء باستخدام المكوّنات الإضافية من Google ونزِّل Gemini API.
• التثبيت باستخدام واجهة سطر الأوامر: bash agy plugin install https://github.com/google-gemini/gemini-skills

المستندات التي يمكن معالجتها آليًا

تتضمّن صفحات الويب العادية علامات HTML وأشرطة تنقّل ونصوصًا برمجية تشغل مساحة قدرة الاستيعاب. توفّر ai.google.dev نقاط نهاية قابلة للقراءة آليًا، ما يتيح للبرامج النصية والوكلاء استرداد ملفات Markdown منظَّمة مباشرةً:

• llms.txt الفهرس (https://ai.google.dev/gemini-api/docs/llms.txt): يُدرِج جميع صفحات مستندات Gemini API مع روابط تؤدي إلى كل صفحة.
• عناوين URL المباشرة بتنسيق Markdown (.md.txt): أضِف .md.txt إلى أي عنوان URL خاص بالمستندات على ai.google.dev (على سبيل المثال، https://ai.google.dev/gemini-api/docs/coding-agents.md.txt) للحصول على مصدر Markdown نظيف للمطالبات المحفوظة أو قواعد AGENTS.md أو البرامج النصية المبرمَجة.

قواعد المشاريع المقترَحة (AGENTS.md)

يحدّد ملف قواعد المشروع (AGENTS.md أو .cursorrules أو CLAUDE.md) القواعد الأساسية التي يتم تحميلها في بداية كل جلسة وكيل. أضِف هذه الإرشادات إلى جذر مشروعك لكي تستخدم وكلاء الترميز تلقائيًا النماذج وحِزم SDK الحالية:

# Gemini API Guidelines

- Before writing Gemini API code, consult the `geminiDocs` MCP server (`gemini_search_docs` / `gemini_get_doc`) or `https://ai.google.dev/gemini-api/docs/llms.txt`.
- Always use the current Gemini API SDK (`google-genai` for Python, `@google/genai` for TypeScript/JavaScript). Never use legacy SDKs (`google-generativeai` or `@google/generative-ai`).
- Use the Interactions API (`client.interactions.create`) for new applications unless a specific feature requires `generateContent`.
- Use current recommended models (see https://ai.google.dev/gemini-api/docs/models) and avoid deprecated models.

التحقّق من صحة الإعداد وتحديد المشاكل وحلّها

التحقق من صحة الإعداد

لاختبار عملية الإعداد، اطرح على وكيل الترميز السؤال التالي:

Look up the request schema for the Gemini Interactions API in the documentation.

سيستخدم الوكيل الذي تم إعداده gemini_search_docs على خادم MCP geminiDocs ويكتب الرمز باستخدام client.interactions.create مع حزمة تطوير البرامج google-genai أو @google/genai.

أوامر الحالة

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

• تعذُّر رصد المهارة أو خادم MCP: أعِد تشغيل المحرّر (Cursor أو VS Code) أو جلسة الوحدة الطرفية (Claude Code أو Codex). لا تحمّل معظم البرامج الخوادم ومهارات MCP إلا عند بدء تشغيلها.
• تعارض المهارات على مستوى العالم: إذا كان وكيلك يتجاهل مهارة مثبَّتة على مستوى العالم، ثبِّت المهارة في جذر مشروعك بدون --global: bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
• القواعد التي تم تجاهلها: تأكَّد من أنّ ملف AGENTS.md أو .cursorrules أو CLAUDE.md موجود في الدليل الجذر لمشروعك.

الخطوات التالية

• دليل مهارات Gemini API
• مهارات Gemini API على GitHub
• Interactions API
• النماذج المتاحة
• المكتبات وحِزم تطوير البرامج (SDK)