Competenze dell'agente API Data Manager

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

Queste skill degli agenti 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.

Competenze 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 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 utenti e a gestire i dati sui segmenti di pubblico utilizzando l'API Data Manager per casi d'uso come Customer Match.

Inizia

Installa le competenze degli agenti appropriate per il tuo ambiente di sviluppo.

Installare le competenze degli agenti dell'API Data Manager

Nella maggior parte dei casi, le competenze degli agenti dell'API Data Manager possono essere installate nell'editor preferito con un singolo comando:

Antigravity

Esegui il seguente 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 le competenze degli agenti dell'API Data Manager direttamente aggiungendo l'endpoint del repository GitHub della competenza (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 competenze da GitHub.

Puoi anche installare le competenze 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 competenze utilizzando NPX:

npx skills add google/skills/skills/ads

Aggiornare le competenze degli agenti dell'API Data Manager

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

npx skills update --all

Utilizzare le competenze degli agenti dell'API Data Manager

Gli assistenti AI sono progettati per utilizzare automaticamente le competenze ogni volta che rilevano che la descrizione di una competenza corrisponde alla tua richiesta attuale. Le competenze 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 competenze possono anche essere richiamate manualmente nella chat dell'agente. Per molti agenti, puoi utilizzare il tasto / per aprire un elenco di competenze installate.

Componenti principali di una competenza

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 eseguire attività specifiche, come la configurazione dell'accesso API, la formattazione e l 'hashing dei dati utente e l'implementazione dei 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 competenze per fornire all'assistente riferimenti accurati e aggiornati.

Vantaggi dell'utilizzo delle competenze

Le competenze degli agenti estendono le funzionalità di un assistente con conoscenze specializzate on demand senza il sovraccarico di caricare istruzioni ingombranti in ogni conversazione.

Costi dei token ridotti

Le integrazioni AI convenzionali spesso caricano in anticipo enormi quantità di documentazione, che consumano token significativi e aumentano i costi della sessione. Le competenze degli agenti utilizzano la divulgazione progressiva per ridurre al minimo questo sovraccarico:

  • L'assistente AI inizialmente controlla solo il nome e la descrizione della competenza per verificare 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 l'attività specifica, risparmiando spazio di 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

Indietro
Installare una libreria client