程式設計代理設定與開發人員資源¶
AI 程式設計代理仰賴的訓練資料有固定的截止日期。因此,代理經常會建議已淘汰的模型(gemini-1.5)、較舊的 SDK(google-generativeai),或過時的程式碼模式。
將代理連接到官方的 Gemini 開發人員資源,能協助它使用目前的模型、google-genai SDK 以及 Interactions API,寫出正確的程式碼。
你可以透過五種方式,將程式設計代理連接到 Gemini 文件、規則與 CLI 工具:
代理資源摘要¶
| 資源 | 提供內容 | 可用性 |
|---|---|---|
| Gemini Agent Skills | 針對特定功能的逐步規則、SDK 模式與輔助指令碼(gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api)。 |
已預先安裝於 AI Studio Build;可透過 skills.sh、Context7 或 Managed Agents 安裝。 |
| Gemini Docs MCP Server | 可即時搜尋(gemini_search_docs)並完整讀取所有文件頁面(gemini_get_doc)。 |
支援 Claude Code、Cursor、OpenAI Codex 與 VS Code。 |
| Gemini API Plugin | 整合官方 Gemini 技能、Docs MCP 伺服器與 API 金鑰工具的套裝套件。 | Antigravity。 |
| Machine-Readable Docs | 乾淨的 Markdown 頁面、llms.txt 索引與內容協商標頭。 |
aistudio.google.com/docs 上的所有文件頁面。 |
| Gemini API CLI | 無狀態 CLI(gemini-api),可在不撰寫 SDK 程式碼的情況下,從殼層產生媒體、分析檔案並執行受管理代理。 |
可透過安裝指令碼、Go 或預先建置的二進位檔,安裝於 macOS、Linux 或 Windows。 |
安裝 Gemini 代理技能¶
代理技能為程式設計代理提供程序規則、目前的模型名稱與 SDK 程式碼模式。代理不需要在提示詞中加入冗長的指令,而是只在需要時才載入各項技能。這能協助代理避開已淘汰的 SDK,並採用現代的 Gemini 模式。
技能可與 Gemini Docs MCP 伺服器搭配運作。如果代理未安裝 MCP 伺服器,技能會改用 llms.txt 作為備援。如需進一步瞭解技能的運作方式,請參閱 Gemini API Skills guide。
技能已預先安裝於 Google AI Studio Build,並隨 Antigravity 的 Gemini API plugin 一併提供。
使用 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 與官方 Gemini API SDK(Python 版 google-genai 與 TypeScript 版 @google/genai)建置應用程式。此技能涵蓋:
- 文字產生、多輪對話、串流、結構化輸出與函式呼叫
- 圖片產生、文字轉語音(TTS)與多模態輸入
- 伺服器端對話狀態管理、背景執行、Deep Research 與受管理代理
- 目前的模型名稱,以及遷移舊版
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¶
此技能用於透過 Interactions API 使用 Gemini Omni Flash 產生與編輯影片。包含輔助指令碼(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
在 Managed Agents 中掛載技能¶
透過 Interactions API 執行遠端受管理代理時,你可以將 google-gemini/gemini-skills 儲存庫掛載到代理的工作區。詳情請參閱 Gemini API Skills guide:
from google import genai
client = genai.Client(http_options={"api_version": "v1beta"})
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",
}
],
},
)
連接 Gemini Docs MCP 伺服器¶
公開的 Gemini Docs MCP server(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
加入 ~/.cursor/mcp.json(全域)或 .cursor/mcp.json(專案):
{
"mcpServers": {
"geminiDocs": {
"url": "https://gemini-api-docs-mcp.dev"
}
}
}
在終端機中執行:
$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev
或加入 ~/.codex/config.toml:
[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"
加入工作區中的 .vscode/mcp.json:
{
"servers": {
"geminiDocs": {
"type": "http",
"url": "https://gemini-api-docs-mcp.dev"
}
}
}
Gemini API plugin¶
如果你使用 Antigravity,Gemini API plugin 是設定工作區最快速的方式。它將 Gemini Docs MCP 伺服器、所有官方 Gemini 技能(gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api)與 API 金鑰工具整合在單一下載中。
- 在 Antigravity 中安裝(UI):前往 Settings > Customizations > Build with Google Plugins,並下載 Gemini API。
- 使用 CLI 安裝:
agy plugin install https://github.com/google-gemini/gemini-skills
機器可讀文件¶
標準網頁包含 HTML 標籤、導覽列與指令碼,會占用上下文視窗空間。AI Studio 以乾淨的 Markdown 提供文件,以節省權杖,並協助代理直接閱讀文件。
如何存取 Markdown¶
| 方法 | 使用方式 | 使用理由 |
|---|---|---|
| Accept header (content negotiation) | 在任何 URL 上傳送 Accept: text/markdown,URL 形式為 /docs/... |
從你在瀏覽器中造訪的同一個 URL 取得原始 Markdown,無需變更路徑。 |
Direct .md URLs |
在任何文件 URL 後加上 .md(例如 /docs/coding-agents.md) |
提供乾淨的 Markdown 連結,可在提示詞、AGENTS.md 檔案或指令碼中分享。 |
llms.txt index |
https://aistudio.google.com/llms.txt |
列出每個文件頁面,並附上各原始 Markdown 檔案的連結。 |
llms-full.txt file |
https://aistudio.google.com/llms-full.txt |
將所有 Gemini API 文件頁面合併為單一檔案,以便載入完整上下文。 |
| Discovery headers | 包含於所有 /docs HTTP 回應中 |
設定 Link 與 X-Llms-Txt 標頭,並在 Markdown 頁面中加入 AI Agent Context 區塊,將代理導向文件索引。 |
若要使用 Accept 標頭從任何文件 URL 取得 Markdown:
curl --header "Accept: text/markdown" https://aistudio.google.com/docs/interactions-overview
你也可以點選任何文件頁面頂端的 Copy page,將 Markdown 原始內容複製到剪貼簿。
建議的專案規則(AGENTS.md)¶
專案規則檔案(AGENTS.md、.cursorrules 或 CLAUDE.md)設定基準規則,並在每個代理工作階段開始時載入。將這些指南加入專案根目錄,讓程式設計代理預設使用目前的模型與 SDK:
# Gemini API Guidelines
- Before writing Gemini API code, consult the `geminiDocs` MCP server (`gemini_search_docs` / `gemini_get_doc`) or `https://aistudio.google.com/llms.txt`.
- Always use the current Google Gen AI 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://aistudio.google.com/docs/models) and avoid deprecated models.
驗證與疑難排解¶
驗證你的設定¶
若要測試設定,請向程式設計代理提出以下要求:
Look up the request schema for the Gemini Interactions API in the documentation.
設定完成的代理會使用 gemini_search_docs 查詢 geminiDocs MCP 伺服器,並透過 client.interactions.create 撰寫程式碼,搭配 google-genai 或 @google/genai SDK。
狀態指令¶
| 環境 | MCP 驗證 | 技能驗證 |
|---|---|---|
| Claude Code | 執行 /mcp |
執行 /skills |
| Cursor | 開啟 Settings > Features > MCP | 開啟 Settings > Rules |
| OpenAI Codex | 執行 codex mcp list |
檢查 .codex/skills/ 或 ~/.codex/skills/ |
| Antigravity | 開啟 Customizations > Connections | 開啟 Customizations > Rules 或執行 /skills list |
| VS Code (Copilot) | 開啟 Extensions > MCP 或 Output 面板 | 在 Copilot Chat 中點選 Select Tools |
疑難排解¶
- 未偵測到技能或 MCP 伺服器:重新啟動編輯器(Cursor 或 VS Code)或終端機工作階段(Claude Code 或 Codex)。大多數代理只在啟動時載入 MCP 伺服器與技能。
-
全域技能衝突:如果代理忽略全域安裝的技能,請在專案根目錄安裝該技能,不要加上
--global:npx skills add google-gemini/gemini-skills --skill gemini-api-dev -
規則遭到忽略:請確認你的
AGENTS.md、.cursorrules或CLAUDE.md檔案位於專案的根目錄。