Competenze dell'agente API Google Ads

Le skill 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 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 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.

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 singolo comando:

Antigravity

Le skill dell'agente dell'API Google Ads sono incluse come uno dei bundle di integrazione Build with Google per Antigravity. Puoi abilitare 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 Plug-in Build with Google, fai clic su Personalizza, poi su Scarica per l'integrazione dell'API Google Ads.

Se preferisci l'accesso a livello di progetto, 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 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 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 open Agent Skills, puoi installare le skill utilizzando npx (richiede Node.js):

npx skills add google/skills/skills/ads

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 abilitate 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 open 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 automaticamente le skill 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 skill per eseguire le attività localmente.

Vantaggi dell'utilizzo delle skill

Le skill dell'agente estendono le funzionalità di un assistente con conoscenze specializzate on demand senza il sovraccarico di caricare istruzioni complesse 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 skill 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 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 determina che sono necessari per la tua attività specifica, risparmiando spazio di 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 di diagnostica utilizzando l'API Google Ads.

Per un elenco completo delle skill disponibili, consulta Skill disponibili.

Utilizzare le skill 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 i workflow di sviluppo assistiti dall'AI, che consente agli assistenti AI di interagire con le risorse dell'API Google Ads, le campagne e le metriche a livello programmatico.
  • Skill dell'agente dell'API Google Ads: forniscono istruzioni del prompt e best practice consigliate che guidano un assistente nell'esecuzione delle 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 suite di skill per la creazione 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 persa 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 e 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