程式設計代理設定和開發人員資源

AI 程式碼編寫代理程式依賴的訓練資料有截斷日期。因此，服務專員經常會建議使用已淘汰的模型 (gemini-1.5)、舊版 SDK (google-generativeai) 或過時的程式碼模式。

將代理程式連結至官方 Gemini 開發人員資源，有助於代理程式使用現行模型、google-genai SDK 和 Interactions API 編寫正確的程式碼。

您可以透過下列四種方式，讓程式設計代理程式存取 Gemini 文件和規則：

代理資源摘要

安裝 Gemini 代理技能

代理程式技能會為程式設計代理提供程序規則、目前的模型名稱和 SDK 程式碼模式。不必在提示中加入長篇指令，代理程式只會在需要時載入各項技能。這有助於避免使用已淘汰的 SDK，並採用現代 Gemini 模式。

技能會與 Gemini Docs MCP 伺服器搭配運作。如果代理程式未安裝 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  --global

# Or install with Context7
npx ctx7 skills install /google-gemini/gemini-skills 

可用的技能

gemini-api-dev

具備使用 Interactions API 和官方 Gemini API SDK (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

這項技能可使用 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 技能指南：

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

連線至 Gemini Docs MCP 伺服器

公開的 Gemini 文件 MCP 伺服器 (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 外掛程式是設定工作區最快速的方法。這個套件會將 Gemini 版 Google 文件 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 安裝： bash agy plugin install https://github.com/google-gemini/gemini-skills

機器可讀的說明文件

標準網頁包含 HTML 標記、導覽列和指令碼，這些都會佔用內容視窗空間。ai.google.dev 提供機器可讀取的端點，因此代理程式和指令碼可以直接擷取乾淨的 Markdown：

• llms.txt 索引 (https://ai.google.dev/gemini-api/docs/llms.txt)： 列出所有 Gemini API 說明文件頁面，並提供各頁面的連結。
• 直接使用 Markdown 網址 (.md.txt)：在 ai.google.dev 上的任何說明文件網址後方附加 .md.txt (例如 https://ai.google.dev/gemini-api/docs/coding-agents.md.txt)，即可取得已儲存提示詞、AGENTS.md 規則或自動化指令碼的純 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://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.

設定的代理會使用 geminiDocs MCP 伺服器上的 gemini_search_docs，並使用 google-genai 或 @google/genai SDK 搭配 client.interactions.create 編寫程式碼。

狀態指令

疑難排解

• 系統未偵測到技能或 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 Skills 指南
• GitHub 上的 Gemini API 技能
• Interactions API
• 可用模型
• 程式庫和 SDK