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 competenze dell'agente API Data Manager funzionano con gli assistenti AI che supportano lo standard aperto per le competenze dell'agente, 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 maggiore accuratezza e costi dei token inferiori.

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 attraverso i passaggi di installazione e autenticazione della libreria client per la configurazione dell'API Data Manager.
data-manager-api-event-ingestion Aiuta a implementare l'importazione di eventi e conversioni per i prodotti Google utilizzando l'API Data Manager.
data-manager-api-audience-ingestion Consente di creare elenchi di utenti e 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 skill dell'agente API Data Manager

Nella maggior parte dei casi, le skill dell'agente dell'API Data Manager possono essere installate nell'editor che preferisci con un unico comando:

Antigravity

Esegui questo comando nella directory del tuo 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 le skill dell'agente dell'API Data Manager direttamente aggiungendo l'endpoint del repository GitHub della 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 competenze dell'agente API Data Manager

Puoi ottenere tutti gli aggiornamenti disponibili ed eliminare le skill obsolete eseguendo il comando update:

npx skills update --all

Utilizzare le skill dell'agente dell'API Data Manager

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

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

Componenti principali di un'abilità

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

  • Istruzioni specializzate: indicazioni dettagliate per l'assistente AI su come svolgere attività specifiche, come configurare l'accesso API, formattare e hashing dei dati utente e implementare flussi di lavoro di importazione.
  • Best practice: consigli di integrazione standard definiti dal team dell'API Data Manager.
  • Documentazione di riferimento: guide alla configurazione della libreria client, mappature dei campi di migrazione ed esempi di codice inclusi nelle skill per fornire all'assistente riferimenti accurati e aggiornati.

Vantaggi dell'utilizzo delle competenze

Le skill dell'agente estendono le funzionalità di un assistente con conoscenze specializzate su richiesta, senza l'overhead di caricare istruzioni ingombranti in ogni conversazione.

Costi dei token ridotti

Le integrazioni di AI convenzionali spesso caricano in anticipo enormi quantità di documentazione, il che consuma un numero significativo di token e aumenta i costi della sessione. Le competenze dell'agente utilizzano la divulgazione progressiva per ridurre al minimo questo sovraccarico:

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

Implementazione guidata dall'AI

Anziché cercare manualmente nella documentazione, puoi descrivere la tua intenzione in linguaggio naturale. Le competenze 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 OfflineUserDataJobService di Google Ads 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