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

Les compétences d'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 agentiques de l'API Google Ads fonctionnent avec les assistants IA compatibles avec la norme ouverte Agent Skills, y compris Google Antigravity et Claude Code.

Ces compétences d'agent 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 la section Compétences disponibles.

Premiers pas

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 d'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 mondial à 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 à Settings > Customizations (Paramètres > Personnalisations).
    2. Sous Build with Google Plugins (Plug-ins Build with Google), cliquez sur Customize (Personnaliser), puis cliquez sur Download (Télécharger) 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 --agent=antigravity

Claude Code 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Codex 

npx skills add google/skills

Cursor

Vous pouvez installer directement les compétences d'agent de l'API Google Ads 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 les règles personnalisées. Pour en savoir plus, consultez la documentation sur les règles de 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 :

npx skills add google/skills

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

Vous pouvez obtenir toutes les mises à jour disponibles et supprimer 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é des compétences d'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 

claude plugin update google-ads@skills

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 les 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 globalement restent inactives dans les projets non liés, sauf si le contexte de votre prompt correspond aux tâches de l'API Google Ads.

Vous pouvez également appeler manuellement des compétences 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 détaillées inséré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 capacités d'un assistant avec des connaissances spécialisées à la demande, sans avoir à charger des instructions volumineuses dans chaque conversation.

Coûts en jetons réduits

Les intégrations d'IA classiques chargent souvent de grandes quantités de documentation à l'avance, ce qui consomme un nombre important de jetons et augmente les coûts de session. Les compétences d'agent 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 pour 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 parcourir manuellement 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érer une requête GAQL pour récupérer les métriques de performances de la campagne à partir de mon compte.
  • Écrire un script Python à l'aide de bibliothèques clientes pour créer une campagne.
  • Récupérer les conversions de campagne et les données de diagnostic à l'aide de l'API Google Ads.

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

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

Les compétences d'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, permettant aux assistants IA d'interagir de manière programmatique avec vos ressources de l'API Google Ads, campagnes et métriques.
  • Compétences d'agent de l'API Google Ads : fournissent des instructions et des pratiques recommandées qui guident un assistant pour effectuer des tâches grâce à 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 fournit une suite de compétences pour créer des applications avec l'API Google Ads :

Compétence Description
google-ads-api-mcp-setup Aide à la configuration du 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 dans la configuration de votre environnement de développement, la configuration des identifiants et le premier appel d'API à l'API Google Ads.

Étapes suivantes