Habilidades do agente de IA da API Google Ads

As habilidades do agente de IA da API Google Ads são módulos portáteis e autônomos de conhecimento, instruções e fluxos de trabalho específicos da API Google Ads. Essas habilidades funcionam com agentes de programação de IA que oferecem suporte ao padrão aberto Agent Skills, incluindo o Google Antigravity, o Claude Code, o Codex e o Cursor.

Essas habilidades de agente de IA ajudam os agentes de programação de IA a entender as práticas recomendadas da API Google Ads, configurar ferramentas e executar fluxos de trabalho com maior precisão e menor custo de token. Para uma lista de habilidades disponíveis, consulte Habilidades disponíveis.

Primeiros passos

Instale as habilidades do agente de IA adequadas ao seu ambiente de desenvolvimento.

Instalar habilidades do agente de IA da API Google Ads

Na maioria dos casos, é possível instalar as habilidades do agente de IA da API Google Ads no editor de sua preferência com um único comando:

Antigravity

As habilidades do agente de IA da API Google Ads estão incluídas como um dos pacotes de integração do Build with Google para o Antigravity. É possível ativar esse pacote para acesso global em dois pontos:

  • Durante a integração: marque a caixa de seleção da pilha da API Google Ads.
  • Em "Configurações":
    1. Acesse Configurações > Personalizações.
    2. Em Build with Google Plugins, clique em Personalizar e em Fazer o download para a integração da API Google Ads.

Se você preferir o acesso para envolvidos no projeto, execute o seguinte comando no diretório do projeto:

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

Cursor

Para instalar as habilidades do agente de IA da API Google Ads diretamente, adicione o endpoint do repositório do GitHub da habilidade (por exemplo, https://github.com/google/skills) nas configurações do editor em regras personalizadas. Para mais detalhes, consulte a documentação do Cursor sobre como instalar habilidades do GitHub.

Também é possível instalar as habilidades usando o comando npx (requer Node.js):

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

Outros agentes

Para outros agentes de programação de IA que oferecem suporte ao padrão aberto Agent Skills, instale as habilidades usando o comando npx (requer o Node.js):

npx skills add google/skills/skills/ads

Atualizar as habilidades do agente de IA da API Google Ads

Para conferir todas as atualizações disponíveis e limpar as habilidades desatualizadas, execute o comando update:

Antigravity

As integrações ativadas pelo Build with Google são gerenciadas e atualizadas automaticamente pelo editor.

Se você instalou as habilidades do agente de IA usando o comando npx, execute o comando update para conferir todas as atualizações disponíveis:

npx skills update --all

Claude Code 

npx skills update --all

Codex 

npx skills update --all

Cursor 

npx skills update --all

Outros agentes

Para outros agentes de programação de IA que oferecem suporte ao padrão aberto Agent Skills, é possível atualizar todas as habilidades ativas usando o comando npx:

npx skills update --all

Usar as habilidades do agente de IA da API Google Ads

Os agentes de programação de IA usam habilidades automaticamente sempre que detectam que a descrição de uma habilidade corresponde à sua solicitação atual. As habilidades instaladas globalmente permanecem inativas em projetos não relacionados, a menos que o contexto do comando corresponda às tarefas da API Google Ads.

Também é possível invocar habilidades manualmente digitando / no chat do agente de IA e pesquisando o nome da habilidade.

Principais componentes de uma skill

Cada habilidade de agente de IA é um pacote especializado que fornece ao agente de programação de IA os seguintes componentes:

  • Instruções especializadas: instruções detalhadas de comando inseridas na janela de contexto para orientar o assistente na geração de consultas GAQL, na configuração de credenciais OAuth e no tratamento de códigos do erro comuns.
  • Práticas recomendadas: recomendações padrão de desempenho, segurança e integração definidas pela equipe de DevRel da API Google Ads.
  • Scripts de automação: scripts executáveis (como para validação de ambiente ou configuração de espaço de trabalho) incluídos nos pacotes de habilidades para executar tarefas localmente.

Benefícios de usar habilidades

As habilidades de agentes de IA ampliam os recursos de um agente de programação de IA com conhecimento especializado sob demanda, sem a sobrecarga de carregar instruções volumosas em todas as conversas.

Custos de token reduzidos

As integrações convencionais de IA geralmente carregam grandes quantidades de documentação antecipadamente, o que consome muitos tokens e aumenta os custos da sessão. As habilidades do agente de IA usam a divulgação progressiva para minimizar essa sobrecarga:

  • Inicialmente, o assistente de IA só verifica o nome e a descrição da habilidade para saber se ela é relevante para sua solicitação.
  • As instruções e referências completas da habilidade só são adicionadas à janela de contexto ativa quando o assistente determina que são necessárias para sua tarefa específica, economizando espaço de contexto.

Implementação guiada por IA

Em vez de pesquisar manualmente na documentação, descreva sua intenção em linguagem natural. As habilidades orientam o assistente de IA a realizar tarefas como:

  • Gere uma consulta GAQL para recuperar as métricas de performance da campanha da minha conta.
  • Escreva um script em Python usando bibliotecas de cliente para criar uma campanha.
  • Recuperar conversões de campanha e dados de diagnóstico usando a API Google Ads.

Para uma lista completa das habilidades disponíveis, consulte Habilidades disponíveis.

Usar habilidades com o servidor MCP da API Google Ads

As habilidades do agente de IA complementam o servidor do Protocolo de Contexto de Modelo (MCP) da API Google Ads:

  • Servidor MCP da API Google Ads: projetado para fluxos de trabalho de desenvolvimento assistido por IA, permitindo que assistentes de IA interajam com seus recursos, campanhas e métricas da API Google Ads de maneira programática.
  • Habilidades do agente de IA da API Google Ads: forneça instruções de comando e práticas recomendadas que orientam um agente de programação de IA a realizar tarefas usando a divulgação progressiva eficiente em termos de tokens. Eles instruem o agente de programação de IA sobre como usar ferramentas como o servidor MCP e as bibliotecas de cliente de maneira eficaz.

Habilidades disponíveis

A Equipe de API Google Ads oferece um conjunto de habilidades para criar com a API Google Ads:

Habilidade Descrição
google-ads-api-account-diagnostics Diagnostica problemas de desempenho da conta do Google Ads, como perda de conversões, baixo volume de leads e parcela de impressões perdidas devido à classificação do anúncio, lances ou orçamentos, usando o servidor MCP da API Google Ads.
google-ads-api-mcp-setup Ajuda a configurar o servidor do Protocolo de Contexto de Modelo (MCP) da API Google Ads, simplificando a autenticação e a configuração em ambientes locais.
google-ads-api-quickstart Orienta você na configuração do ambiente de desenvolvimento, na configuração de credenciais e na primeira chamada de API para a API Google Ads.

Próximas etapas