Penyiapan agen coding & referensi developer

Agen coding AI bergantung pada data pelatihan yang dihentikan pada tanggal tertentu. Oleh karena itu, agen sering menyarankan model yang tidak digunakan lagi (gemini-1.5), SDK yang lebih lama (google-generativeai), atau pola kode yang sudah usang.

Menghubungkan agen Anda ke referensi developer Gemini resmi akan membantunya menulis kode yang akurat menggunakan model saat ini, SDK google-genai, dan Interactions API.

Anda dapat memberi agen coding akses ke dokumentasi dan aturan Gemini dengan empat cara:

Ringkasan resource agen

Resource Yang disediakan Ketersediaan
Keahlian Agen Gemini Aturan langkah demi langkah, pola SDK, dan skrip pembantu untuk fitur tertentu (gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api). Sudah diinstal di Build AI Studio; instal dengan skills.sh, Context7, atau Agen Terkelola.
Server MCP Gemini Docs Penelusuran langsung (gemini_search_docs) dan pembacaan halaman penuh (gemini_get_doc) di semua dokumentasi. Didukung di Claude Code, Cursor, OpenAI Codex, dan VS Code.
Plugin Gemini API Paket gabungan dengan kemampuan Gemini resmi, server MCP Docs, dan alat kunci API. Antigravity.
Dokumen yang Dapat Dibaca Mesin Bersihkan halaman Markdown dan indeks llms.txt. Semua halaman dokumentasi di ai.google.dev/gemini-api/docs.

Menginstal keahlian agen Gemini

Kemampuan agen memberikan aturan prosedural, nama model saat ini, dan pola kode SDK kepada agen coding Anda. Daripada menambahkan petunjuk panjang ke perintah Anda, agen Anda hanya memuat setiap keahlian saat diperlukan. Hal ini membantu agen Anda menghindari SDK yang tidak digunakan lagi dan menggunakan pola Gemini modern.

Keahlian berfungsi bersama server MCP Gemini Docs. Jika agen Anda tidak menginstal server MCP, skill akan kembali ke llms.txt. Untuk mempelajari lebih lanjut cara kerja keahlian, baca panduan Keahlian Gemini API.

Menginstal dengan CLI (skills.sh atau Context7)

Instal skill menggunakan skills.sh (direkomendasikan) atau 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>

Keahlian yang tersedia

gemini-api-dev

Keahlian untuk membangun aplikasi dengan Interactions API dan SDK Gemini API resmi (google-genai untuk Python dan @google/genai untuk TypeScript). Keterampilan ini mencakup:

  • Pembuatan teks, multi-turn chat, streaming, output terstruktur, dan panggilan fungsi
  • Pembuatan gambar, text-to-speech (TTS), dan input multimodal
  • Pengelolaan status percakapan sisi server, eksekusi latar belakang, Riset Mendalam, dan agen terkelola
  • Nama model saat ini dan memigrasikan kode generateContent atau google-generativeai lama
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

gemini-live-api-dev

Keterampilan untuk membangun aplikasi streaming audio dan video real-time dengan Gemini Live API. Keahlian ini mencakup:

  • Pengelolaan sesi WebSocket, token klien sementara, dan kelanjutan sesi
  • Streaming audio, video, dan teks dengan deteksi aktivitas suara (VAD) dan dukungan interupsi
  • Penalaran latar belakang (pemikiran yang lebih mendalam), panggilan alat asinkronis yang tidak memblokir, transkripsi, dan terjemahan ucapan langsung
npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global

gemini-omni-flash-api

Keterampilan untuk membuat dan mengedit video dengan Gemini Omni Flash menggunakan Interactions API. Mencakup skrip pendukung (upload_file.py, generate_video.py, prep_video.py, inspect_video.py) dan mencakup:

  • Pembuatan video dari teks dan pembuatan perintah
  • Transisi frame pertama dan terakhir serta pembuatan video yang dipandu referensi
  • Alur kerja pra-pemrosesan media dan ekstensi video
npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

Menyematkan keahlian di Agen Terkelola

