Skill dell'agente AI dell'API Google Ads

Le competenze degli agenti AI dell'API Google Ads sono moduli portatili e autonomi di conoscenze, istruzioni e workflow specifici dell'API Google Ads. Queste skill funzionano con gli agenti di programmazione AI che supportano lo standard aperto Agent Skills, tra cui Google Antigravity, Claude Code, Codex e Cursor.

Queste skill degli agenti AI aiutano gli agenti di programmazione 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 AI appropriate per il tuo ambiente di sviluppo.

Installa le skill dell'agente AI dell'API Google Ads

Nella maggior parte dei casi, puoi installare le skill dell'agente AI dell'API Google Ads nell'editor che preferisci con un solo comando:

Antigravity

Le skill dell'agente AI dell'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, 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/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 AI 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 di Cursor sull'installazione delle skill da GitHub.

Puoi anche installare le competenze utilizzando il comando npx (richiede Node.js):

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

Altri agenti

Per altri agenti di programmazione AI che supportano lo standard aperto Agent Skills, puoi installare le skill utilizzando il comando npx (richiede Node.js):

npx skills add google/skills/skills/ads

Aggiorna le skill dell'agente AI dell'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 AI 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 agenti di programmazione AI che supportano lo standard aperto Agent Skills, puoi aggiornare tutte le skill attive utilizzando il comando npx:

npx skills update --all

Utilizza le skill dell'agente AI dell'API Google Ads

Gli agenti di programmazione AI utilizzano 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.

Puoi anche richiamare le skill manualmente inserendo / nella chat dell'agente AI e cercando il nome della skill.

Componenti principali di una skill

Ogni skill dell'agente AI è un pacchetto specializzato che fornisce all'agente di programmazione 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 degli agenti AI estendono le funzionalità di un agente di programmazione AI 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 AI 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

Invece di 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 skill disponibili, consulta Skill disponibili.

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

Le skill degli agenti AI integrano 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.
  • Competenze dell'agente AI dell'API Google Ads: fornisci istruzioni per i prompt e best practice consigliate che guidano un agente di programmazione AI a eseguire attività tramite la divulgazione progressiva efficiente dei token. Forniscono istruzioni all'agente di programmazione AI 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:

Skill Descrizione
google-ads-api-account-diagnostics Diagnostica i problemi di prestazioni dell'account Google Ads, come la perdita di conversioni, il volume di lead basso 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 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