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

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 plus faible. 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 d'agent de l'API Google Ads peuvent être installées dans votre éditeur préféré à l'aide d'une seule commande :

Antigravity

Les compétences d'agent de l'API Google Ads sont incluses dans l'un des packs d'intégration Créer avec Google pour Antigravity. Vous pouvez activer ce bundle pour un accès au niveau mondial à deux moments :

  • Lors de l'intégration : cochez la case de la pile de l'API Google Ads.
  • Dans les paramètres :
    1. Accédez à Paramètres > Personnalisations.
    2. Sous Build with Google Plugins (Créer avec les plug-ins Google), cliquez sur Customize (Personnaliser), puis 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 "Règles personnalisées". Pour en savoir plus, consultez la documentation sur les règles de curseur.

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

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 Créer avec 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 skills chaque fois qu'ils détectent que la description d'un skill correspond à votre requête actuelle. Les compétences installées globalement restent inactives dans les projets sans rapport, sauf si le contexte de votre requête correspond aux tâches de l'API Google Ads.

Les compétences peuvent également être invoqué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 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 termes 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 en local.

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 des jetons réduits

Les intégrations d'IA conventionnelles 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 de l'agent utilisent la divulgation progressive pour minimiser cette surcharge :

  • L'assistant IA vérifie d'abord le nom et la description de la compétence pour voir si elle correspond à votre demande.
  • Les instructions et les références complètes de la skill 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 permettent à votre assistant IA d'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 des 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 skills 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, 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 d'agent de l'API Google Ads : fournissent des instructions rapides et des bonnes pratiques 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 propose un ensemble de compétences pour créer des applications avec l'API Google Ads :

Compétence Description
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 à l'API Google Ads.

Étapes suivantes