Competenze dell'agente API Google Ads

Le competenze dell'agente dell'API Google Ads sono moduli portatili e autonomi di conoscenze, istruzioni e workflow specifici dell'API Google Ads. Le skill dell'agente API Google Ads 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 Google Ads, configurare gli strumenti ed eseguire i workflow con una maggiore accuratezza e un costo inferiore in termini di token. Per un elenco delle skill disponibili, consulta Skill disponibili.

Inizia

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

Installa le skill dell'agente API Google Ads

Nella maggior parte dei casi, le competenze dell'agente API Google Ads possono essere installate nell'editor che preferisci con un singolo comando:

Antigravity

Le competenze dell'agente API Google Ads sono incluse come uno dei bundle di integrazione Build with Google per Antigravity. Puoi attivare questo bundle per l'accesso a livello globale in due punti:

  • Durante l'onboarding: seleziona la casella di controllo per lo stack dell'API Google Ads.
  • In Impostazioni:
    1. Vai a Impostazioni > Personalizzazioni.
    2. In Build with Google Plugins, fai clic su Personalizza, quindi su Scarica per l'integrazione dell'API Google Ads.

Se preferisci l'accesso a livello di progetto, 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 le skill dell'agente API Google Ads 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 (richiede Node.js):

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 (richiede Node.js):

npx skills add google/skills/skills/ads

Aggiorna le skill dell'agente API Google Ads

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

Antigravity

Le integrazioni attivate tramite Build with Google vengono gestite e aggiornate automaticamente dall'editor.

Se hai installato le skill dell'agente utilizzando il comando npx, puoi ottenere tutti gli aggiornamenti disponibili eseguendo il comando update:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Cursore 

npx skills update --all

Altri agenti

Per altri assistenti AI che supportano lo standard aperto Agent Skills, puoi aggiornare tutte le skill attive utilizzando npx:

npx skills update --all

Utilizza le skill dell'agente API Google Ads

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 Google Ads.

Le skill possono anche essere richiamate manualmente digitando / nella chat dell'agente e cercando il nome della skill.

Componenti principali di una skill

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

  • Istruzioni specializzate: istruzioni dettagliate del prompt inserite nella finestra di contesto per guidare l'assistente nella generazione di query GAQL, nella configurazione delle credenziali OAuth e nella gestione dei codici di errore comuni.
  • Best practice: consigli standard su prestazioni, sicurezza e integrazione definiti dal team DevRel dell'API Google Ads.
  • Script di automazione: script eseguibili (ad esempio per la convalida dell'ambiente o la configurazione dello spazio di lavoro) inclusi nei pacchetti di competenze per eseguire attività localmente.

Vantaggi dell'utilizzo delle skill

Le skill dell'agente 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 nell'esecuzione di attività come le seguenti:

  • Genera una query GAQL per recuperare le metriche sul rendimento della campagna dal mio account.
  • Scrivi uno script Python utilizzando le librerie client per creare una nuova campagna.
  • Recupera le conversioni della campagna e i dati diagnostici utilizzando l'API Google Ads.

Per un elenco completo delle competenze disponibili, consulta Competenze disponibili.

Utilizza le skill insieme al server MCP dell'API Google Ads

Le competenze degli agenti sono progettate per integrare il server Model Context Protocol (MCP) dell'API Google Ads:

  • Server MCP dell'API Google Ads: progettato per i workflow di sviluppo assistito dall'AI, consente agli assistenti AI di interagire in modo programmatico con le risorse, le campagne e le metriche dell'API Google Ads.
  • Skill dell'agente API Google Ads: fornisci istruzioni per i prompt e best practice consigliate che guidano un assistente a eseguire attività tramite la divulgazione progressiva efficiente dei token. Forniscono all'agente istruzioni su come utilizzare in modo efficace strumenti come il server MCP e le librerie client.

Skill disponibili

Il team dell'API Google Ads fornisce una suite di competenze per lo sviluppo con l'API Google Ads:

Competenza Descrizione
google-ads-api-account-diagnostics Diagnostica i problemi di prestazioni dell'account Google Ads, come la perdita di conversioni, il basso volume di lead e la quota impressioni perse a causa del ranking dell'annuncio, delle offerte o dei budget, utilizzando il server MCP dell'API Google Ads.
google-ads-api-mcp-setup Ti aiuta a configurare il server Model Context Protocol (MCP) dell'API Google Ads, semplificando l'autenticazione e la configurazione negli ambienti locali.
google-ads-api-quickstart Ti guida nella configurazione dell'ambiente di sviluppo, nella configurazione delle credenziali e nella prima chiamata API all'API Google Ads.

Passaggi successivi