עוזרים מבוססי-AI לכתיבת קוד הם כלים חזקים, אבל יש להם מגבלות – נתוני האימון שלהם מוגבלים לתאריך מסוים, והם לא כוללים תכונות חדשות של API ושינויים. ללא גישה לתיעוד ספציפי ל-Gemini, יכול להיות שהסוכנים יציעו דפוסים גנריים במקום גישות אופטימליות.
כדי שהעוזר האישי לתכנות יהיה מעודכן ב-Gemini API המתפתח ובשימוש המומלץ בו, מומלץ להגדיר את Gemini Docs MCP ולשפר את הסביבה באמצעות Gemini API Skills. אפשר להשתמש בכלים האלה בנפרד, אבל הם נועדו לעבוד ביחד כדי לספק כיסוי מלא.
חיבור Gemini Docs MCP
Gemini מארח שרת ציבורי של Model Context Protocol (MCP) בכתובת https://gemini-api-docs-mcp.dev. חיבור סוכן התכנות לשרת הזה מבטיח שלכל השאילתות תהיה גישה לממשקי ה-API העדכניים, לעדכוני הקוד ולדוגמאות אופטימליות להגדרות.
כדי להתקין את השרת, מריצים את הפקודה הבאה בטרמינל של הסוכן או בספריית הבסיס של הפרויקט:
npx add-mcp "https://gemini-api-docs-mcp.dev"
השרת הזה מוסיף פונקציה search_documentation שהסוכן יכול להשתמש בה כדי לאחזר הגדרות API ודפוסי שילוב בזמן אמת מקובצי התיעוד הרשמיים של Gemini.
הוספת כישורי פיתוח API
הכישורים מספקים כללים ושיטות מומלצות שמוטמעים ישירות בהקשר של העוזר הדיגיטלי (למשל, אכיפה של גרסאות ה-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). Interactions API הוא הדרך הכי פשוטה והכי טובה שלנו לבנות עם מודלים וסוכנים של 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
סקיל לפיתוח אפליקציות AI בממשק שיחה בזמן אמת באמצעות 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
אימות התקנה
אחרי ההתקנה, צריך לוודא שעוזר התכנות יכול להתחבר לשרת ה-MCP של Gemini Docs ולהשתמש במיומנויות שהותקנו.
1. אימות התנהגות הנציג
הדרך הכי אמינה לאימות היא לשאול את הנציג שאלה טכנית לגבי Gemini API.
הנחיה: "איך משתמשים בשמירת מטמון של הקשר עם Gemini API?"
הגדרה מוצלחת תאפשר לכם:
- מספקים קוד מדויק: מפנים לשיטות ספציפיות של Gemini כמו
cacheContentאוcachedContents.createמנקודות הקצה העדכניות. - שימוש בכלי MCP: צריך להראות שהכלי מחובר לשרת ה-MCP של Gemini Docs או שהוא משתמש בכלי
search_documentationכדי לאחזר נתונים. - הפעלת סקילס שנטענו: הצגת אינדיקטור של 'שימוש בסקיל: gemini-api-dev' (אם מסתמכים על wrapper משני).
2. אימות של מניפסטים וכלים
אם הסוכן נותן תשובה כללית או גנרית, משתמשים בפקודות הספציפיות Discovery או Status עבור הסביבה כדי לוודא שה-Docs MCP או המיומנות נטענו לזיכרון.
| סביבה | אימות MCP | אימות מיומנויות |
|---|---|---|
| Claude Code | מקלידים /mcp בטרמינל כדי לראות את השרתים הפעילים ואת הכלים search_documentation. |
מקלידים /skills במסוף כדי לראות רשימה של כל קובצי המניפסט הפעילים. |
| סמן | עוברים אל הגדרות > תכונות > MCP. מוודאים שהשרת מחובר. | פותחים את ההגדרות > כללים. מוודאים שהמיומנות מופיעה בקטע 'הסוכן מחליט'. |
| Antigravity | בודקים את סטטוס ה-MCP בסרגל הצד התאמות אישיות > חיבורים. | מקלידים /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, יכול להיות שהסוכן מתעלם ממנו לטובת כללים ספציפיים לפרויקט.
פתרון: מנסים להתקין את ה-Skill ישירות בתיקיית הבסיס של הפרויקט בלי הדגל global:
npx skills add google-gemini/gemini-skills --skill gemini-api-dev