Habilidades del agente de IA de Google Analytics

Para crear integraciones de informes y administración de propiedades de Google Analytics con mayor precisión y menor sobrecarga de tokens, equipa a tu agente de programación de IA con las habilidades de agente de IA de Google Analytics. Diseñadas para desarrolladores que crean con la API de Google Analytics Data y la API de Google Analytics Admin, las habilidades del agente de IA de Google Analytics son módulos portátiles y autónomos de instrucciones, flujos de trabajo y referencias de bibliotecas cliente.

Estas habilidades de agentes de IA funcionan con agentes de programación de IA que admiten el estándar abierto Agent Skills, incluidos Google Antigravity, Claude Code, Codex y Cursor. Para obtener una lista de las habilidades publicadas, consulta Habilidades disponibles.

Antes de comenzar

Antes de instalar y ejecutar las habilidades del agente de IA de Google Analytics, completa los siguientes requisitos previos:

  • Instala un agente de programación de IA que admita el estándar abierto Agent Skills, como Google Antigravity, Claude Code, Codex o Cursor.
  • Instala Node.js, que incluye el comando npx para instalar y actualizar habilidades desde la línea de comandos.
  • Crea o selecciona un proyecto de con acceso a una propiedad de Google Analytics cuando ejecutes flujos de trabajo de la API.

Comenzar

Instala, actualiza e invoca las habilidades del agente de IA de Google Analytics en tu entorno de desarrollo.

Instala habilidades de agentes de IA de Google Analytics

Instala el paquete de habilidades de Google Analytics en el directorio de tu proyecto con el comando npx o configura tu editor directamente:

Antigravity

Ejecuta el siguiente comando en el directorio de tu proyecto:

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

Ejecuta el siguiente comando en el directorio de tu proyecto:

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

Ejecuta el siguiente comando en el directorio de tu proyecto:

npx skills add google/skills/skills/analytics --agent=codex

Cursor

