AI コーディング エージェントは、特定の日付でカットオフされたトレーニング データに依存しています。このため、エージェントは非推奨のモデル(gemini-1.5)、古い SDK(google-generativeai)、古いコードパターンを提案することがよくあります。
エージェントを公式の Gemini デベロッパー リソースに接続すると、現在のモデル、google-genai SDK、Interactions API を使用して正確なコードを作成できます。
コーディング エージェントを Gemini のドキュメント、ルール、CLI ツールに接続するには、次の 5 つの方法があります。
エージェント リソースの概要
| リソース | 提供される機能 | 対象 |
|---|---|---|
| Gemini Agent Skills | 特定の機能(gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api)のステップバイステップのルール、SDK パターン、ヘルパー スクリプト。 |
AI Studio Build にプリインストールされています。skills.sh、Context7、またはマネージド エージェントを使用してインストールします。 |
| Gemini Docs MCP サーバー | すべてのドキュメントを対象とした Live Search(gemini_search_docs)とページ全体の読み上げ(gemini_get_doc)。 |
Claude Code、Cursor、OpenAI Codex、VS Code でサポートされています。 |
| Gemini API プラグイン | 公式の Gemini スキル、Docs MCP サーバー、API キー ツールを含むバンドル パッケージ。 | Antigravity。 |
| 機械で読み取り可能なドキュメント | Markdown ページと llms.txt インデックスをクリーンアップします。 |
ai.google.dev/gemini-api/docs のすべてのドキュメント ページ。 |
| Gemini API CLI | ステートレス CLI(gemini-api)を使用すると、SDK コードを記述せずに、シェルから生成メディアの生成、ファイルの分析、Managed Agents の実行を行うことができます。 |
インストール スクリプト、Go、またはビルド済みのバイナリを使用して、macOS、Linux、Windows にインストールします。 |
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 <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
マネージド エージェントにスキルをマウントする
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 Docs 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 Code
ターミナルで次のコマンドを実行します。
$ claude mcp add --transport http geminiDocs https://gemini-api-docs-mcp.dev
Cursor
~/.cursor/mcp.json(グローバル)または .cursor/mcp.json(プロジェクト)に追加します。
{
"mcpServers": {
"geminiDocs": {
"url": "https://gemini-api-docs-mcp.dev"
}
}
}
OpenAI Codex
ターミナルで次のコマンドを実行します。
$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev
または ~/.codex/config.toml に追加します。
[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"
VS Code(Copilot)
ワークスペースの .vscode/mcp.json に追加します。
{
"servers": {
"geminiDocs": {
"type": "http",
"url": "https://gemini-api-docs-mcp.dev"
}
}
}
Gemini API プラグイン
Antigravity を使用している場合は、Gemini API プラグインを使用すると、ワークスペースを最も迅速に設定できます。Gemini Docs MCP サーバー、すべての公式 Gemini スキル(gemini-api-dev、gemini-live-api-dev、gemini-omni-flash-api)、API キー ツールが 1 つのダウンロードにバンドルされています。
- Antigravity(UI)にインストールする: [設定] > [カスタマイズ] > [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 ドキュメント ページを一覧表示し、各ページへのリンクを提供します。- 直接マークダウン URL(
.md.txt):ai.google.devのドキュメント URL(例:https://ai.google.dev/gemini-api/docs/coding-agents.md.txt)に.md.txtを追加して、保存されたプロンプト、AGENTS.mdルール、自動スクリプトのクリーンなマークダウン ソースを取得します。
推奨されるプロジェクト ルール(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 を使用してコードを記述します。
Status コマンド
| 環境 | MCP の確認 | スキルの検証 |
|---|---|---|
| Claude Code | /mcp を実行します |
/skills を実行します |
| Cursor | [Settings] > [Features] > [MCP] を開きます。 | [設定] > [ルール] を開きます。 |
| OpenAI Codex | codex mcp list を実行します |
.codex/skills/ または ~/.codex/skills/ を確認する |
| Antigravity | [カスタマイズ] > [接続] を開きます。 | [カスタマイズ] > [ルール] を開くか、/skills list を実行します。 |
| VS Code(Copilot) | [拡張機能] > [MCP] または [出力] パネルを開きます。 | Copilot Chat で [ツールを選択] をクリックします。 |
トラブルシューティング
- スキルまたは 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ファイルがプロジェクトのルート ディレクトリにあることを確認します。