Competenze dell'agente API Data Manager

Le skill dell'agente dell'API Data Manager sono moduli portatili e autonomi di conoscenze, istruzioni e workflow specifici dell'API Data Manager. Le skill dell'agente API Data Manager funzionano con gli assistenti AI che supportano lo standard aperto Agent Skills, tra cui Google Antigravity e Claude Code.

Queste skill dell'agente sono progettate per aiutare gli assistenti AI a comprendere le best practice dell'API Data Manager, configurare gli strumenti ed eseguire i workflow con una maggiore accuratezza e un costo inferiore in termini di token

Skill disponibili

Il team dell'API Data Manager fornisce una suite di competenze per la creazione con l'API Data Manager:

Competenza Descrizione
data-manager-api-setup Guida gli sviluppatori nei passaggi di installazione e autenticazione della libreria client per la configurazione dell'API Data Manager.
data-manager-api-event-ingestion Ti aiuta a implementare l'importazione di eventi e conversioni per i prodotti Google utilizzando l'API Data Manager.
data-manager-api-audience-ingestion Aiuta a creare elenchi di utenti e a gestire i dati dei segmenti di pubblico utilizzando l'API Data Manager per casi d'uso come Customer Match.

Inizia

Installa le skill dell'agente appropriate per il tuo ambiente di sviluppo.

Installa le competenze dell'agente API Data Manager

Nella maggior parte dei casi, le competenze dell'agente API Data Manager possono essere installate nel tuo editor preferito con un singolo comando:

Antigravity

Esegui questo comando nella directory del progetto:

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

Cursore

Puoi installare gli agent skill dell'API Data Manager direttamente aggiungendo l'endpoint del repository GitHub dello skill (ad esempio https://github.com/google/skills) nelle impostazioni dell'editor in Regole personalizzate. Per maggiori dettagli, consulta la documentazione di Cursor sull'installazione delle skill da GitHub.

Puoi anche installare le skill utilizzando NPX:

npx skills add google/skills/skills/ads --agent=cursor

Altri agenti

Per altri assistenti AI che supportano lo standard aperto Agent Skills, puoi installare le skill utilizzando NPX:

npx skills add google/skills/skills/ads

Aggiorna le skill dell'agente API Data Manager

Puoi ottenere tutti gli aggiornamenti disponibili e ripulire le competenze obsolete eseguendo il comando update:

npx skills update --all

Utilizza le skill dell'agente relative all'API Data Manager

Gli assistenti AI sono progettati per utilizzare le skill automaticamente ogni volta che rilevano che la descrizione di una skill corrisponde alla tua richiesta attuale. Le skill installate a livello globale rimangono inattive nei progetti non correlati, a meno che il contesto del prompt non corrisponda alle attività dell'API Data Manager.

Le skill possono anche essere richiamate manualmente nella chat dell'agente. Per molti agenti, puoi utilizzare il tasto / per aprire un elenco delle skill installate.

Componenti principali di una skill

Ogni skill dell'agente è un pacchetto specializzato che fornisce all'assistente AI i seguenti componenti:

  • Istruzioni specializzate: indicazioni dettagliate per l'assistente AI su come eseguire attività specifiche, come la configurazione dell'accesso all'API, la formattazione e l'hashing dei dati utente e l'implementazione dei workflow di importazione.
  • Best practice: consigli per l'integrazione standard definiti dal team dell'API Data Manager.
  • Documentazione di riferimento: guide alla configurazione delle librerie client, mappature dei campi di migrazione ed esempi di codice inclusi nelle competenze per fornire all'assistente riferimenti accurati e aggiornati.

Vantaggi dell'utilizzo delle skill

Le skill degli agenti estendono le funzionalità di un assistente con conoscenze specializzate on demand, senza l'overhead di caricare istruzioni ingombranti in ogni conversazione.

Costi dei token ridotti

Le integrazioni di AI convenzionali spesso caricano enormi quantità di documentazione in anticipo, il che consuma un numero significativo di token e aumenta i costi delle sessioni. Le skill degli agenti utilizzano la divulgazione progressiva per ridurre al minimo questo overhead:

  • Inizialmente, l'assistente AI controlla solo il nome e la descrizione della skill per verificare se è pertinente alla tua richiesta.
  • Le istruzioni e i riferimenti completi della skill vengono aggiunti alla finestra di contesto attiva solo quando l'assistente stabilisce che sono necessari per la tua attività specifica, risparmiando spazio nel contesto.

Implementazione guidata dall'AI

Anziché cercare manualmente nella documentazione, puoi descrivere il tuo intento in linguaggio naturale. Le skill guidano l'assistente AI per aiutarti con le attività dell'API Data Manager, ad esempio:

  • Scrivi uno script Python per importare le conversioni offline di Google Ads utilizzando l'API Data Manager.
  • Esegui la migrazione di questo codice Google Ads OfflineUserDataJobService per Customer Match all'API Data Manager.
  • Come faccio a recuperare lo stato di elaborazione di una richiesta di importazione di eventi dell'API Data Manager?

Passaggi successivi

Indietro
Installare una libreria client