Habilidades do agente de IA do Google Analytics

Para criar integrações de relatórios e gerenciamento de propriedades do Google Analytics com maior precisão e menor sobrecarga de tokens, equipe seu agente de programação de IA com as habilidades de agente de IA do Google Analytics. Criadas para desenvolvedores que usam a API Google Analytics Data e a API Admin do Google Analytics, as habilidades do agente de IA do Google Analytics são módulos portáteis e independentes de instruções, fluxos de trabalho e referências de biblioteca de cliente.

Essas habilidades de agente de IA 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. Para uma lista de habilidades publicadas, consulte Habilidades disponíveis.

Antes de começar

Antes de instalar e executar as habilidades do agente de IA do Google Analytics, conclua os seguintes pré-requisitos:

  • Instale um agente de programação de IA que seja compatível com o padrão aberto Agent Skills, como o Google Antigravity, o Claude Code, o Codex ou o Cursor.
  • Instale o Node.js, que inclui o comando npx para instalar e atualizar habilidades na linha de comando.
  • Crie ou selecione um projeto do com acesso a uma propriedade do Google Analytics ao executar fluxos de trabalho da API.

Primeiros passos

Instale, atualize e invoque as habilidades do agente de IA do Google Analytics no seu ambiente de desenvolvimento.

Instalar habilidades do agente de IA do Google Analytics

Instale o pacote de habilidades do Google Analytics no diretório do projeto usando o comando npx ou configure o editor diretamente:

Antigravity

Execute o seguinte comando no diretório do projeto:

npx skills add google/skills/skills/analytics --agent=antigravity

Claude Code

Execute o seguinte comando no diretório do projeto:

npx skills add google/skills/skills/analytics --agent=claude-code

Codex

Execute o seguinte comando no diretório do projeto:

npx skills add google/skills/skills/analytics --agent=codex

Cursor

Adicione o URL do repositório de habilidades (https://github.com/google/skills) nas configurações do editor em regras personalizadas. Para instruções, consulte a documentação do Cursor sobre como instalar habilidades do GitHub.

Como alternativa, instale as habilidades no diretório do projeto usando o comando npx:

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

Outros agentes

Para outros agentes de programação de IA que oferecem suporte ao padrão aberto Agent Skills, execute o seguinte comando no diretório do projeto:

npx skills add google/skills/skills/analytics

Atualizar as habilidades do agente de IA do Google Analytics

Faça o download das atualizações disponíveis e limpe as habilidades desatualizadas executando o seguinte comando:

npx skills update --all

Usar as habilidades do agente de IA do Google Analytics

Os agentes de programação de IA carregam habilidades automaticamente quando detectam que a descrição de uma habilidade corresponde ao seu comando. As habilidades instaladas globalmente permanecem inativas em projetos não relacionados, a menos que sua solicitação envolva tarefas do Google Analytics.

Para invocar uma habilidade manualmente em agentes de programação de IA compatíveis, insira o caractere / na entrada do chat e selecione a habilidade pelo nome.

Principais componentes de uma skill

Cada habilidade de agente de IA do Google Analytics fornece ao seu agente de programação de IA os seguintes componentes:

  • Instruções especializadas: orientações detalhadas para ativar as APIs do Google Analytics com a gcloud CLI, configurar o Application Default Credentials (ADC), criar consultas runReport e verificar a compatibilidade de campos.
  • Práticas recomendadas: seleção recomendada da versão da API (endpoints v1beta para estabilidade geral e endpoints v1alpha para recursos de acesso antecipado da API Admin), construção de solicitações fortemente tipadas e fluxos de trabalho de validação de esquema.
  • Documentação de referência: guias de instalação de bibliotecas de cliente específicas de linguagem e exemplos de código para Python, Java, Node.js, PHP, Go, .NET e Ruby no diretório references/ de cada habilidade.

Benefícios das habilidades do agente de IA

As habilidades do agente de IA ampliam o agente de programação de IA com conhecimento especializado do Google Analytics sob demanda, sem carregar grandes conjuntos de documentação em todas as conversas.

Custos de token reduzidos

Carregar toda a documentação de referência da API antecipadamente consome tokens de contexto e aumenta os custos da sessão. As habilidades do agente de IA usam a divulgação progressiva para minimizar o uso do contexto:

  • Na inicialização, o agente de programação de IA lê apenas o nome e a descrição curta de cada habilidade para verificar se ela corresponde ao seu comando.
  • O agente carrega as instruções completas do SKILL.md e os arquivos de referência específicos da linguagem na janela de contexto ativa somente quando a tarefa exige.

Implementação guiada por IA

Descreva seu objetivo em linguagem natural, e as habilidades instaladas vão orientar seu agente de programação de IA nas tarefas de implementação do Google Analytics, como:

  • Ativar a API Google Analytics Data no meu projeto do e escrever um script em Python que consulta as métricas activeUsers e sessions pelas dimensões city e date.
  • Verifique se a dimensão itemName é compatível com as métricas activeUsers e totalRevenue da minha propriedade do Google Analytics usando o método checkCompatibility.
  • Liste todos os resumos de contas do Google Analytics acessíveis e as propriedades secundárias no Node.js usando a API Admin do Google Analytics.
  • Configurar dimensões personalizadas, fluxos de dados e secrets do Measurement Protocol para minha propriedade do Google Analytics.

Usar habilidades com o servidor MCP do Google Analytics

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

  • Servidor MCP do Google Analytics: conecta seu agente de programação de IA diretamente às propriedades do Google Analytics ativas para que ele possa inspecionar resumos de contas, detalhes de propriedades, dimensões personalizadas, métricas personalizadas e relatórios em tempo real.
  • Habilidades do agente de IA do Google Analytics: forneça instruções eficientes em termos de tokens e referências de biblioteca de cliente que orientam seu agente de programação de IA ao ativar APIs do , configurar a autenticação do ADC, verificar a compatibilidade de campos e escrever o código do aplicativo.

Habilidades disponíveis

O Google mantém as seguintes habilidades do agente de IA do Google Analytics no repositório google/skills:

Habilidade Descrição
google-analytics-data-api-basics Ativa a API Google Analytics Data (analyticsdata.googleapis.com) com a gcloud CLI, configura o ADC com o escopo do OAuth 2.0 analytics.readonly e instala as bibliotecas de cliente oficiais do v1beta (Python, Java, PHP, Node.js, Go, .NET e Ruby). Orienta o agente na criação de consultas runReport e na verificação da compatibilidade de campos com os métodos getMetadata e checkCompatibility.
google-analytics-admin-api-basics Ativa a API Admin do Google Analytics (analyticsadmin.googleapis.com) com a gcloud CLI, configura o ADC com os escopos do OAuth 2.0 analytics.readonly e analytics.edit e instala as bibliotecas de cliente oficiais v1beta e v1alpha (Python, Java, PHP, Node.js, Go, .NET e Ruby). Orienta seu agente a listar resumos de contas e gerenciar propriedades, fluxos de dados, dimensões personalizadas, métricas personalizadas, eventos principais, chaves secretas do Measurement Protocol e vinculações de produtos.

Próximas etapas