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'agent 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 plus faible.
Compétences disponibles
L'équipe de l'API Data Manager propose un ensemble de compétences pour créer des applications avec l'API Data Manager :
| Compétence | Description |
|---|---|
data-manager-api-setup |
Guide les développeurs dans les étapes d'installation et d'authentification des bibliothèques clientes 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 |
Vous 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. |
Commencer
Installez les compétences de l'agent adaptées à votre environnement de développement.
Installer les compétences de l'agent de l'API Data Manager
Dans la plupart des cas, les compétences de l'agent de l'API Data Manager peuvent être installées dans votre éditeur préféré à 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 les compétences de l'agent de l'API Data Manager 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 Cursor sur l'installation de compétences depuis 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 de l'agent de l'API Data Manager
Vous pouvez obtenir toutes les mises à jour disponibles et nettoyer les compétences obsolètes en exécutant la commande update :
npx skills update --all
Utiliser les compétences de l'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 associés, sauf si le contexte de votre requête correspond aux tâches de l'API Data Manager.
Les compétences peuvent également être invoquées manuellement dans le chat de l'agent. Pour de nombreux agents, vous pouvez utiliser la touche / pour ouvrir la liste des skills installées.
Composants de base 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 : conseils détaillés pour votre assistant IA sur la façon d'effectuer des tâches spécifiques, comme configurer l'accès à l'API, mettre en forme et hacher les données utilisateur, et implémenter des 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 des bibliothèques clientes, mappages des champs de migration et exemples de code inclus dans les skills pour fournir à l'assistant des références précises et à jour.
Avantages de l'utilisation des compétences
Les compétences agentiques é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 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 guident votre assistant IA pour vous aider à effectuer des tâches liées à l'API Data Manager, comme les suivantes :
- Écrivez un script Python pour ingérer les conversions hors connexion Google Ads à l'aide de l'API Data Manager.
- Migrez ce code
OfflineUserDataJobServiceGoogle Ads pour le ciblage par liste de clients vers l'API Data Manager. - Comment récupérer l'état de traitement d'une demande d'ingestion d'événements de l'API Data Manager ?
Étapes suivantes
- Découvrez comment utiliser les compétences d'agent avec Antigravity.
- Découvrez comment utiliser les compétences d'agent avec Claude Code.