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
generateContentataugoogle-generativeailama
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:
- Indeks
llms.txt(https://ai.google.dev/gemini-api/docs/llms.txt): Mencantumkan semua halaman dokumentasi Gemini API dengan link ke setiap halaman. - URL Markdown Langsung (
.md.txt): Tambahkan.md.txtke URL dokumentasi apa pun diai.google.dev(misalnya,https://ai.google.dev/gemini-api/docs/coding-agents.md.txt) untuk mendapatkan sumber Markdown yang bersih untuk perintah tersimpan, aturanAGENTS.md, atau skrip otomatis.
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, atauCLAUDE.mdberada di direktori root project Anda.