Configuración del agente de programación y recursos para desarrolladores

Los agentes de codificación de IA dependen de datos de entrenamiento que se cortan en una fecha establecida. Por este motivo, los agentes suelen sugerir modelos obsoletos (gemini-1.5), SDKs anteriores (google-generativeai) o patrones de código desactualizados.

Conectar tu agente a los recursos oficiales para desarrolladores de Gemini lo ayuda a escribir código preciso con los modelos actuales, el SDK de google-genai y la API de Interactions.

Puedes otorgarle acceso a tu agente de programación a la documentación y las reglas de Gemini de cuatro maneras:

Resumen de los recursos del agente

Instala habilidades para agentes de Gemini

Las habilidades del agente le brindan a tu agente de programación reglas de procedimiento, nombres de modelos actuales y patrones de código del SDK. En lugar de agregar instrucciones largas a tu instrucción, tu agente carga cada habilidad solo cuando es necesario. Esto ayuda a tu agente a evitar los SDKs obsoletos y a usar patrones modernos de Gemini.

Las habilidades funcionan junto con el servidor de MCP de Gemini Docs. Si tu agente no tiene instalado el servidor de MCP, la habilidad recurre a llms.txt. Para obtener más información sobre cómo funcionan las habilidades, consulta la guía de habilidades de la API de Gemini.

Instalación con la CLI (skills.sh o Context7)

Instala habilidades con skills.sh (recomendado) o 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>

Habilidades disponibles

gemini-api-dev

Habilidad para compilar aplicaciones con la API de Interactions y los SDK oficiales de la API de Gemini (google-genai para Python y @google/genai para TypeScript) Esta habilidad abarca lo siguiente:

• Generación de texto, chat de varios turnos, transmisión, resultados estructurados y llamada a funciones
• Generación de imágenes, texto a voz (TTS) y entradas multimodales
• Administración del estado de la conversación del servidor, ejecución en segundo plano, investigación profunda y agentes administrados
• Nombres de los modelos actuales y migración del código heredado generateContent o google-generativeai

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

gemini-live-api-dev

Habilidad para crear aplicaciones de transmisión de audio y video en tiempo real con la API de Gemini Live. Esta habilidad abarca lo siguiente:

• Administración de sesiones de WebSocket, tokens de cliente efímeros y reanudación de sesiones
• Transmisión de audio, video y texto con detección de actividad de voz (VAD) y compatibilidad con interrupciones
• Razonamiento en segundo plano (pensamiento extendido), llamadas a herramientas asíncronas que no bloquean, transcripción y traducción de voz en vivo

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

gemini-omni-flash-api

Es una habilidad para generar y editar videos con Gemini Omni Flash usando la API de Interactions. Incluye secuencias de comandos de ayuda (upload_file.py, generate_video.py, prep_video.py, inspect_video.py) y abarca lo siguiente:

• Generación de texto a video y creación de instrucciones
• Transiciones de primer y último fotograma, y generación de videos guiada por referencias
• Extensiones de video y flujos de trabajo de preprocesamiento de medios

npx skills add google-gemini/gemini-skills --skill gemini-omni-flash-api --global

Cómo agregar habilidades en los agentes administrados

Cuando ejecutas agentes administrados de forma remota con la API de Interactions, puedes activar el repositorio google-gemini/gemini-skills en el espacio de trabajo del agente. Consulta la guía de Gemini API Skills para obtener más detalles:

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",
            }
        ],
    },
)

Conecta el servidor de MCP de Gemini Docs

El servidor de MCP de la documentación de Gemini público (https://gemini-api-docs-mcp.dev) le brinda a tu agente acceso en vivo a todo el sitio de documentación. Tu agente puede buscar y leer páginas de documentación para verificar esquemas de solicitudes, límites de modelos y funciones nuevas:

• gemini_search_docs: Busca en la documentación de la API de Gemini por tema o consulta.
• gemini_get_doc: Lee el contenido completo en Markdown de una página de documentación específica.

Configuración rápida

Ejecuta este comando en tu terminal o en la raíz del proyecto para configurar automáticamente los agentes de programación detectados:

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

Configuración por entorno

$ 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"
    }
  }
}

Complemento de la API de Gemini

Si usas Antigravity, el complemento de la API de Gemini es la forma más rápida de configurar tu espacio de trabajo. Incluye el servidor de MCP de Gemini Docs, todas las habilidades oficiales de Gemini (gemini-api-dev, gemini-live-api-dev, gemini-omni-flash-api) y las herramientas de claves de API en una sola descarga.

• Instalación en Antigravity (IU): Ve a Configuración > Personalizaciones > Compila con complementos de Google y descarga la API de Gemini.
• Instalación con la CLI: bash agy plugin install https://github.com/google-gemini/gemini-skills

Documentación legible por máquinas

Las páginas web estándar incluyen etiquetas HTML, barras de navegación y secuencias de comandos que ocupan espacio en la ventana de contexto. ai.google.dev proporciona extremos legibles por máquina para que los agentes y las secuencias de comandos puedan recuperar Markdown limpio directamente:

• Índice de llms.txt (https://ai.google.dev/gemini-api/docs/llms.txt): Enumera todas las páginas de documentación de la API de Gemini con vínculos a cada página.
• URLs de Markdown directas (.md.txt): Agrega .md.txt a cualquier URL de documentación en ai.google.dev (por ejemplo, https://ai.google.dev/gemini-api/docs/coding-agents.md.txt) para obtener una fuente de Markdown limpia para las instrucciones guardadas, las reglas de AGENTS.md o las secuencias de comandos automatizadas.

Reglas del proyecto recomendadas (AGENTS.md)

Un archivo de reglas del proyecto (AGENTS.md, .cursorrules o CLAUDE.md) establece reglas básicas que se cargan al inicio de cada sesión del agente. Agrega estos lineamientos a la raíz de tu proyecto para que los agentes de codificación usen de forma predeterminada los modelos y los SDKs actuales:

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

Verifica y soluciona problemas

Verifica la configuración

Para probar tu configuración, pregúntale a tu agente de programación lo siguiente:

Look up the request schema for the Gemini Interactions API in the documentation.

Un agente configurado usará gemini_search_docs en el servidor de MCP geminiDocs y escribirá código con client.interactions.create con el SDK de google-genai o @google/genai.

Comandos de estado

Solución de problemas

• No se detectó el servidor de Skill o MCP: Reinicia tu editor (Cursor o VS Code) o la sesión de la terminal (Claude Code o Codex). La mayoría de los agentes cargan los servidores y las habilidades de MCP solo cuando se inician.
• Conflicto de habilidad global: Si tu agente ignora una habilidad instalada de forma global, instala la habilidad en la raíz de tu proyecto sin --global: bash npx skills add google-gemini/gemini-skills --skill gemini-api-dev
• Reglas ignoradas: Asegúrate de que tu archivo AGENTS.md, .cursorrules o CLAUDE.md esté en el directorio raíz de tu proyecto.

¿Qué sigue?

• Guía de habilidades de la API de Gemini
• Habilidades de la API de Gemini en GitHub
• API de Interactions
• Modelos disponibles
• Bibliotecas y SDKs