Настройка агента для написания кода и ресурсы для разработчиков

ИИ-агенты для программирования используют данные для обучения, которые ограничены определенной датой. Поэтому агенты часто предлагают устаревшие модели (gemini-1.5), старые SDK (google-generativeai) или устаревшие шаблоны кода.

Подключив агента к официальным ресурсам для разработчиков Gemini, вы поможете ему писать точный код с использованием текущих моделей, google-genai SDK и Interactions API.

Подключить агента к документации, правилам и инструментам CLI Gemini можно пятью способами:

Сводка ресурсов агента

Установите навыки агента Gemini

Навыки агента предоставляют вашему агенту программирования процедурные правила, текущие названия моделей и шаблоны кода SDK. Вместо того чтобы добавлять длинные инструкции в запрос, агент загружает каждый навык только по мере необходимости. Это поможет агенту избегать устаревших SDK и использовать современные шаблоны Gemini.

Навыки работают вместе с MCP-сервером Gemini для Документов. Если на вашем агенте не установлен сервер 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 и официальных SDK Gemini API (google-genai для Python и @google/genai для TypeScript). Этот навык включает:

• Генерация текста, многоэтапный чат, потоковая передача, структурированные выходные данные и вызов функций.
• Генерация изображений, преобразование текста в речь и мультимодальные запросы
• Управление состоянием чата на стороне сервера, выполнение в фоновом режиме, 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, временные токены клиентов и возобновление сеансов.
• Потоковая передача аудио, видео и текста с поддержкой обнаружения голосовой активности и прерывания.
• Рассуждения в фоновом режиме (расширенное мышление), неблокирующие асинхронные вызовы инструментов, расшифровка и перевод устной речи в реальном времени.

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

gemini-omni-flash-api

Навык для создания и редактирования видео с помощью Gemini Omni Flash и Interactions API. Включает вспомогательные скрипты (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",
            }
        ],
    },
)

Подключите MCP-сервер Gemini Docs

Общедоступный MCP-сервер Gemini Docs (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 – это самый быстрый способ настроить рабочую область. Он включает MCP-сервер Gemini Docs, все официальные навыки Gemini (gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api) и инструменты для работы с ключами API в одном скачиваемом пакете.

• Установка в Antigravity (UI). Перейдите в Settings (Настройки) > Customizations (Настройки) > Build with Google Plugins (Плагины Build with Google) и скачайте 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 Markdown (.md.txt). Добавьте .md.txt к любому URL документации на сайте ai.google.dev (например, https://ai.google.dev/gemini-api/docs/coding-agents.md.txt), чтобы получить чистый исходный код Markdown для сохраненных запросов, правил 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.

Настроенный агент будет использовать gemini_search_docs на сервере MCP geminiDocs и писать код с помощью client.interactions.create и SDK google-genai или @google/genai.

Команды статуса

Устранение неполадок

• Навык или 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 CLI
• Руководство по навыкам Gemini API
• Навыки Gemini API на GitHub
• Interactions API
• Доступные модели
• Библиотеки и SDK