Competenze dell'agente API Google Ads

Le skill dell'agente dell'API Google Ads sono moduli portabili e autonomi di conoscenze, istruzioni e workflow specifici dell'API Google Ads. Le skill dell'agente dell'API Google Ads funzionano con gli assistenti AI che supportano lo standard open 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 maggiore accuratezza e costi dei token inferiori. Per un elenco delle skill disponibili, consulta Skill disponibili.

Inizia

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

Installare le skill dell'agente dell'API Google Ads

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

Antigravity

Le skill dell'agente dell'API Google Ads sono incluse in uno dei pacchetti di integrazione Crea con 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. Nella sezione Crea con i plug-in Google, fai clic su Personalizza, poi 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 --agent=antigravity

Claude Code 

claude plugin marketplace add google/skills
claude plugin install google-ads@skills

Codex 

npx skills add google/skills

Cursore

Puoi installare le skill dell'agente dell'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 sulle regole del cursore.

Altri agenti

Per altri assistenti AI che supportano lo standard aperto Agent Skills, puoi installare le competenze utilizzando npx (richiede Node.js):

npx skills add google/skills

Aggiornare le skill dell'agente dell'API Google Ads

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

Antigravity

Le integrazioni attivate tramite Crea con 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 

claude plugin update google-ads@skills

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

Utilizzare le skill dell'agente dell'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 in progetti non correlati, a meno che il contesto del prompt non corrisponda alle attività dell'API Google Ads.

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

Componenti principali di un'abilità

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

  • Istruzioni specializzate: istruzioni dettagliate del prompt inserite nella finestra contestuale 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 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 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 skill disponibili, consulta Skill disponibili.

Utilizzare le competenze insieme al server MCP dell'API Google Ads

Le skill dell'agente sono progettate per integrare il server Model Context Protocol (MCP) dell'API Google Ads:

  • Server MCP dell'API Google Ads: progettato per flussi di lavoro di sviluppo assistiti 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 dell'API Google Ads: fornisci istruzioni rapide e pratiche consigliate che guidano un assistente a svolgere le attività tramite la divulgazione progressiva efficiente in termini di token. Indicano all'agente come utilizzare in modo efficace strumenti come il server MCP e le librerie client.

Skill disponibili

Il team dell'API Google Ads fornisce una serie di competenze per la creazione con l'API Google Ads:

Competenza Descrizione
google-ads-api-mcp-setup 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 nell'esecuzione della prima chiamata API all'API Google Ads.

Passaggi successivi