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.
Elles 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 de l'installation de la bibliothèque cliente et des étapes d'authentification 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. |
Commencer
Installez les compétences d'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 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 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 de 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 d'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 d'agent de l'API Data Manager
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 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 la liste des compétences installées.
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 : 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 API Data Manager.
- Documentation de référence : guides de configuration des bibliothèques clientes, 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 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 vous aider à effectuer des tâches liées à l'API Data Manager, telles que 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 requête 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.