Saat menjalankan agen yang dikelola dari jarak jauh dengan Interactions API, Anda dapat memasang repositori google-gemini/gemini-skills ke ruang kerja agen. Lihat Panduan Keterampilan Gemini API untuk mengetahui detailnya:

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

Menghubungkan server MCP Gemini Docs

Server MCP Gemini Docs publik (https://gemini-api-docs-mcp.dev) memberi agen Anda akses langsung ke seluruh situs dokumentasi. Agen Anda dapat menelusuri dan membaca halaman dokumentasi untuk memeriksa skema permintaan, batas model, dan fitur baru:

  • gemini_search_docs: Menelusuri dokumentasi Gemini API berdasarkan topik atau kueri.
  • gemini_get_doc: Membaca konten Markdown lengkap dari halaman dokumentasi tertentu.

Penyiapan cepat

Jalankan perintah ini di terminal atau root project untuk mengonfigurasi agen coding yang terdeteksi secara otomatis:

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

Konfigurasi menurut lingkungan

Claude Code

Jalankan di terminal Anda:

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

Kursor

Tambahkan ke ~/.cursor/mcp.json (global) atau .cursor/mcp.json (project):

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

OpenAI Codex

Jalankan di terminal Anda:

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

Atau tambahkan ke ~/.codex/config.toml:

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

VS Code (Copilot)

Menambahkan ke .vscode/mcp.json di ruang kerja Anda:

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

Plugin Gemini API

Jika Anda menggunakan Antigravity, plugin Gemini API adalah cara tercepat untuk menyiapkan ruang kerja Anda. Paket ini menggabungkan server MCP Gemini Dokumen, semua kemampuan Gemini resmi (gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api), dan alat kunci API dalam satu download.

  • Menginstal di Antigravity (UI): Buka Setelan > Penyesuaian > Buat dengan Plugin Google dan download Gemini API.
  • Instal dengan CLI: bash agy plugin install https://github.com/google-gemini/gemini-skills

Dokumentasi yang dapat dibaca mesin

Halaman web standar mencakup tag HTML, kolom navigasi, dan skrip yang menggunakan ruang jendela konteks. ai.google.dev menyediakan endpoint yang dapat dibaca mesin sehingga agen dan skrip dapat mengambil Markdown bersih secara langsung:

Aturan project yang direkomendasikan (AGENTS.md)

File aturan project (AGENTS.md, .cursorrules, atau CLAUDE.md) menetapkan aturan dasar yang dimuat di awal setiap sesi agen. Tambahkan panduan ini ke root project Anda agar agen pengodean menggunakan model dan SDK saat ini secara default:

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

Memverifikasi dan memecahkan masalah

Memverifikasi penyiapan Anda

Untuk menguji penyiapan Anda, tanyakan kepada agen coding Anda:

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

Agen yang dikonfigurasi akan menggunakan gemini_search_docs di server MCP geminiDocs dan menulis kode menggunakan client.interactions.create dengan SDK google-genai atau @google/genai.

Perintah status

Lingkungan Verifikasi MCP Verifikasi keterampilan
Claude Code Jalankan /mcp Jalankan /skills
Kursor Buka Setelan > Fitur > MCP Buka Setelan > Aturan
OpenAI Codex Jalankan codex mcp list Periksa .codex/skills/ atau ~/.codex/skills/
Antigravity Buka Penyesuaian > Koneksi Buka Penyesuaian > Aturan atau jalankan /skills list
VS Code (Copilot) Buka panel Extensions > MCP atau Output Klik Pilih Alat di Copilot Chat

Pemecahan masalah

  • Server Skill atau MCP tidak terdeteksi: Mulai ulang editor (Cursor atau VS Code) atau sesi terminal (Claude Code atau Codex). Sebagian besar agen memuat server dan kemampuan MCP hanya saat dimulai.
  • Konflik kemampuan global: Jika agen Anda mengabaikan kemampuan yang diinstal secara global, instal kemampuan di root project Anda tanpa --global: bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
  • Aturan diabaikan: Pastikan file AGENTS.md, .cursorrules, atau CLAUDE.md berada di direktori root project Anda.

Langkah berikutnya