Gemini 中文指南
获取 API 密钥 ↗

配置编程智能体与开发者资源

↓ 下载 MarkdownInteractions API

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) #

安装技能使用 skills.sh (推荐)或 背景7:

bash
# 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 代码
bash
npx skills add google-gemini/gemini-skills --skill gemini-api-dev --global

gemini-live-api-dev #

使用以下工具构建实时音频和视频流应用程序的技能 Gemini Live API。该技能涵盖:

  • WebSocket 会话管理、临时客户端 token 和会话恢复
  • 通过语音活动检测 (VAD) 和打断支持传输音频、视频和文本
  • 背景推理(扩展思维)、非阻塞异步工具调用、转录和实时语音翻译
bash
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)并涵盖:

  • 文本到视频的生成和提示制作
  • 第一帧和最后一帧过渡和参考引导视频生成
  • 视频扩展和媒体预处理工作流程
bash
npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

托管智能体中的挂载技巧 #

当您使用Interactions API运行远程托管智能体时,您可以挂载 google-gemini/gemini-skills 存储库到智能体的工作区。请参阅 Gemini API 技能指南 详情:

python
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 内容。

快速设置 #

在终端或项目根目录中运行此命令以自动配置检测到的编码智能体:

bash
npx add-mcp "https://gemini-api-docs-mcp.dev"

按环境配置 #

在您的终端中运行:

bash
$ claude mcp add --transport http geminiDocs 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 标头:

bash
curl --header "Accept: text/markdown" https://aistudio.google.com/docs/interactions-overview

您还可以点击 复制页面 将 Markdown 源代码复制到剪贴板。

推荐项目规则(AGENTS.md) #

项目规则文件(AGENTS.md, .cursorrules, 或 CLAUDE.md)设置在每个智能体会话开始时加载的基线规则。将这些指南添加到您的项目根目录中,以便将智能体默认编码为当前模型和 SDK:

markdown
# 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 文件位于项目的根目录中。

后续步骤 #

搜索标题、API 名称或正文内容