Compétences de l'agent de l'API Google Ads

Les compétences de l'agent de l'API Google Ads sont des modules portables et autonomes de connaissances, d'instructions et de workflows spécifiques à l'API Google Ads. Les compétences d'agent de l'API Google Ads fonctionnent avec les assistants IA compatibles avec la norme ouverte Agent Skills, y compris Google Antigravity et Claude Code.

Elles sont conçues pour aider les assistants IA à comprendre les bonnes pratiques de l'API Google Ads, à configurer des outils et à exécuter des workflows avec une plus grande précision et un coût en jetons inférieur. Pour obtenir la liste des compétences disponibles, consultez Compétences disponibles.

Commencer

Installez les compétences d'agent adaptées à votre environnement de développement.

Installer les compétences d'agent de l'API Google Ads

Dans la plupart des cas, les compétences de l'agent de l'API Google Ads peuvent être installées dans l'éditeur de votre choix à l'aide d'une seule commande :

Antigravity

Les compétences d'agent de l'API Google Ads sont incluses dans l'un des bundles d'intégration Build with Google pour Antigravity. Vous pouvez activer ce bundle pour un accès au niveau global à deux endroits :

  • Lors de l'intégration : cochez la case correspondant à la pile de l'API Google Ads.
  • Dans les paramètres :
    1. Accédez à Paramètres > Personnalisations.
    2. Sous Build with Google Plugins, cliquez sur Customize, puis sur Download pour l'intégration de l'API Google Ads.

Si vous préférez un accès au niveau du projet, exécutez la commande suivante dans le répertoire de votre projet :

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

Claude Code 

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

Codex 

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

Cursor

Vous pouvez installer les compétences de l'agent de l'API Google Ads directement en ajoutant le point de terminaison du dépôt GitHub de la compétence (par exemple, https://github.com/google/skills) dans les paramètres de votre éditeur sous "Règles personnalisées". Pour en savoir plus, consultez la documentation de Cursor sur l'installation de compétences depuis GitHub.

Vous pouvez également installer les compétences à l'aide de npx (nécessite Node.js) :

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

Autres agents

Pour les autres assistants IA compatibles avec la norme ouverte Agent Skills, vous pouvez installer les compétences à l'aide de npx (nécessite Node.js) :

npx skills add google/skills/skills/ads

Mettre à jour les compétences d'agent de l'API Google Ads

Vous pouvez obtenir toutes les mises à jour disponibles et nettoyer les compétences obsolètes en exécutant la commande update :

Antigravity

Les intégrations activées via Build with Google sont gérées et mises à jour automatiquement par l'éditeur.

Si vous avez installé les compétences de l'agent à l'aide de la commande npx, vous pouvez obtenir toutes les mises à jour disponibles en exécutant la commande update :

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Cursor 

npx skills update --all

Autres agents

Pour les autres assistants IA compatibles avec la norme ouverte Agent Skills, vous pouvez mettre à jour toutes les compétences actives à l'aide de npx :

npx skills update --all

Utiliser les compétences d'agent de l'API Google Ads

Les assistants IA sont conçus pour utiliser automatiquement des compétences chaque fois qu'ils détectent que la description d'une compétence correspond à votre requête actuelle. Les compétences installées de manière globale restent inactives dans les projets non liés, sauf si le contexte de votre requête correspond à des tâches de l'API Google Ads.

Les compétences peuvent également être appelées manuellement en saisissant / dans le chat de l'agent et en recherchant le nom de la compétence.

Composants principaux d'une compétence

Chaque compétence d'agent est un package spécialisé qui fournit à l'assistant IA les composants suivants :

  • Instructions spécialisées : instructions de prompt détaillées injectées dans la fenêtre de contexte pour guider l'assistant dans la génération de requêtes GAQL, la configuration des identifiants OAuth et la gestion des codes d'erreur courants.
  • Bonnes pratiques : recommandations standards en matière de performances, de sécurité et d'intégration définies par l'équipe DevRel de l'API Google Ads.
  • Scripts d'automatisation : scripts exécutables (par exemple, pour la validation de l'environnement ou la configuration de l'espace de travail) inclus dans les packages de compétences pour exécuter des tâches localement.

Avantages de l'utilisation des compétences

Les compétences d'agent étendent les fonctionnalités d'un assistant grâce à des connaissances spécialisées à la demande, sans avoir à charger des instructions volumineuses dans chaque conversation.

Réduction des coûts des jetons

Les intégrations d'IA conventionnelles chargent souvent d'énormes quantités de documentation au préalable, ce qui consomme beaucoup de jetons et augmente les coûts de session. Les compétences agentiques utilisent la divulgation progressive pour minimiser cette surcharge :

  • L'assistant IA ne vérifie initialement que le nom et la description de la compétence pour voir si elle est pertinente par rapport à votre requête.
  • Les instructions et références complètes de la compétence ne sont ajoutées à la fenêtre de contexte active que lorsque l'assistant détermine qu'elles sont nécessaires pour votre tâche spécifique, ce qui permet d'économiser de l'espace de contexte.

Implémentation guidée par l'IA

Au lieu de rechercher manuellement dans la documentation, vous pouvez décrire votre intention en langage naturel. Les compétences guident votre assistant IA pour effectuer des tâches telles que les suivantes :

  • Génère une requête GAQL pour récupérer les métriques de performances des campagnes de mon compte.
  • Écrivez un script Python à l'aide de bibliothèques clientes pour créer une campagne.
  • Récupérez les conversions de vos campagnes et les données de diagnostic à l'aide de l'API Google Ads.

Pour obtenir la liste complète des compétences disponibles, consultez Compétences disponibles.

Utiliser des compétences avec le serveur MCP de l'API Google Ads

Les compétences de l'agent sont conçues pour compléter le serveur MCP (Model Context Protocol) de l'API Google Ads :

  • Serveur MCP de l'API Google Ads : conçu pour les workflows de développement assistés par l'IA, il permet aux assistants IA d'interagir de manière programmatique avec vos ressources, campagnes et métriques de l'API Google Ads.
  • Compétences de l'agent de l'API Google Ads : fournissez des instructions de prompt et des pratiques recommandées qui guident un assistant pour effectuer des tâches via une divulgation progressive efficace en termes de jetons. Elles indiquent à l'agent comment utiliser efficacement des outils tels que le serveur MCP et les bibliothèques clientes.

Compétences disponibles

L'équipe de l'API Google Ads propose une suite de compétences pour créer des applications avec l'API Google Ads :

Compétence Description
google-ads-api-account-diagnostics Diagnostique les problèmes de performances d'un compte Google Ads, tels que la perte de conversions, le faible volume de prospects et le taux d'impressions perdues en raison du classement de l'annonce, des enchères ou des budgets, à l'aide du serveur MCP de l'API Google Ads.
google-ads-api-mcp-setup Aide à configurer le serveur MCP (Model Context Protocol) de l'API Google Ads, ce qui simplifie l'authentification et la configuration dans les environnements locaux.
google-ads-api-quickstart Vous guide pour configurer votre environnement de développement, configurer les identifiants et effectuer votre premier appel d'API vers l'API Google Ads.

Étapes suivantes