Compétences de l'agent de l'API Data Manager

Les compétences d'agent de l'API Data Manager sont des modules portables et autonomes de connaissances, d'instructions et de workflows spécifiques à l'API Data Manager. Les compétences de l'API Data Manager 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 Data Manager, à configurer des outils et à exécuter des workflows avec une plus grande précision et un coût en jetons inférieur.

Compétences disponibles

L'équipe de l'API Data Manager fournit une suite de compétences pour créer des applications avec l'API Data Manager :

Compétence Description
data-manager-api-setup Guide les développeurs tout au long des étapes d'installation et d'authentification de la bibliothèque cliente pour configurer l'API Data Manager.
data-manager-api-event-ingestion Aide à implémenter l'ingestion d'événements et de conversions pour les produits Google à l'aide de l'API Data Manager.
data-manager-api-audience-ingestion Aide à créer des listes d'utilisateurs et à gérer les données d'audience à l'aide de l'API Data Manager pour des cas d'utilisation tels que le ciblage par liste de clients.

Premiers pas

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

Installer les compétences d'agent de l'API Data Manager

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

Antigravity

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 directement les compétences d'agent de l'API Data Manager 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 à partir de GitHub.

Vous pouvez également installer les compétences à l'aide de NPX :

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 :

npx skills add google/skills/skills/ads

Mettre à jour les compétences d'agent de l'API Data Manager

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

npx skills update --all

Utiliser les compétences d'agent de l'API Data Manager

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

Les compétences peuvent également être appelées manuellement dans le chat de l'agent. Pour de nombreux agents, vous pouvez utiliser la touche / pour ouvrir une liste des compétences installées.

Composants principaux d'une compétence

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

  • Instructions spécialisées : conseils détaillés pour votre assistant IA sur la façon d’effectuer des tâches spécifiques, telles que la configuration de l’accès à l’API, la mise en forme et le hachage des données utilisateur, et l’implémentation de workflows d’ingestion.
  • Bonnes pratiques : recommandations d'intégration standards définies par l'équipe de l'API Data Manager.
  • Documentation de référence : guides de configuration de la bibliothèque cliente, mappages de champs de migration et exemples de code inclus dans les compétences pour fournir à l'assistant des références précises et à jour.

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 vous aider à effectuer des tâches liées à l'API Data Manager, telles que les suivantes :

  • Écrire un script Python pour ingérer des conversions hors connexion Google Ads à l'aide de l'API Data Manager.
  • Migrer ce code Google Ads OfflineUserDataJobService pour le ciblage par liste de clients vers l'API Data Manager.
  • Comment récupérer l'état de traitement d'une requête d'ingestion d'événements de l'API Data Manager ?

Étapes suivantes