Habilidades do agente da API Data Manager

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

Elas foram criadas para ajudar os assistentes de IA a entender as práticas recomendadas da API Data Manager, configurar ferramentas e executar fluxos de trabalho com maior precisão e menor custo de token.

Habilidades disponíveis

A Equipe de API Data Manager oferece um conjunto de habilidades para criar com a API Data Manager:

Habilidade Descrição
data-manager-api-setup Orienta os desenvolvedores nas etapas de instalação e autenticação da biblioteca de cliente para configurar a API Data Manager.
data-manager-api-event-ingestion Ajuda a implementar a ingestão de eventos e conversões para produtos do Google usando a API Data Manager.
data-manager-api-audience-ingestion Ajuda a criar listas de usuários e gerenciar dados de público-alvo usando a API Data Manager para casos de uso como a Segmentação por Lista de Clientes.

Primeiros passos

Instale as habilidades de agente adequadas para seu ambiente de desenvolvimento.

Instalar habilidades do agente da API Data Manager

Na maioria dos casos, as habilidades do agente da API Data Manager podem ser instaladas no editor de sua preferência com um único comando:

Antigravity

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

É possível instalar as habilidades do agente da API Data Manager diretamente adicionando 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 NPX:

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

Outros agentes

Para outros assistentes de IA que oferecem suporte ao padrão aberto de habilidades de agente, é possível instalar as habilidades usando o NPX:

npx skills add google/skills/skills/ads

Atualizar as habilidades do agente da API Data Manager

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

npx skills update --all

Usar as habilidades do agente da API Data Manager

Os assistentes de IA são projetados para usar 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 Data Manager.

As habilidades também podem ser invocadas manualmente no chat do agente. Para muitos agentes, é possível usar a tecla / para abrir uma lista de habilidades instaladas.

Principais componentes de uma habilidade

Cada habilidade de agente é um pacote especializado que fornece ao assistente de IA os seguintes componentes:

  • Instruções especializadas: orientações detalhadas para o assistente de IA sobre como realizar tarefas específicas, como configurar o acesso à API, formatar e gerar hash de dados do usuário e implementar fluxos de trabalho de ingestão.
  • Práticas recomendadas: recomendações de integração padrão definidas pela equipe da API Data Manager.
  • Documentação de referência: guias de configuração da biblioteca de cliente, mapeamentos de campos de migração e exemplos de código incluídos nas habilidades para fornecer ao assistente referências precisas e atualizadas.

Benefícios de usar habilidades

As habilidades do agente ampliam os recursos de um assistente 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 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 para ajudar você com as tarefas da API Data Manager, como:

  • Escreva um script em Python para ingerir conversões off-line do Google Ads usando a API Data Manager.
  • Migre este código do Google Ads OfflineUserDataJobService para a Segmentação por Lista de Clientes na API Data Manager.
  • Como faço para recuperar o status de processamento de uma solicitação de ingestão de eventos da API Data Manager?

Próximas etapas

Anterior
Instalar uma biblioteca de cliente