Competências do Agente PushEngage

PushEngage Agent Skills é um plugin que ensina agentes de codificação de IA a integrar e depurar o SDK PushEngage na sua aplicação móvel. A versão 1.0.0 é o primeiro lançamento, e as skills seguem dois padrões abertos, o padrão Agent Skills (SKILL.md) e o formato Agent Plugins, para que funcionem com qualquer agente que suporte um deles, incluindo Claude Code, Cowork, Cursor, Codex, Copilot, Windsurf e VS Code. Este guia explica o que inclui e como instalá-lo.

Antes de Começar

• Precisa de uma conta PushEngage com uma aplicação configurada no painel.
• Precisa de um agente de codificação de IA que suporte Agent Skills ou Agent Plugins. Recomenda-se Claude Code.
• Para as ferramentas de conta, o plugin utiliza Node.js 18 ou posterior para executar o servidor MCP incluído através de npx.

O que o PushEngage Agent Skills Faz

O plugin fornece ao seu agente conhecimento passo a passo do SDK PushEngage para que possa configurar e resolver problemas de notificações push sem que tenha de procurar na documentação.

• Fluxos completos de integração do SDK para iOS, Android, Flutter e React Native.
• Uma skill de diagnóstico que audita uma integração com problemas, compara a sua versão do SDK com uma tabela de problemas conhecidos com versão fixada e percorre uma árvore de decisão de sintomas quando a auditoria não encontra nada.
• O servidor MCP PushEngage incluído no plugin, para que o seu agente também possa operar a sua conta, como enviar e agendar notificações, criar segmentos e ler análises.

O plugin fornece seis skills que trabalham em conjunto.

Como as Skills Funcionam

Cada skill ativa-se automaticamente com base no projeto que deteta. A skill de entrada identifica a sua plataforma e passa para a skill de integração correspondente. Quando algo está com problemas, a skill de diagnóstico funciona em três fases: primeiro uma auditoria estática da sua configuração, depois uma comparação com problemas conhecidos para a sua versão do SDK e, finalmente, uma árvore de decisão baseada em sintomas. Se ainda assim não conseguir resolver o problema, gera um pacote de suporte que pode enviar para a equipa PushEngage.

Instalar no Claude Code ou Cowork

Adicione o marketplace de plugins e instale o plugin.

/plugin marketplace add awesomemotive/pushengage-skills
/plugin install pushengage

A instalação do plugin também configura o servidor MCP oficial PushEngage (@pushengage/mcp). Na primeira vez que o seu agente utilizar uma ferramenta de conta, abrirá uma janela do navegador para iniciar sessão na sua conta PushEngage. Até que inicie sessão, as ferramentas de conta permanecerão inativas.

Instalar noutros Agentes

Para Cursor, Codex, Copilot, Windsurf e outros agentes compatíveis com SKILL.md, utilize a CLI de skills.

npx skills add awesomemotive/pushengage-skills

Instalar em Clientes de Plugins de Agente

O repositório também está em conformidade com o formato aberto de Plugins de Agente, com um manifesto plugin.json, um diretório skills/ e um mcp.json. Qualquer cliente que suporte Plugins de Agente pode carregá-lo como um plugin. Os clientes compatíveis atualmente incluem VS Code, Cursor, GitHub Copilot, ChatGPT e Codex, Kiro, Hermes Agent, OpenClaw, Grok Bot e NanoClaw. Utilize o próprio mecanismo de instalação de plugins do seu cliente e aponte-o para o repositório awesomemotive/pushengage-skills. Clientes que suportam o mcp.json do plugin também obtêm o servidor MCP oficial configurado automaticamente.

Instalar Manualmente

As skills residem no diretório skills/ no repositório awesomemotive/pushengage-skills. Copie as pastas de skill para o diretório de skills do seu agente ou aponte o seu agente para o repositório. Cada skill ativa-se automaticamente com base no tipo de projeto que deteta.

Utilizar as Skills

Após a instalação, fale com o seu agente em linguagem natural. Por exemplo:

• “Ajude-me a integrar o PushEngage nesta aplicação.” Isto executa o fluxo de integração completo.
• “As notificações do PushEngage não estão a chegar ao meu iPhone.” Isto executa o fluxo de diagnóstico.
• “Audite a minha configuração do PushEngage.” Isto executa a auditoria estática.

O plugin deteta a sua plataforma automaticamente e encaminha para a skill de integração ou depuração correspondente. Com o servidor MCP conectado, também pode operar a sua conta, por exemplo, “Envie uma notificação com o título ‘Promoção termina hoje à noite’ para o meu segmento dos EUA” ou “Como correu a campanha da semana passada?”

Se preferir seguir os passos de integração você mesmo, consulte a documentação do SDK Mobile PushEngage.

Perguntas Frequentes

Com que agentes funciona?

As skills seguem tanto o padrão Agent Skills (SKILL.md) como o formato Agent Plugins, pelo que funcionam com qualquer agente que suporte um deles, incluindo Claude Code, Cowork, Cursor, Codex, Copilot, Windsurf e VS Code. Claude Code e Cowork instalam-no como um plugin, outros agentes SKILL.md adicionam-no através da CLI de skills, e clientes Agent Plugins carregam-no através do seu próprio mecanismo de instalação de plugins.

Quais plataformas são suportadas?

O plugin inclui fluxos de integração e depuração para iOS, Android, Flutter e React Native. A skill de entrada deteta a sua plataforma automaticamente e encaminha para a skill correspondente.

Preciso de configurar alguma coisa para as ferramentas de conta?

Precisa de Node.js 18 ou posterior, uma vez que o servidor MCP incluído é executado através de npx. Na primeira vez que o seu agente utilizar uma ferramenta de conta, abrirá uma janela do navegador para que possa iniciar sessão no PushEngage. Até lá, as ferramentas de conta permanecem inativas e as skills de integração e depuração continuam a funcionar.

O que é que a skill de diagnóstico verifica?

Executa uma auditoria estática da sua integração, compara a sua versão do SDK com uma lista de problemas conhecidos com versão fixada e percorre uma árvore de decisão de sintomas. Se não conseguir encontrar a causa, prepara um pacote de suporte para a equipa PushEngage.

É gratuito de usar?

O plugin é lançado sob a licença MIT. Ainda precisa de uma conta PushEngage com uma aplicação configurada para o utilizar.

Recursos

• PushEngage Agent Skills no GitHub: awesomemotive/pushengage-skills
• PushEngage MCP server no GitHub: awesomemotive/pushengage-mcp
• O pacote do servidor MCP no npm: @pushengage/mcp

Se encontrar algum problema, n0o hesite em contactar-nos clicando aqui. A nossa equipa de suporte poder0 ajud0-lo.