Konfigurimi i agjentit të kodimit dhe burimet për zhvilluesit

Agjentët e kodimit me IA-në mbështeten në të dhënat e trajnimit që ndërpriten në një datë të caktuar. Për këtë arsye, agjentët shpesh sugjerojnë modele të zhvlerësuara (gemini-1.5), SDK-të më të vjetra (google-generativeai) ose modele të vjetruara të kodeve.

Lidhja e agentit tënd me burimet zyrtare të zhvilluesve të Gemini e ndihmon atë të shkruajë kode të sakta duke përdorur modelet aktuale, SDK-në e google-genai dhe API-në e Interactions.

Mund t'i japësh qasje agjentit të kodimit te dokumentacioni dhe rregullat e Gemini në katër mënyra:

Përmbledhja e burimeve të agjentit

Instalo aftësitë e Gemini Agent

Aftësitë e agjentit i japin agjentit të kodimit rregullat procedurale, emrat aktualë të modeleve dhe modelet e kodeve të SDK-së. Në vend që të shtosh udhëzime të gjata te kërkesa jote, agjenti yt i ngarkon aftësitë vetëm kur është e nevojshme. Kjo e ndihmon agjentin tënd të shmangë SDK-të e zhvlerësuara dhe të përdorë modelet moderne të Gemini.

Aftësitë funksionojnë në krah të serverit MCP të Gemini Docs. Nëse agjenti yt nuk ka të instaluar serverin MCP, aftësia kthehet te llms.txt. Për të mësuar më shumë rreth mënyrës se si funksionojnë aftësitë, lexo udhëzuesin e aftësive të Gemini API.

Instalo me CLI (skills.sh ose Context7)

Instalo aftësitë duke përdorur skills.sh (rekomandohet) ose 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>

Aftësitë e disponueshme

gemini-api-dev

Aftësia për të ndërtuar aplikacione me API-n e ndërveprimeve dhe SDK-të zyrtare të Gemini API (google-genai për Python dhe @google/genai për TypeScript). Kjo aftësi mbulon:

• Gjenerimi i tekstit, biseda me shumë kthesa, transmetimi, daljet e strukturuara dhe thirrja e funksioneve
• Gjenerimi i imazheve, teksti në ligjërim (TTS) dhe hyrjet multimodale
• Menaxhimi i gjendjes së bisedës nga ana e serverit, ekzekutimi në sfond, Deep Research dhe agjentët e menaxhuar
• Emrat e modeleve aktuale dhe migrimi i kodit të sistemit të vjetër generateContent ose google-generativeai

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

gemini-live-api-dev

Aftësia për të krijuar aplikacione të transmetimit të audios dhe videos në kohë reale me Gemini Live API. Kjo aftësi mbulon:

• Menaxhimi i seancës së WebSocket, kodet e përkohshme të klientit dhe vazhdimi i seancës
• Transmetimi i audios, videos dhe tekstit me zbulimin e aktivitetit zanor (VAD) dhe mbështetjen e ndërprerjes
• Arsyetimi në sfond (mendimi i zgjeruar), thirrjet asinkrone jo bllokuese të veglave, transkriptimi dhe përkthimi i ligjërimit në çast

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

gemini-omni-flash-api

Aftësia për të gjeneruar dhe modifikuar video me Gemini Omni Flash duke përdorur API-n e "Ndërveprimeve". Përfshin skriptet ndihmëse (upload_file.py, generate_video.py, prep_video.py, inspect_video.py) dhe mbulon:

• Gjenerimi i videos nga teksti dhe krijimi i kërkesës
• Tranzicionet e kuadrit të parë dhe të fundit dhe gjenerimi i videove i udhëhequr nga referencat
• Shtesat e videos dhe flukset e punës për parapërpunimin e mediave

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

Montoni aftësitë në agjentët e menaxhuar

Kur ekzekuton agjentë të menaxhuar në distancë me API-n e ndërveprimeve, mund të montosh depon e google-gemini/gemini-skills në hapësirën e punës të agjentit. Shiko udhëzuesin e aftësive të Gemini API për detaje:

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",
            }
        ],
    },
)

Lidh serverin MCP të "Dokumenteve" të Gemini

