Mirox-Agent

O Mirox-Agent é a inteligência presente na instalação que recolhe dados do seu sistema de energia renovável, os valida, executa análises localmente e transmite os resultados para a Mirox-Cloud. Faz a ponte entre o seu equipamento físico e a plataforma, para que veja a produção em direto, o estado de saúde e as perdas sem ter de mexer nos loggers.

Visão Geral do Agente

O Mirox-Agent funciona de forma autónoma, gerindo todas as tarefas de monitorização de uma instalação. É mais do que um recolhedor passivo de dados — ele ativamente:

• Recolhe Dados: Liga-se diretamente aos seus loggers, inversores, contadores e armazenamento para obter leituras
• Padroniza Leituras: Normaliza cada fonte num único vocabulário de métricas Mirox consistente
• Valida a Qualidade dos Dados: Verificações de intervalo, plausibilidade e contadores de energia antes de armazenar seja o que for
• Executa Análises no Edge: Potência esperada, performance ratio, acompanhamento de curtailment, baseline de céu limpo e uma previsão para o dia seguinte — calculadas no local
• Inspeciona a Rede Local: Descobre e monitoriza os dispositivos de rede da instalação
• Constrói o Gémeo Digital: Alimenta um modelo por instalação que deteta falhas de componentes e perdas de energia

O agente pode ser implementado no local, na instalação, ou na Mirox-Cloud com acesso ao equipamento por VPN. Para detalhes sobre a estratégia de implementação, consulte Opções de Implementação.

Responsabilidades Principais

Recolha de Dados em Tempo Real

O agente obtém ativamente dados de todo o equipamento monitorizado, fonte a fonte.

Adaptadores Específicos por Fabricante:

• Adaptadores para Dispositivos Nomeados: Cada família suportada de loggers, inversores, contadores ou armazenamento tem um adaptador dedicado, construído sobre a interface própria desse dispositivo — Bluelog, SMA Sunny Central, SMA Power Manager, Sungrow, Huawei SmartLogger, Janitza, Phoenix Contact, armazenamento em bateria FREQCON, entre outros
• Transportes Reais: Os adaptadores comunicam pela interface nativa do dispositivo — interfaces web HTTP/REST de fabricantes, feeds WebSocket, um historian Microsoft SQL, repositórios de ficheiros compatíveis com S3 e serviços meteorológicos
• Construídos a Pedido: Quando traz uma família de dispositivos que ainda não suportamos, podemos construir um adaptador para ela — adicionar uma fonte é uma alteração de configuração, não uma redefinição

Abordagem de Recolha Ativa:

• Obtém proativamente dados dos dispositivos em vez de esperar passivamente
• Intervalos de recolha ajustados por tipo de dispositivo
• Obtenção em paralelo entre fontes, com a falha de uma fonte isolada das restantes
• Recuperação automática de erros e nova tentativa em problemas transitórios

Para a lista completa de dispositivos suportados, adaptadores e o pipeline de recolha de dados, consulte Data Scraper.

Análises no Edge

Para além da recolha em bruto, o agente calcula séries de maior valor diretamente no local, para que possa visualizá-las em gráficos como qualquer outra métrica:

• Potência Esperada: Produção modelada para cada fonte, usada como baseline para perdas e curtailment
• Performance Ratio: Desempenho da instalação face ao seu rendimento esperado, atualizado à medida que chegam novos dados
• Acompanhamento de Curtailment em Direto: Atribui a produção não realizada ao comercializador ou ao operador da rede quando a potência ativa é limitada
• Baseline de Céu Limpo: Uma curva teórica de produção em céu limpo mantida como referência de longo prazo
• Previsão para o Dia Seguinte: Uma previsão de produção do dia seguinte derivada de dados meteorológicos
• Reposição de Histórico: Quando uma instalação entra em funcionamento ou é encontrada uma lacuna, o agente pode reproduzir e reconstruir séries passadas em vez de deixar buracos

Estas análises baseiam-se na física meteorológica, não em estimativas de machine-learning. Para saber como são calculadas e que métricas emitem, consulte Data Scraper e Recolha de Métricas.

Gémeo Digital e Monitorização de Saúde

O agente alimenta um Gémeo Digital por instalação — um modelo em direto da hierarquia de componentes da instalação (contadores de injeção, inversores, caixas de junção, strings e painéis) que a plataforma utiliza para avaliar o estado de saúde dos componentes e as perdas de energia.

Dois Motores Distintos:

• Análise de Configuração: Descobre e valida as características de cada string — orientação, número de painéis, clipping do inversor, sombreamento e desempenho. Esta análise é acionada manualmente ou no arranque.
• Watchdog de Saúde: Monitoriza o estado de saúde dos componentes e calcula as perdas de energia automaticamente todas as noites, por instalação. Simula a produção esperada, classifica o estado de cada componente e separa interrupções genuínas de meras lacunas na recolha de dados. Autorrepara-se ao repor os dias em falta.

O Que o Gémeo Determina:

• Se cada componente está a produzir normalmente, em estado degradado, em sobreprodução ou sem produzir
• Se uma leitura em falta é uma interrupção real (contabilizada como perda) ou apenas uma lacuna de comunicação (não contabilizada como perda)
• Perdas de energia agrupadas por nível de confiança (alta / média / baixa), com períodos meteorológicos como neve, nevoeiro e orvalho excluídos para que nunca sejam contabilizados erradamente como falhas de componentes

O Gémeo Digital analisa atualmente instalações fotovoltaicas (PV). A análise de eólica e de baterias está Planeada.

