دستیارهای کدنویسی هوش مصنوعی قدرتمند هستند اما محدودیتهایی دارند - دادههای آموزشی در یک تاریخ خاص قطع میشوند، ویژگیها و تغییرات جدید API را از دست میدهند. بدون دسترسی به مستندات خاص Gemini، ممکن است عوامل به جای رویکردهای بهینه، الگوهای عمومی را پیشنهاد دهند.
برای اینکه دستیار کدنویسی شما با API در حال تکامل Gemini و نحوهی استفادهی توصیهشده از آن بهروز باشد، توصیه میکنیم Gemini Docs MCP را راهاندازی کنید و محیط خود را با Gemini API Skills ارتقا دهید. اگرچه این ابزارها بهطور مستقل قابل استفاده هستند، اما طوری طراحی شدهاند که با هم کار کنند تا پوشش کاملی ارائه دهند.
اتصال به Gemini Docs MCP
جمینی میزبان یک سرور عمومی Model Context Protocol (MCP) در gemini-api-docs-mcp.dev است. اتصال عامل کدنویسی شما به این سرور تضمین میکند که همه کوئریها به جدیدترین APIها، بهروزرسانیهای کد و نمونههای پیکربندی بهینه دسترسی دارند.
برای نصب سرور، دستور زیر را در ترمینال عامل یا ریشه پروژه خود اجرا کنید:
npx add-mcp gemini-api-docs-mcp.dev
این سرور یک تابع search_documentation اضافه میکند که عامل شما میتواند از آن برای بازیابی تعاریف API و الگوهای یکپارچهسازی بلادرنگ از فایلهای مستندات رسمی Gemini استفاده کند.
مهارتهای توسعه API را اضافه کنید
این مهارتها ، قوانین و بهترین شیوههای تثبیتشده (مانند اجرای SDK صحیح و نسخههای مدل فعلی) را مستقیماً در زمینه دستیار شما ارائه میدهند. این مهارت با سرویس MCP مربوط به Gemini Docs کار میکند: اگر هر دو را نصب کرده باشید، این مهارت از سرویس MCP برای مستندسازی استفاده میکند، اما حتی بدون نصب MCP، llms.txt از ai.google.dev به عنوان پشتیبان دریافت میکند.
برای نصب این مهارتها، میتوانید از یکی از ابزارهای پشتیبانیشدهی زیر استفاده کنید. دستورالعملهای نصب برای هر دو، در زیر هر ماژول مهارت ارائه شده است:
- skills.sh : توصیه میشود. استاندارد باز برای رفتارهای عامل قابل حمل.
- Context7 : برای کاربرانی که از قبل از اکوسیستم Context7 استفاده میکنند، پشتیبانی میشود.
بخشهای موردنیاز علامتگذاری شدهاند
مهارت بنیادی برای توسعه عمومی 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. این مهارت، مستندات و بهترین شیوهها را برای موارد زیر ارائه میدهد:
- اتصالات 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
تعاملات دوقلوها-api
مهارت ساخت برنامهها با Interactions API . Interactions API یک رابط یکپارچه برای تعامل با مدلها و عاملهای Gemini است که برای برنامههای عاملمحور طراحی شده است. این مهارت موارد زیر را پوشش میدهد:
- تولید متن، چت چند نوبتی و پخش جریانی
- فراخوانی تابع، خروجی ساختاریافته و تولید تصویر
- اجرای پسزمینه و عوامل تحقیق عمیق
- مدیریت وضعیت مکالمه سمت سرور
- الگوهای SDK پایتون و تایپاسکریپت
با 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 متصل شود و از مهارتهای نصبشده شما استفاده کند.
۱. رفتار اپراتور را تأیید کنید
مطمئنترین راه برای تأیید این است که از نماینده خود یک سؤال فنی در مورد Gemini API بپرسید.
سوال: "چگونه میتوانم از ذخیرهسازی زمینه با رابط برنامهنویسی کاربردی Gemini استفاده کنم؟"
یک راهاندازی موفق:
- کد دقیق ارائه دهید : به متدهای خاص Gemini مانند
cacheContentیاcachedContents.createاز آخرین نقاط پایانی ارجاع دهید. - از ابزار MCP استفاده کنید : نشان دهید که به سرور MCP Gemini Docs متصل است یا از ابزار
search_documentationبرای واکشی دادهها استفاده میکند. - مهارتهای بارگذاریشده را فراخوانی کنید : نشانگری را نشان دهید که نشان دهد «در حال استفاده از مهارت: gemini-api-dev» است (اگر به یک پوشش ثانویه متکی است).
۲. ابزارها و نمونهها را تأیید کنید
اگر عامل یک پاسخ کلی یا عمومی میدهد، از دستورات Discovery یا Status خاص برای محیط خود استفاده کنید تا تأیید کنید که MCP یا مهارت Docs در حافظه بارگذاری شده است.
| محیط زیست | تأیید MCP | تأیید مهارتها |
|---|---|---|
| کلود کد | برای مشاهده سرورهای فعال و ابزارهای search_documentation دستور /mcp را در ترمینال تایپ کنید. | برای فهرست کردن تمام مانیفستهای فعال، عبارت /skills را در ترمینال تایپ کنید. |
| مکان نما | به تنظیمات > ویژگیها > MCP بروید. مطمئن شوید که سرور «متصل» است. | تنظیمات > قوانین را باز کنید. بررسی کنید که مهارت در زیر «تصمیمهای عامل» نمایش داده شود. |
| ضد جاذبه | برای اطلاع از وضعیت MCP، نوار کناری «سفارشیسازیها > اتصالات» را بررسی کنید. | عبارت /skills list را تایپ کنید یا نوار کناری Customizations > Rules را بررسی کنید. |
| رابط خط فرمان جمینی | دستور gemini mcp list اجرا کنید یا از /mcp list استفاده کنید. | gemini skills list اجرا کنید یا از دستور /skills slash در جلسه استفاده کنید. |
| کمک خلبان | برای فهرست کردن کانکتورهای داده فعال @gemini /mcp را تایپ کنید. | برای مشاهده افزونههای فعال @gemini /skills (یا /skills ) را تایپ کنید. |
عیبیابی
اگر نماینده شما فقط اطلاعات کلی ارائه میدهد یا روشهای خاص Gemini را تشخیص نمیدهد، موارد زیر را بررسی کنید:
نماینده مهارت را کشف نکرد
بیشتر کارشناسان فقط در بدو ورود، مهارتها را فهرست میکنند.
راه حل: IDE خود (Cursor/VS Code) را کاملاً مجدداً راه اندازی کنید یا از آن خارج شوید و عامل مبتنی بر ترمینال خود (Claude Code) را دوباره باز کنید.
درگیری جهانی در مقابل درگیری محلی
اگر با پرچم --global نصب کردهاید، ممکن است عامل شما آن را به نفع قوانین خاص پروژه نادیده بگیرد.
راه حل: سعی کنید مهارت را مستقیماً در ریشه پروژه خود و بدون پرچم سراسری نصب کنید:
npx skills add google-gemini/gemini-skills --skill gemini-api-dev