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

AI 编码智能体依赖于在设定日期截止的训练数据。因此，智能体经常建议弃用的模型（`gemini-1.5`）、较旧的 SDK（`google-generativeai`），或过时的代码模式。

将您的智能体连接到官方 Gemini 开发人员资源有助于它使用当前模型编写准确的代码， `google-genai` SDK，以及 [Interactions API](/docs/interactions-overview).

您可以通过五种方式将编码智能体连接到 Gemini 文档、规则和 CLI 工具：

## 智能体资源汇总  {% #summary %}

| 资源                                                              | 它提供什么                                                                                       | 可用性                                                                       |
| --------------------------------------------------------------- | ------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------- |
| **[Gemini Agent Skills](/docs/coding-agents#available-skills)** | 分步规则、SDK 模式以及特定功能的帮助程序脚本（`gemini-api-dev`, `gemini-live-api-dev`, `gemini-omni-flash-api`). | 预装在 [人工智能工作室构建](https://ai.studio/build);安装与 `skills.sh`、Context7 或托管智能体。 |
| **[Gemini Docs MCP Server](/docs/coding-agents#mcp-setup)**     | 实时搜索（`gemini_search_docs`）和整页阅读（`gemini_get_doc`）跨越所有文档。                                    | Claude Code、Cursor、OpenAI Codex 和 VS Code 支持。                             |
| **[Gemini API Plugin](/docs/coding-agents#gemini-api-plugin)**  | 包含官方 Gemini 技能、文档 MCP 服务器和 API 密钥工具的捆绑包。                                                    | Antigravity。                                                              |
| **[机器可读文档](/docs/coding-agents#machine-readable-docs)**         | 干净的 Markdown 页面， `llms.txt` 索引和内容协商标头。                                                      | 所有文档页面 `aistudio.google.com/docs`.                                        |
| **[Gemini API CLI](/docs/cli)**                                 | 无状态 CLI (`gemini-api`）生成媒体、分析文件并从 shell 运行托管智能体，而无需编写 SDK 代码。                               | 使用安装脚本、Go 或预构建的二进制文件在 macOS、Linux 或 Windows 上安装。                          |

## 安装Gemini 智能体技巧  {% #available-skills %}

智能体技能为您提供编码智能体程序规则、当前模型名称和 SDK 代码模式。您的智能体不会在提示中添加长指令，而是仅在需要时加载每项技能。这有助于您的智能体避免弃用 SDK 并使用现代 Gemini 模式。

技能与 Gemini Docs MCP 服务器一起使用。如果您的智能体没有安装 MCP 服务器，则该技能会回退到 [`llms.txt`](https://aistudio.google.com/llms.txt)。要了解有关技能如何发挥作用的更多信息，请阅读 [Gemini API 技能指南](https://aistudio.google.com/learn/gemini-api-skills).

{% callout type="note" %}
技能已预先安装在 [Google AI Studio 构建](https://ai.studio/build) 并捆绑在 [Gemini API 插件](/docs/coding-agents#gemini-api-plugin) 适用于 Antigravity。
{% /callout %}

### 使用 CLI 安装（`skills.sh` 或上下文7)  {% #install-skills-cli %}

安装技能使用 [skills.sh](https://skills.sh) （推荐）或 [背景7](https://context7.com):

```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>
```

### 可用技能  {% #skills-catalog %}

#### `gemini-api-dev` {% #gemini-api-dev %}

构建应用程序的技能 [Interactions API](/docs/interactions-overview) 和官方 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-dev %}

使用以下工具构建实时音频和视频流应用程序的技能 [Gemini Live API](/docs/live-api)。该技能涵盖：

- WebSocket 会话管理、临时客户端 token 和会话恢复
- 通过语音活动检测 (VAD) 和打断支持传输音频、视频和文本
- 背景推理（扩展思维）、非阻塞异步工具调用、转录和实时语音翻译

```bash
npx skills add google-gemini/gemini-skills --skill gemini-live-api-dev --global
```

#### `gemini-omni-flash-api` {% #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
```

### 托管智能体中的挂载技巧  {% #managed-agents-skills %}

当您使用Interactions API运行远程托管智能体时，您可以挂载 `google-gemini/gemini-skills` 存储库到智能体的工作区。请参阅 [Gemini API 技能指南](https://aistudio.google.com/learn/gemini-api-skills) 详情：

```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服务器  {% #mcp-setup %}

公众 **Gemini Docs MCP服务器** (`https://gemini-api-docs-mcp.dev`）使您的智能体可以实时访问整个文档站点。您的智能体可以搜索和阅读文档页面以检查请求架构、模型限制和新功能：

- `gemini_search_docs`：按主题或查询搜索 Gemini API 文档。
- `gemini_get_doc`：读取特定文档页面的完整 Markdown 内容。

### 快速设置  {% #mcp-quick-setup %}

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

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

### 按环境配置  {% #mcp-by-environment %}

{% tabs %}
{% tab label="Claude Code" %}
在您的终端中运行：

```bash
$ claude mcp add --transport http geminiDocs https://gemini-api-docs-mcp.dev
```
{% /tab %}

{% tab label="光标" %}
添加到 `~/.cursor/mcp.json` （全球）或 `.cursor/mcp.json` （项目）：

```json
{
  "mcpServers": {
    "geminiDocs": {
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}
```
{% /tab %}

{% tab label="OpenAI 法典" %}
在您的终端中运行：

```bash
$ codex mcp add geminiDocs --url https://gemini-api-docs-mcp.dev
```

或者添加到 `~/.codex/config.toml`:

```toml
[mcp_servers.geminiDocs]
url = "https://gemini-api-docs-mcp.dev"
```
{% /tab %}

{% tab label="VS Code（Copilot）" %}
添加到 `.vscode/mcp.json` 在您的工作空间中：

```json
{
  "servers": {
    "geminiDocs": {
      "type": "http",
      "url": "https://gemini-api-docs-mcp.dev"
    }
  }
}
```
{% /tab %}
{% /tabs %}

## Gemini API 插件  {% #gemini-api-plugin %}

如果你使用 **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
  ```
  
  
  ```

## 机器可读的文档  {% #machine-readable-docs %}

标准网页包括 HTML 标签、导航栏和占用上下文窗口空间的脚本。 AI Studio将文档作为干净的Markdown来保存token并帮助智能体直接阅读文档。

### 如何访问 Markdown  {% #markdown-access-methods %}

| 方法                     | 如何使用                                                                                     | 为什么使用它                                                                          |
| ---------------------- | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------- |
| **接受标头（内容协商）**         | 发送 `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`](https://aistudio.google.com/llms.txt)           | 列出每个文档页面以及每个原始 Markdown 文件的链接。                                                  |
| **`llms-full.txt` 文件** | [`https://aistudio.google.com/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`)  {% #project-rules %}

项目规则文件（`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.
```

## 验证并排除故障  {% #verification-troubleshooting %}

### 验证您的设置  {% #verify-setup %}

要测试您的设置，请询问您的编码智能体：

```none
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。

### 状态命令  {% #status-commands %}

| 环境                   | MCP验证                 | 技能验证                                     |
| -------------------- | --------------------- | ---------------------------------------- |
| **Claude Code**      | 运行 `/mcp`             | 运行 `/skills`                             |
| **光标**               | 打开 **设置 > 功能 > MCP**  | 打开 **设置 > 规则**                           |
| **OpenAI 法典**        | 运行 `codex mcp list`   | 检查 `.codex/skills/` 或 `~/.codex/skills/` |
| **Antigravity**      | 打开 **自定义 > 连接**       | 打开 **自定义 > 规则** 或运行 `/skills list`       |
| **VS Code（Copilot）** | 打开 **扩展 > MCP** 或输出面板 | 点击 **选择工具** 在副驾驶聊天中                      |

### 问题排查  {% #troubleshooting %}

- **未检测到技能或 MCP 服务器：** 重新启动编辑器（Cursor 或 VS Code）或终端会话（Claude Code 或 Codex）。大多数智能体仅在启动时加载 MCP 服务器和技能。

- **全球技能冲突：** 如果您的智能体忽略全局安装的技能，请将该技能安装在您的项目根目录中，而不需要 `--global`: ```bash npx 技能添加 google-gemini/gemini-skills --skill gemini-api-dev

  ```
  
  ```

- **忽略规则：** 确保您的 `AGENTS.md`, `.cursorrules`, 或 `CLAUDE.md` 文件位于项目的根目录中。

## 后续步骤  {% #whats-next %}

- [Gemini API CLI](/docs/cli)
- [Gemini API 技能指南](https://aistudio.google.com/learn/gemini-api-skills)
- [Gemini API GitHub 上的技能](https://github.com/google-gemini/gemini-skills)
- [Interactions API](/docs/interactions-overview)
- [可用型号](/docs/models)
- [库和 SDK](/docs/libraries)