Para a arquitetura do Gémeo Digital, consulte Gémeo Digital. Para as funcionalidades visíveis ao utilizador que ele alimenta, consulte Funcionalidades do Gémeo Digital, Avaliação de Componentes e Deteção de Perdas.

Inspeção da Rede Local

Quando implementado no local, o agente mapeia e monitoriza a rede local da instalação, para que saiba exatamente que dispositivos estão acessíveis.

Descoberta:

• Faz uma varredura dos intervalos de rede configurados para encontrar dispositivos ativos
• Resolve o endereço de hardware de cada dispositivo e identifica o seu fabricante
• Sonda os dispositivos para classificar o seu tipo e sistema operativo, com identificação assistida por IA para dispositivos que regras simples não conseguem categorizar

Verificações Contínuas:

• Verificações de acessibilidade, tempo de resposta e serviços (ping, TCP, HTTP) por dispositivo
• Estado de saúde ao nível do dispositivo, onde suportado (contadores de sistema, interface e recursos)
• Redescoberta a pedido e novas verificações por dispositivo que pode acionar a partir da plataforma

Para a vista desta capacidade visível ao utilizador, consulte Inspetor de Rede Local.

Processamento Local e Resiliência

O agente realiza trabalho relevante antes de qualquer dado sair da instalação e continua a funcionar durante perdas de conectividade.

Validação de Dados:

• Verificação de Intervalo: Os valores mantêm-se dentro dos limites fisicamente possíveis e esperados
• Verificações de Contadores de Energia: Os contadores de energia têm de aumentar de forma monótona; saltos impossíveis são rejeitados
• Deteção de Bloqueio (Freeze): Um logger que devolve valores congelados e repetidos é detetado e sinalizado
• Plausibilidade entre Fontes: As leituras são confrontadas com as condições meteorológicas e as capacidades conhecidas da instalação

Pré-processamento:

• Normalização de Unidades: Todas as leituras convertidas para unidades padrão
• Métricas Derivadas: Energia integrada a partir da potência, mais séries de desempenho e eficiência
• Agregação: Somatórios e consolidações ao longo da hierarquia de componentes
• Alinhamento de Timestamps: Dados de diferentes fontes alinhados no tempo

Buffering e Recuperação:

• Retenção Local: Os dados são guardados localmente durante perdas de conectividade
• Retoma Automática: Os dados em buffer são entregues assim que a ligação regressa
• Deteção de Lacunas: Os períodos em falta são detetados e reconstruídos por reposição

Auditoria de Acessos

Quando o agente opera o proxy de acesso na instalação, regista quem acedeu a que dispositivo através dele. Cada acesso é agrupado numa sessão fechada com um resumo da atividade gerado por IA e, depois, sincronizado com o registo de auditoria da plataforma — os dados sensíveis de consulta nunca são retidos. Para a vista visível ao utilizador, consulte o Registo de Auditoria.

Configuração e Gestão

Funcionamento Autónomo

Uma vez configurado, o Mirox-Agent funciona de forma autónoma, sem gestão externa contínua. Opera a partir da sua configuração, gerindo por conta própria a recolha, validação, análise e transmissão, e autorrepara-se após interrupções ao repor os dados em falta.

Abordagem de Configuração

O agente é configurado por instalação, definindo:

• Fontes: Os dispositivos a monitorizar e como aceder-lhes
• Agendamentos: O que recolher, quando e com que frequência
• Análises: Que análises de edge e inspeção de rede estão ativadas
• Limites e Limiares: Fronteiras operacionais para validação e alertas

A configuração é gerada e entregue pela Mirox-Cloud, pelo que o onboarding de uma instalação é uma atividade self-service e não uma edição manual de ficheiros no dispositivo.

Características Operacionais

Fiabilidade

• Recuperação automática de erros transitórios
• Recolha independente por fonte — a falha de um dispositivo não afeta os restantes
• Mecanismos de autorrecuperação e reinício automático em caso de falhas
• Comportamento controlado sob restrições de recursos

Desempenho

• Comunicação em paralelo entre fontes
• Ajuste por dispositivo, com backoff para dispositivos pouco fiáveis
• Transmissão em lotes e comprimida para usar a largura de banda de forma eficiente

Segurança

• Ligação encriptada e autenticada à Mirox-Cloud
• Tratamento seguro das credenciais dos dispositivos na instalação
• Acesso a configuração e comandos controlado por permissões
• Exposição mínima da rede da instalação ao exterior

Integração com a Mirox-Cloud

O agente trabalha em estreita colaboração com a plataforma:

Transmissão de Dados:

• Streaming de métricas em tempo real para a base de dados de séries temporais
• Atualizações do valor mais recente para o Gémeo Digital, para um acesso rápido ao último valor
• Reposição em lote de dados históricos

Comando e Controlo:

• Canal de comando bidirecional em direto: transmissão de logs, controlo de fontes individuais, acionamento de descoberta e execução de sondas de onboarding a partir da plataforma em tempo real
• Atualizações de configuração remota e distribuição de software

Reporte de Eventos:

• Alterações de estado de produção (como encerramentos e sobreprodução) reportadas à plataforma à medida que acontecem
• Componentes descobertos sincronizados, para que a lista de componentes de uma instalação se preencha automaticamente

Funcionalidades Relacionadas

• Data Scraper — os adaptadores, transportes e análises de edge por detrás da recolha de dados
• Gémeo Digital — os motores de análise e watchdog que transformam métricas em estado de saúde de componentes e perdas
• Opções de Implementação — implementação no local versus na cloud e o que cada uma permite
• Inspetor de Rede Local — a vista de descoberta de rede e monitorização de dispositivos na instalação
• mrxnode — a plataforma de hardware recomendada para o agente na instalação