Skill dell'agente AI di Google Analytics

Per creare integrazioni di report e gestione delle proprietà di Google Analytics con una maggiore precisione e un overhead dei token inferiore, dota il tuo agente di programmazione AI delle competenze dell'agente AI di Google Analytics. Progettate per gli sviluppatori che creano con l'API Google Analytics Data e l'API Google Analytics Admin, le skill dell'agente AI di Google Analytics sono moduli portatili e autonomi di istruzioni, workflow e riferimenti alle librerie client.

Queste skill degli agenti AI funzionano con gli agenti di programmazione AI che supportano lo standard aperto Agent Skills, tra cui Google Antigravity, Claude Code, Codex e Cursor. Per un elenco delle skill pubblicate, consulta Skill disponibili.

Prima di iniziare

Prima di installare ed eseguire gli skill dell'agente AI di Google Analytics, completa i seguenti prerequisiti:

  • Installa un agente di programmazione AI che supporti lo standard aperto Agent Skills, come Google Antigravity, Claude Code, Codex o Cursor.
  • Installa Node.js, che include il comando npx per l'installazione e l'aggiornamento delle skill dalla riga di comando.
  • Crea o seleziona un progetto con accesso a una proprietà Google Analytics durante l'esecuzione dei workflow dell'API.

Inizia

Installa, aggiorna e richiama le skill dell'agente AI di Google Analytics nel tuo ambiente di sviluppo.

Installa le skill dell'agente AI di Google Analytics

Installa la suite di competenze di Google Analytics nella directory del progetto utilizzando il comando npx o configura direttamente l'editor:

Antigravity

Esegui questo comando nella directory del progetto:

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

Esegui questo comando nella directory del progetto:

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

Esegui questo comando nella directory del progetto:

npx skills add google/skills/skills/analytics --agent=codex

Cursore

Aggiungi l'URL del repository delle skill (https://github.com/google/skills) nelle impostazioni dell'editor in Regole personalizzate. Per istruzioni, consulta la documentazione di Cursor sull'installazione delle skill da GitHub.

In alternativa, installa le skill nella directory del progetto utilizzando il comando npx:

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

Altri agenti

Per altri agenti di programmazione AI che supportano lo standard aperto Agent Skills, esegui questo comando nella directory del progetto:

npx skills add google/skills/skills/analytics

Aggiorna le skill dell'agente AI di Google Analytics

Scarica gli aggiornamenti disponibili e ripulisci le competenze obsolete eseguendo il seguente comando:

npx skills update --all

Utilizza le skill dell'agente AI di Google Analytics

Gli agenti di programmazione AI caricano automaticamente le skill quando rilevano che la descrizione di una skill corrisponde al tuo prompt. Le skill installate a livello globale rimangono inattive nei progetti non correlati, a meno che la tua richiesta non riguardi attività di Google Analytics.

Per richiamare manualmente una skill negli agenti di programmazione AI supportati, inserisci il carattere / nell'input della chat e seleziona la skill per nome.

Componenti principali di una skill

Ogni skill dell'agente AI di Google Analytics fornisce all'agente di programmazione AI i seguenti componenti:

  • Istruzioni specializzate: indicazioni passo passo per attivare le API Google Analytics con gcloud CLI, configurare le Credenziali predefinite dell'applicazione (ADC), creare query runReport e verificare la compatibilità dei campi.
  • Best practice: selezione della versione dell'API consigliata (endpoint v1beta per la stabilità generale ed endpoint v1alpha per le funzionalità dell'API Admin con accesso in anteprima), costruzione di richieste con tipizzazione forte e workflow di convalida dello schema.
  • Documentazione di riferimento: guide all'installazione delle librerie client specifiche per i linguaggi ed esempi di codice per Python, Java, Node.js, PHP, Go, .NET e Ruby nella directory references/ di ogni skill.

Vantaggi delle skill degli agenti AI

Le skill dell'agente AI estendono l'agente di programmazione AI con conoscenze specializzate di Google Analytics on demand, senza caricare grandi set di documentazione in ogni conversazione.

Costi dei token ridotti

Il caricamento anticipato della documentazione di riferimento dell'API completa consuma token di contesto e aumenta i costi della sessione. Le skill degli agenti AI utilizzano la divulgazione progressiva per ridurre al minimo l'utilizzo del contesto:

  • All'avvio, l'agente di programmazione AI legge solo il nome e la breve descrizione di ogni skill per verificare se corrisponde al tuo prompt.
  • L'agente carica le istruzioni complete di SKILL.md e i file di riferimento specifici per la lingua nella finestra di contesto attiva solo quando l'attività lo richiede.

Implementazione guidata dall'AI

Descrivi il tuo obiettivo in linguaggio naturale e le skill installate guideranno l'agente di programmazione AI attraverso le attività di implementazione di Google Analytics, ad esempio:

  • Attiva l'API Google Analytics Data nel mio progetto e scrivi uno script Python che esegua query sulle metriche activeUsers e sessions in base alle dimensioni city e date.
  • Verifica se la dimensione itemName è compatibile con le metriche activeUsers e totalRevenue per la mia proprietà Google Analytics utilizzando il metodo checkCompatibility.
  • Elenca tutti i riepiloghi degli account Google Analytics e le proprietà secondarie accessibili in Node.js utilizzando l'API Google Analytics Admin.
  • Configura dimensioni personalizzate, stream di dati e secret di Measurement Protocol per la mia proprietà Google Analytics.

Utilizza le skill insieme al server MCP di Google Analytics

Le skill dell'agente AI di Google Analytics integrano il server Model Context Protocol (MCP) di Google Analytics:

  • Server MCP di Google Analytics: collega l'agente di programmazione AI direttamente alle proprietà Google Analytics attive, in modo che possa esaminare i riepiloghi degli account, i dettagli delle proprietà, le dimensioni personalizzate, le metriche personalizzate e i report in tempo reale.
  • Competenze dell'agente AI di Google Analytics: fornisci istruzioni efficienti in termini di token e riferimenti alla libreria client che guidano l'agente di programmazione AI durante l'attivazione delle API , la configurazione dell'autenticazione ADC, il controllo della compatibilità dei campi e la scrittura del codice dell'applicazione.

Skill disponibili

Google gestisce le seguenti skill dell'agente AI di Google Analytics nel repository google/skills:

Competenza Descrizione
google-analytics-data-api-basics Attiva l'API Google Analytics Data (analyticsdata.googleapis.com) con gcloud CLI, configura ADC con l'ambito OAuth 2.0 analytics.readonly e installa le librerie client v1beta ufficiali (Python, Java, PHP, Node.js, Go, .NET e Ruby). Guida l'agente nella creazione di query runReport e nella verifica della compatibilità dei campi con i metodi getMetadata e checkCompatibility.
google-analytics-admin-api-basics Abilita l'API Google Analytics Admin (analyticsadmin.googleapis.com) con gcloud CLI, configura ADC con gli ambiti OAuth 2.0 analytics.readonly e analytics.edit e installa le librerie client ufficiali v1beta e v1alpha (Python, Java, PHP, Node.js, Go, .NET e Ruby). Guida l'agente nella visualizzazione dei riepiloghi degli account e nella gestione di proprietà, stream di dati, dimensioni personalizzate, metriche personalizzate, eventi chiave, secret di Measurement Protocol e collegamenti ai prodotti.

Passaggi successivi