Agrega la URL del repositorio de habilidades (https://github.com/google/skills) en la configuración de tu editor, en las reglas personalizadas. Para obtener instrucciones, consulta la documentación de Cursor sobre cómo instalar habilidades desde GitHub.

Como alternativa, instala las habilidades en el directorio de tu proyecto con el comando npx:

npx skills add google/skills/skills/analytics --agent=cursor

Otros agentes

Para otros agentes de programación de IA que admiten el estándar abierto Agent Skills, ejecuta el siguiente comando en el directorio de tu proyecto:

npx skills add google/skills/skills/analytics

Actualiza las habilidades del agente de IA de Google Analytics

Descarga las actualizaciones disponibles y limpia las habilidades obsoletas ejecutando el siguiente comando:

npx skills update --all

Usa las habilidades del agente de IA de Google Analytics

Los agentes de programación de IA cargan habilidades automáticamente cuando detectan que la descripción de una habilidad coincide con tu instrucción. Las habilidades instaladas de forma global permanecen inactivas en los proyectos no relacionados, a menos que tu solicitud implique tareas de Google Analytics.

Para invocar una habilidad de forma manual en los agentes de programación con IA compatibles, ingresa el carácter / en la entrada del chat y selecciona la habilidad por su nombre.

Componentes principales de una habilidad

Cada habilidad de agente de IA de Google Analytics proporciona a tu agente de programación de IA los siguientes componentes:

  • Instrucciones especializadas: Orientación paso a paso para habilitar las APIs de Google Analytics con gcloud CLI, configurar las credenciales predeterminadas de la aplicación (ADC), compilar consultas de runReport y verificar la compatibilidad de los campos.
  • Prácticas recomendadas: Selección de la versión de la API recomendada (extremos v1beta para la estabilidad general y extremos v1alpha para las funciones de acceso anticipado de la API de Admin), construcción de solicitudes con tipos de datos definidos de forma estricta y flujos de trabajo de validación de esquemas.
  • Documentación de referencia: Guías de instalación de bibliotecas cliente específicas de cada lenguaje y muestras de código para Python, Java, Node.js, PHP, Go, .NET y Ruby en el directorio references/ de cada habilidad.

Beneficios de las habilidades de los agentes de IA

Las habilidades de agente de IA extienden tu agente de programación de IA con conocimientos especializados de Google Analytics on demand, sin cargar grandes conjuntos de documentación en cada conversación.

Reducción de los costos de los tokens

Cargar por adelantado la documentación de referencia completa de la API consume tokens de contexto y aumenta los costos de la sesión. Las habilidades de los agentes de IA usan la divulgación progresiva para minimizar el uso del contexto:

  • Al inicio, el agente de programación con IA solo lee el nombre y la descripción breve de cada habilidad para verificar si coincide con tu instrucción.
  • El agente carga las instrucciones completas de SKILL.md y los archivos de referencia específicos del idioma en la ventana de contexto activa solo cuando tu tarea los requiere.

Implementación guiada por IA

Describe tu objetivo en lenguaje natural, y las habilidades instaladas guiarán a tu agente de programación de IA a través de las tareas de implementación de Google Analytics, como las siguientes:

  • Habilitar la API de Google Analytics Data en mi proyecto de y escribir una secuencia de comandos de Python que consulte las métricas activeUsers y sessions por las dimensiones city y date.
  • Verifica si la dimensión itemName es compatible con las métricas activeUsers y totalRevenue de mi propiedad de Google Analytics con el método checkCompatibility.
  • Enumera todos los resúmenes de cuentas de Google Analytics y las propiedades secundarias accesibles en Node.js con la API de Google Analytics Admin.
  • Configurar dimensiones personalizadas, flujos de datos y secretos del Protocolo de medición para mi propiedad de Google Analytics

Usa habilidades junto con el servidor de MCP de Google Analytics

Las habilidades del agente de IA de Google Analytics complementan el servidor del Protocolo de contexto del modelo (MCP) de Google Analytics:

  • Servidor de MCP de Google Analytics: Conecta tu agente de programación de IA directamente a las propiedades de Google Analytics activas para que el agente pueda inspeccionar los resúmenes de la cuenta, los detalles de la propiedad, las dimensiones personalizadas, las métricas personalizadas y los informes en tiempo real.
  • Habilidades del agente de IA de Google Analytics: Proporciona instrucciones eficientes en cuanto a tokens y referencias de la biblioteca cliente que guían a tu agente de programación de IA cuando habilita las APIs de , configura la autenticación de ADC, verifica la compatibilidad de los campos y escribe el código de la aplicación.

Habilidades disponibles

Google mantiene las siguientes habilidades del agente de IA de Google Analytics en el repositorio google/skills:

Habilidad Descripción
google-analytics-data-api-basics Habilita la API de Google Analytics Data (analyticsdata.googleapis.com) con gcloud CLI, configura las ADC con el permiso de OAuth 2.0 de analytics.readonly y, además, instala las bibliotecas cliente oficiales de v1beta (Python, Java, PHP, Node.js, Go, .NET y Ruby). Guía a tu agente para que cree consultas de runReport y verifique la compatibilidad de los campos con los métodos getMetadata y checkCompatibility.
google-analytics-admin-api-basics Habilita la API de Google Analytics Admin (analyticsadmin.googleapis.com) con gcloud CLI, configura ADC con los permisos de OAuth 2.0 analytics.readonly y analytics.edit, y, además, instala las bibliotecas cliente oficiales de v1beta y v1alpha (Python, Java, PHP, Node.js, Go, .NET y Ruby). Guía a tu agente para que enumere los resúmenes de cuentas y administre las propiedades, los flujos de datos, las dimensiones personalizadas, las métricas personalizadas, los eventos clave, los secretos de Measurement Protocol y las vinculaciones de productos.

Próximos pasos