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 maggiore accuratezza e costi dei token inferiori. Per un elenco delle competenze disponibili, consulta Competenze disponibili.

Inizia

Installa le competenze degli agenti 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 in uno dei pacchetti di integrazione Build with Google per Antigravity. Puoi attivare questo pacchetto 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, quindi 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 --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 ulteriori 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:

npx skills add google/skills

Aggiornare le competenze degli agenti dell'API Google Ads

Puoi ottenere tutti gli aggiornamenti disponibili e rimuovere 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 gli 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 competenze 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 competenze ogni volta che rilevano che la descrizione di una competenza corrisponde alla tua richiesta attuale. Le competenze 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 competenze possono anche essere richiamate manualmente digitando / nella chat dell'agente e cercando il nome della competenza.

Componenti principali di una competenza

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 rendimento, 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 le attività localmente.

Vantaggi dell'utilizzo delle competenze

Gli skill dell'agente estendono le funzionalità di un assistente con conoscenze specializzate on demand senza l'overhead 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 competenze degli agenti utilizzano la divulgazione progressiva per ridurre al minimo questo sovraccarico:

  • L'assistente AI inizialmente controlla solo il nome e la descrizione della competenza per verificare 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 l'attività specifica, risparmiando spazio di contesto.

Implementazione guidata dall'AI

Anziché cercare manualmente nella documentazione, puoi descrivere il tuo intento in linguaggio naturale. Le competenze 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 competenze disponibili, consulta Competenze disponibili.

Utilizzare le competenze 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 flussi di lavoro 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.
  • Competenze degli agenti dell'API Google Ads: forniscono istruzioni del prompt e best practice 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.

Competenze 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