配置编程智能体与开发者资源
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). | 预装在 人工智能工作室构建;安装与 skills.sh、Context7 或托管智能体。 |
| Gemini Docs MCP Server | 实时搜索(gemini_search_docs)和整页阅读(gemini_get_doc)跨越所有文档。 | Claude Code、Cursor、OpenAI Codex 和 VS Code 支持。 |
| Gemini API Plugin | 包含官方 Gemini 技能、文档 MCP 服务器和 API 密钥工具的捆绑包。 | Antigravity。 |
| 机器可读文档 | 干净的 Markdown 页面, llms.txt 索引和内容协商标头。 | 所有文档页面 aistudio.google.com/docs. |
| Gemini API CLI | 无状态 CLI (gemini-api)生成媒体、分析文件并从 shell 运行托管智能体,而无需编写 SDK 代码。 | 使用安装脚本、Go 或预构建的二进制文件在 macOS、Linux 或 Windows 上安装。 |
安装Gemini 智能体技巧 #
智能体技能为您提供编码智能体程序规则、当前模型名称和 SDK 代码模式。您的智能体不会在提示中添加长指令,而是仅在需要时加载每项技能。这有助于您的智能体避免弃用 SDK 并使用现代 Gemini 模式。
技能与 Gemini Docs MCP 服务器一起使用。如果您的智能体没有安装 MCP 服务器,则该技能会回退到 llms.txt。要了解有关技能如何发挥作用的更多信息,请阅读 Gemini API 技能指南.
使用 CLI 安装(skills.sh 或上下文7) #
# 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(google-genai 对于Python和 @google/genai 对于 TypeScript)。该技能涵盖:
- 文本生成、多轮聊天、流式传输、结构化输出和函数调用
- 图像生成、文本转语音 (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 会话管理、临时客户端 token 和会话恢复
- 通过语音活动检测 (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(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服务器 (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 插件 #
如果你使用 Antigravity, 的 Gemini API 插件 是设置工作空间的最快方法。它捆绑了 Gemini Docs MCP 服务器、所有官方 Gemini 技能(gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api)和 API 密钥工具一次下载。
- 在Antigravity(UI)中安装: 前往 设置 > 自定义 > 使用 Google 插件构建 并下载 Gemini API.
- 使用 CLI 安装: ```bash agy 插件安装 https://github.com/google-gemini/gemini-skills
机器可读的文档 #
标准网页包括 HTML 标签、导航栏和占用上下文窗口空间的脚本。 AI Studio将文档作为干净的Markdown来保存token并帮助智能体直接阅读文档。
如何访问 Markdown #
| 方法 | 如何使用 | 为什么使用它 |
|---|---|---|
| 接受标头(内容协商) | 发送 Accept: text/markdown 在任何 /docs/... URL | 从您在浏览器中访问的同一 URL 获取原始 Markdown,无需更改路径。 |
直接 .md 网址 | 添加 .md 到任何文档 URL(例如 /docs/coding-agents.md) | 为您提供一个干净的 Markdown 链接以在提示中共享, AGENTS.md 文件或脚本。 |
llms.txt 指数 | https://aistudio.google.com/llms.txt | 列出每个文档页面以及每个原始 Markdown 文件的链接。 |
llms-full.txt 文件 | https://aistudio.google.com/llms-full.txt | 将所有 Gemini API 文档页面合并到一个文件中,以进行完整的上下文加载。 |
| 发现标头 | 包含在所有内容中 /docs HTTP 响应 | 套装 Link 和 X-Llms-Txt 标题,并添加一个 AI Agent Context 阻止 Markdown 页面以将智能体指向文档索引。 |
使用以下命令从任何文档 URL 获取 Markdown Accept 标头:
curl --header "Accept: text/markdown" https://aistudio.google.com/docs/interactions-overview
您还可以点击 复制页面 将 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 |
| 光标 | 打开 设置 > 功能 > MCP | 打开 设置 > 规则 |
| OpenAI 法典 | 运行 codex mcp list | 检查 .codex/skills/ 或 ~/.codex/skills/ |
| Antigravity | 打开 自定义 > 连接 | 打开 自定义 > 规则 或运行 /skills list |
| VS Code(Copilot) | 打开 扩展 > MCP 或输出面板 | 点击 选择工具 在副驾驶聊天中 |
问题排查 #
未检测到技能或 MCP 服务器: 重新启动编辑器(Cursor 或 VS Code)或终端会话(Claude Code 或 Codex)。大多数智能体仅在启动时加载 MCP 服务器和技能。
全球技能冲突: 如果您的智能体忽略全局安装的技能,请将该技能安装在您的项目根目录中,而不需要
--global: ```bash npx 技能添加 google-gemini/gemini-skills --skill gemini-api-dev忽略规则: 确保您的
AGENTS.md,.cursorrules, 或CLAUDE.md文件位于项目的根目录中。