הגדרה של סוכן תכנות ומשאבים למפתחים

סוכני AI לכתיבת קוד מסתמכים על נתוני אימון שמסתיימים בתאריך מסוים. לכן, נציגים מציעים לעיתים קרובות מודלים שהוצאו משימוש (gemini-1.5), ערכות SDK ישנות יותר (google-generativeai) או דפוסי קוד מיושנים.

חיבור הסוכן למקורות רשמיים למפתחים של Gemini עוזר לו לכתוב קוד מדויק באמצעות המודלים העדכניים, google-genai SDK ו-Interactions API.

יש ארבע דרכים לתת לסוכן התכנות גישה לכללים ולמסמכים של Gemini:

סיכום של מקורות המידע של הנציג

התקנת סקילים אג'נטיים של Gemini

הכישורים של הסוכן מספקים לסוכן התכנות כללים פרוצדורליים, שמות של מודלים עדכניים ודפוסי קוד של SDK. במקום להוסיף להנחיה הוראות ארוכות, הסוכן טוען כל מיומנות רק כשצריך. כך הסוכן יוכל להימנע משימוש בערכות SDK שיצאו משימוש ולהשתמש בדפוסי Gemini מודרניים.

הסקילים פועלים לצד שרת ה-MCP של Gemini Docs. אם לא מותקן בנציג שרת MCP, המיומנות חוזרת ל-llms.txt. במדריך בנושא סקילים של Gemini API יש מידע נוסף על אופן הפעולה של הסקילים.

התקנה באמצעות ה-CLI‏ (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 <skill-name> --global

# Or install with Context7
npx ctx7 skills install /google-gemini/gemini-skills <skill-name>

מיומנויות זמינות

gemini-api-dev

מיומנות בפיתוח אפליקציות באמצעות Interactions API וערכות ה-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 Docs

שרת ה-MCP של Gemini Docs (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 Docs, את כל הכישורים הרשמיים של Gemini (gemini-api-dev,‏ gemini-live-api-dev,‏ gemini-omni-flash-api) ואת כלי מפתח ה-API בהורדה אחת.

• התקנה ב-Antigravity (ממשק משתמש): עוברים אל הגדרות > התאמות אישיות > יצירה באמצעות פלאגינים של Google ומורידים את Gemini API.
• התקנה באמצעות ה-CLI: bash agy plugin install https://github.com/google-gemini/gemini-skills

תיעוד שקריא למכונה

דפי אינטרנט רגילים כוללים תגי HTML, סרגלי ניווט וסקריפטים שתופסים מקום בחלון ההקשר. ai.google.dev מספק נקודות קצה שניתנות לקריאה על ידי מכונה, כך שסוכנים וסקריפטים יכולים לאחזר Markdown נקי ישירות:

• llms.txt index (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 הנוכחיות, מוסיפים את ההנחיות האלה לרמה הבסיסית (root) של הפרויקט:

# 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 עם ערכת ה-SDK‏ 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