Compétences de l'agent IA Google Analytics

Pour créer des intégrations de rapports et de gestion des propriétés Google Analytics avec une plus grande précision et moins de frais généraux liés aux jetons, dotez votre agent de codage IA de compétences d'agent IA Google Analytics. Conçues pour les développeurs qui utilisent l'API Google Analytics Data et l'API Google Analytics Admin, les compétences de l'agent IA Google Analytics sont des modules portables et autonomes d'instructions, de workflows et de références de bibliothèques clientes.

Ces compétences d'agent IA fonctionnent avec les agents de codage IA compatibles avec la norme ouverte Agent Skills, y compris Google Antigravity, Claude Code, Codex et Cursor. Pour obtenir la liste des compétences publiées, consultez Compétences disponibles.

Avant de commencer

Avant d'installer et d'exécuter les compétences de l'agent IA Google Analytics, remplissez les conditions préalables suivantes :

  • Installez un agent de codage IA compatible avec la norme ouverte Agent Skills, comme Google Antigravity, Claude Code, Codex ou Cursor.
  • Installez Node.js, qui inclut la commande npx pour installer et mettre à jour les skills à partir de la ligne de commande.
  • Créez ou sélectionnez un projet ayant accès à une propriété Google Analytics lors de l'exécution des workflows d'API.

Commencer

Installez, mettez à jour et appelez les compétences de l'agent IA Google Analytics dans votre environnement de développement.

Installer les compétences de l'agent IA Google Analytics

Installez la suite de compétences Google Analytics dans le répertoire de votre projet à l'aide de la commande npx ou configurez directement votre éditeur :

Antigravity

Exécutez la commande suivante dans le répertoire de votre projet :

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

Claude Code

Exécutez la commande suivante dans le répertoire de votre projet :

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

Codex

Exécutez la commande suivante dans le répertoire de votre projet :

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

Cursor

Ajoutez l'URL du dépôt de compétences (https://github.com/google/skills) dans les paramètres de votre éditeur, sous "Règles personnalisées". Pour obtenir des instructions, consultez la documentation de Cursor sur l'installation de compétences depuis GitHub.

Vous pouvez également installer les compétences dans le répertoire de votre projet à l'aide de la commande npx :

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

Autres agents

Pour les autres agents de codage IA compatibles avec la norme ouverte Agent Skills, exécutez la commande suivante dans le répertoire de votre projet :

npx skills add google/skills/skills/analytics

Mettre à jour les compétences de l'agent IA Google Analytics

Téléchargez les mises à jour disponibles et supprimez les compétences obsolètes en exécutant la commande suivante :

npx skills update --all

Utiliser les compétences de l'agent IA Google Analytics

Les agents de codage IA chargent automatiquement les compétences lorsqu'ils détectent que la description d'une compétence correspond à votre prompt. Les compétences installées de manière globale restent inactives dans les projets non liés, sauf si votre requête implique des tâches Google Analytics.

Pour appeler manuellement une compétence dans les agents de codage IA compatibles, saisissez le caractère / dans le champ de saisie du chat, puis sélectionnez la compétence par son nom.

Composants principaux d'une compétence

Chaque compétence d'agent IA Google Analytics fournit à votre agent de codage IA les composants suivants :

  • Instructions spécialisées : instructions détaillées pour activer les API Google Analytics avec la gcloud CLI, configurer les identifiants par défaut de l'application (ADC), créer des requêtes runReport et vérifier la compatibilité des champs.
  • Bonnes pratiques : sélection de la version d'API recommandée (points de terminaison v1beta pour la stabilité générale et points de terminaison v1alpha pour les fonctionnalités de l'API Admin en accès anticipé), construction de requêtes fortement typées et workflows de validation de schéma.
  • Documentation de référence : guides d'installation des bibliothèques clientes spécifiques à un langage et exemples de code pour Python, Java, Node.js, PHP, Go, .NET et Ruby dans le répertoire references/ de chaque compétence.

Avantages des compétences des agents IA

Les compétences d'agent IA étendent votre agent de codage IA avec des connaissances spécialisées sur Google Analytics à la demande, sans charger de grands ensembles de documentation dans chaque conversation.

Réduction des coûts liés aux jetons

Le chargement initial de l'intégralité de la documentation de référence de l'API consomme des jetons de contexte et augmente les coûts de la session. Les compétences des agents IA utilisent la divulgation progressive pour minimiser l'utilisation du contexte :

  • Au démarrage, l'agent de codage IA ne lit que le nom et la description courte de chaque compétence pour vérifier si elle correspond à votre requête.
  • L'agent ne charge les instructions SKILL.md complètes et les fichiers de référence spécifiques au langage dans la fenêtre de contexte active que lorsque votre tâche l'exige.

Implémentation guidée par l'IA

Décrivez votre objectif en langage naturel. Les compétences installées guideront votre agent de codage IA dans les tâches d'implémentation de Google Analytics, telles que les suivantes :

  • Activer l'API Google Analytics Data dans mon projet et écrire un script Python qui interroge les métriques activeUsers et sessions par les dimensions city et date.
  • Vérifiez si la dimension itemName est compatible avec les métriques activeUsers et totalRevenue pour ma propriété Google Analytics à l'aide de la méthode checkCompatibility.
  • Répertoriez tous les récapitulatifs de compte Google Analytics et toutes les sous-propriétés accessibles dans Node.js à l'aide de l'API Google Analytics Admin.
  • Configurer des dimensions personnalisées, des flux de données et des secrets du protocole de mesure pour ma propriété Google Analytics

Utiliser des compétences avec le serveur MCP Google Analytics

Les compétences de l'agent IA Google Analytics complètent le serveur MCP (Model Context Protocol) Google Analytics :

  • Serveur MCP Google Analytics : connecte votre agent de codage IA directement aux propriétés Google Analytics actives afin qu'il puisse inspecter les récapitulatifs de compte, les détails des propriétés, les dimensions personnalisées, les métriques personnalisées et les rapports en temps réel.
  • Compétences de l'agent IA Google Analytics : fournissez des instructions et des références de bibliothèque cliente efficaces en termes de jetons qui guident votre agent de codage IA lors de l'activation des API , de la configuration de l'authentification ADC, de la vérification de la compatibilité des champs et de l'écriture du code d'application.

Compétences disponibles

Google gère les compétences d'agent IA Google Analytics suivantes dans le dépôt google/skills :

Compétence Description
google-analytics-data-api-basics Active l'API Google Analytics Data (analyticsdata.googleapis.com) avec la gcloud CLI, configure les ADC avec le champ d'application OAuth 2.0 analytics.readonly et installe les bibliothèques clientes v1beta officielles (Python, Java, PHP, Node.js, Go, .NET et Ruby). Guide votre agent dans la création de requêtes runReport et la vérification de la compatibilité des champs avec les méthodes getMetadata et checkCompatibility.
google-analytics-admin-api-basics Active l'API Google Analytics Admin (analyticsadmin.googleapis.com) avec la gcloud CLI, configure ADC avec les champs d'application OAuth 2.0 analytics.readonly et analytics.edit, et installe les bibliothèques clientes officielles v1beta et v1alpha (Python, Java, PHP, Node.js, Go, .NET et Ruby). Guide votre agent pour lister les récapitulatifs de compte et gérer les propriétés, les flux de données, les dimensions personnalisées, les métriques personnalisées, les événements clés, les secrets du protocole de mesure et les associations de produits.

Étapes suivantes