Skills de configuração por IA do EMS Builder
Forneça as Skills ao AI Agent, junto com a conexão do dispositivo de destino, a conta e os requisitos de configuração, para configurar a versão atual do Edge-EMS Builder com base na documentação incluída. O pacote contém campos de interface, enumerações, fluxos completos, exemplos de solicitações e ferramentas de chamada, sem exigir acesso ao código-fonte do backend.
Por onde começar
Seção intitulada “Por onde começar”No primeiro uso, recomenda-se baixar o pacote completo e pedir ao Agent que use aems-configure para decompor os requisitos. Esse ponto de entrada também pode ser baixado separadamente e já inclui os guias de todas as áreas de configuração e os contratos das 196 interfaces atualmente registradas.
- Extraia a pasta da Skill; no Claude Code, coloque-a em
.claude/skills/do projeto; no Codex, em.agents/skills/. - Forneça o endereço base do Edge-EMS Builder:
http://<endereço_do_dispositivo>:8988na rede local (sem/api), ouhttps://<UUID_do_dispositivo>.proxy.jelina.wise-iot-cloud.com/apipor proxy. A porta depende da configuração do dispositivo. - Forneça as informações de login ou o Token no ambiente atual e descreva o objetivo, o escopo e os dispositivos/pontos existentes.
- O Agent consulta primeiro o estado atual e as dependências, valida as solicitações, configura na ordem correta e lê novamente os resultados; para tarefas assíncronas, acompanha também o estado final.
Não é necessário gravar credenciais nos arquivos das Skills. Cada Skill de configuração contém os contratos e as ferramentas de chamada de sua área; uma Skill baixada isoladamente não depende das pastas de outras Skills. As ferramentas permitem consultar campos e validar solicitações offline. As chamadas HTTP reais usam a biblioteca padrão do Python 3.10+, e a leitura/gravação em tempo real também dispõe de um cliente Node.js 22+.
Ponto de entrada completo
Seção intitulada “Ponto de entrada completo”| Skill | Finalidade | Download |
|---|---|---|
aems-configure |
Orquestração completa da configuração, com todas as interfaces, guias por área e ferramentas de chamada | ZIP |
Dados e templates de dispositivos
Seção intitulada “Dados e templates de dispositivos”| Skill | Finalidade | Download |
|---|---|---|
point-table-to-commbridge-excel |
Converte listas de pontos em arquivos Excel para importação no CommBridge, atualmente com foco em Modbus Client | ZIP |
aems-collection-config |
Sincroniza configurações de aquisição e mantém identificadores, aliases, unidades e escopo de limpeza | ZIP |
aems-add-aggregation |
Configura expressões de agregação, valores iniciais e variáveis de execução | ZIP |
aems-time-schedule |
Configura planos por faixa de horário com variação por data ou repetição diária | ZIP |
aems-data-groups |
Gerencia grupos em árvore, mapeamento de pontos, ordenação e movimentação | ZIP |
aems-ude |
Configura completamente tipos, instâncias, templates de agregação/agrupamento/compartilhamento e materialização | ZIP |
aems-ude-placeholders |
Configura conjuntos de regras, placeholders e regras de correspondência, executa simulações, prevê impactos e realiza reconciliação | ZIP |
Estratégias e comunicação
Seção intitulada “Estratégias e comunicação”| Skill | Finalidade | Download |
|---|---|---|
aems-lua-script |
Escreve e valida scripts de agregação, acionamento, MQTT e alarmes | ZIP |
aems-add-trigger-plan |
Configura gatilhos, condições, ações, pós-processamento e inicialização/parada | ZIP |
aems-alarm-lifecycle |
Gerencia tipos e registros de alarmes, além dos fluxos de recuperação/resolução de eventos | ZIP |
aems-add-mqtt |
Configura conexões, publicação, assinatura e respostas | ZIP |
aems-device-sharing |
Configura dispositivos, destinos de compartilhamento e vínculos com várias configurações de compartilhamento | ZIP |
aems-write-data |
Assinatura e leitura/gravação em tempo real, com conferência dos resultados do controle remoto | ZIP |
Análise e retenção
Seção intitulada “Análise e retenção”| Skill | Finalidade | Download |
|---|---|---|
aems-history-chart |
Consulta dados detalhados, estatísticas e gráficos de tendência com limites | ZIP |
aems-forecast |
Estima tendências no lado do Agent, explicando o método e o erro | ZIP |
aems-history-export |
Cria, acompanha e baixa exportações assíncronas de dados históricos | ZIP |
aems-history-archive |
Gerencia múltiplos planos de arquivamento, destinos de armazenamento e novas tentativas após falhas | ZIP |
Contas, operação e manutenção
Seção intitulada “Contas, operação e manutenção”| Skill | Finalidade | Download |
|---|---|---|
aems-account-management |
Cria usuários, atribui funções e mantém contas e senhas | ZIP |
aems-runtime-config |
Altera parâmetros operacionais suportados e confere sobreposições do ambiente e políticas de retenção | ZIP |
aems-backup-restore |
Faz backup de configurações, restaura sob bloqueio para manutenção e executa limpeza por categoria | ZIP |
aems-display-config |
Lê e grava o JSON de configuração de exibição conforme a estrutura existente do frontend | ZIP |
aems-system-maintenance |
Verifica de forma abrangente a capacidade, as configurações, o estado de manutenção e os logs de controle | ZIP |
Limites de configuração e validação
Seção intitulada “Limites de configuração e validação”As Skills se baseiam nas APIs implementadas no dispositivo de destino e nas permissões da conta. A configuração dos drivers de protocolo pertence ao CommBridge externo; a configuração de exibição exige o formato real do frontend; interfaces ainda não disponibilizadas não são consideradas funcionalidades disponíveis. Estratégias, controles e limpeza de dados devem ser validados dentro de um escopo definido. A aceitação de uma solicitação não significa que o dispositivo ou a tarefa assíncrona tenha concluído a operação.
O pacote público contém apenas exemplos genéricos, sem listas de pontos, estratégias ou credenciais de clientes. Próximas leituras: UDE, Alarmes, Histórico e arquivamento e Manutenção do sistema.