Serveri publik MCP i Gemini Docs (https://gemini-api-docs-mcp.dev) i jep agjentit tënd qasje të drejtpërdrejtë në të gjithë sajtin e dokumentacionit. Agjenti yt mund të kërkojë dhe të lexojë faqet e dokumentacionit për të kontrolluar skemat e kërkesave, kufijtë e modeleve dhe veçoritë e reja:

• gemini_search_docs: Kërkon në dokumentacionin e Gemini API sipas temës ose kërkesës.
• gemini_get_doc: Lexon përmbajtjen e plotë të Markdown të një faqeje specifike dokumentacioni.

Konfigurimi i shpejtë

Ekzekuto këtë komandë në terminalin ose rrënjën e projektit për të konfiguruar automatikisht agjentët e kodimit që janë zbuluar:

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

Konfigurimi sipas mjedisit

$ 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"
    }
  }
}

Shtesa e Gemini API

Nëse përdor Antigravity, shtesa e Gemini API është mënyra më e shpejtë për të konfiguruar hapësirën tënde të punës. Ai përfshin serverin MCP të Gemini Docs, të gjitha aftësitë zyrtare të Gemini (gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api) dhe veglat e çelësave të API-së në një shkarkim të vetëm.

• Instalo në Antigravity (UI): Shko te Cilësimet > Personalizimet > Krijo me shtesat e Google dhe shkarko Gemini API.
• Instalo me CLI: bash agy plugin install https://github.com/google-gemini/gemini-skills

Dokumentacioni i lexueshëm nga makineria

Faqet standarde të uebit përfshijnë etiketa HTML, shiritat e navigimit dhe skriptet që zënë hapësirën e dritares së kontekstit. ai.google.dev ofron pika përfundimtare të lexueshme nga makina në mënyrë që agjentët dhe skriptet të mund të marrin drejtpërdrejt "Shënimin e formatit" të pastër:

• Indeksi i llms.txt (https://ai.google.dev/gemini-api/docs/llms.txt): Liston të gjitha faqet e dokumentacionit të Gemini API me lidhje për secilën faqe.
• URL-të e drejtpërdrejta të Markdown (.md.txt): Shto .md.txt në çdo URL të dokumentacionit në ai.google.dev (për shembull, https://ai.google.dev/gemini-api/docs/coding-agents.md.txt) për të marrë burimin e pastër të Markdown për kërkesat e ruajtura, rregullat e AGENTS.md ose skriptet e automatizuara.

Rregullat e rekomanduara të projektit (AGENTS.md)

Një skedar rregullash projekti (AGENTS.md, .cursorrules ose CLAUDE.md) përcakton rregullat bazë që ngarkohen në fillim të çdo seance të agjentit. Shto këto udhëzime në rrënjën e projektit që agjentët e kodimit të parazgjedhin modelet dhe SDK-të aktuale:

# 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.

Verifiko dhe zgjidh problemet

Verifiko konfigurimin tënd

Për të testuar konfigurimin, pyet agjentin tënd të kodimit:

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

Një agjent i konfiguruar do të përdorë gemini_search_docs në serverin e MCP-së geminiDocs dhe do të shkruajë kod duke përdorur client.interactions.create me google-genai ose SDK-në @google/genai.

Komandat e statusit

Zgjidhja e problemeve

• Serveri i aftësive ose MCP nuk u zbulua: Rinis seancën e modifikuesit (Cursor ose VS Code) ose terminalit (Claude Code ose Codex). Shumica e agjentëve ngarkojnë serverët MCP dhe aftësitë vetëm kur fillojnë.
• Konflikt i aftësisë globale: Nëse agjenti yt shpërfill një aftësi të instaluar në nivel global, instalo aftësinë në rrënjën e projektit tënd pa --global: bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
• Rregullat e shpërfillura: Sigurohu që skedari yt AGENTS.md, .cursorrules ose CLAUDE.md është në direktorinë rrënjë të projektit tënd.

Çfarë ka më pas

• Udhëzuesi i aftësive të Gemini API
• Aftësitë e Gemini API në GitHub
• API-ja e ndërveprimeve
• Modelet e disponueshme
• Bibliotekat dhe SDK-të