EVOPE Gerador

1. Configuração de Ferramentas — 2 novos parâmetros #

Adicionados dois campos ao nó Set de configuração global para que ajustes de negócio não exijam alteração de código:

Para adicionar novos apps de entretenimento, editar apenas este nó — sem alterar o código do Processar e Agregar Dados.

2. Processar e Agregar Dados (v2.12) — Entretenimento + Desvio Padrão #

2a — Detecção de Entretenimento

Para cada grupo no loop, verifica se aplicativo ou funcionalidade da linha bate (case-insensitive) com algum app da lista appsEnt (lida de config_ferramentas_entretenimento). Campos adicionados ao objeto de grupo:

Exemplo: grupo "Atendimento" com 60% das horas em YouTube → isEntretenimento: true, percEntretenimento: 60. Esse dado é passado ao AI Agent — Análise que aplica a regra de resposta adequada.

2b — Jornada Excessiva via Desvio Padrão (σ)

Como o cálculo funciona (passo a passo)

Exemplo com 5 colaboradores e suas horas registradas no período:

Passo 1 — Média (μ):

μ = (8 + 10 + 12 + 26 + 30) / 5 = 86 / 5 = 17.2h

Passo 2 — Desvio padrão (σ):
Calcula o quanto cada pessoa desvia da média, eleva ao quadrado (para eliminar negativos), tira a média e extrai a raiz:

σ = √[ ((8−17.2)² + (10−17.2)² + (12−17.2)² + (26−17.2)² + (30−17.2)²) / 5 ]
σ = √[ (84.6 + 51.8 + 27.0 + 77.4 + 163.8) / 5 ]
σ = √[ 404.6 / 5 ]
σ = √80.9 ≈ 9.0h

Passo 3 — Threshold dinâmico (com config_jornada_sigma_threshold = 1.5):

threshold = μ + (σ × 1.5)
threshold = 17.2 + (9.0 × 1.5)
threshold = 17.2 + 13.5 = 30.7h  ← quem ultrapassar este valor é flagado

Passo 4 — Comparação e output:

Neste exemplo ninguém seria flagado — a variação é considerada normal dentro do grupo. O sistema não gera alarme falso.

O que o sigma controla

Output do nó

// Campo jornadaExcessiva no objeto de output do nó:
{
  "colaboradores": [
    { "nome": "Marcos Rocha", "horasH": 30, "desvios": "2.0σ" },
    { "nome": "Ana Paula",    "horasH": 26, "desvios": "1.6σ" }
  ],
  "media": 12.2,
  "desvioPadrao": 8.9,
  "threshold": 25.5,   // média + 1.5σ (valores reais da execução #15945102)
  "sigma": 1.5
}

Colaboradores com horasH > threshold são incluídos em colaboradores[]. Threshold 0 é ignorado (sem dados suficientes). Para ajustar a sensibilidade, alterar config_jornada_sigma_threshold em Configuração de Ferramentas.

3. AI Agent — Análise (system prompt) — 3 novas regras #

Três regras adicionadas ao system prompt do agente para garantir qualidade e coerência nas análises:

Regra 1 — Mínimo de planos de ação

Instrução adicionada ao prompt:

OBRIGATÓRIO: planosAcao deve ter MÍNIMO 5 e MÁXIMO 8 itens.
Nunca retorne menos de 5 planos de ação, mesmo que os dados sejam simples.

O agente é livre para criar planos de ação complementares (treinamentos, governança, políticas internas) quando os dados brutos não gerarem 5 oportunidades óbvias.

Regra 2 — Tratamento de Apps de Entretenimento

Lógica de decisão adicionada ao prompt:

SE isEntretenimento = true OU percEntretenimento > 20%:
  → NUNCA sugerir integração de API da ferramenta de entretenimento
  → SEMPRE sugerir uma das opções abaixo:
     1. Política de Uso Aceitável (AUP) — documento formal de TI
     2. Bloqueio via MDM/UEM (Microsoft Intune ou Jamf para Mac)
     3. Relatório periódico de consumo com alerta de gestores

O campo percEntretenimento vem do Processar e Agregar Dados e é passado diretamente ao agente no JSON de análise.

Regra 3 — Jornada Excessiva via σ

Instrução adicionada ao prompt:

Use o campo jornadaExcessiva do JSON recebido.
Mencione os colaboradores flagados com seus desvios.
Formato obrigatório: "X colaboradores acima do threshold (média Xh + 1.5σ = Xh)"
Exemplo: "2 colaboradores acima do threshold (média 12.2h + 1.5σ = 25.5h):
  - Marcos Rocha: 30h (2.0σ acima da média)
  - Ana Paula: 26h (1.6σ acima da média)"

Quando jornadaExcessiva.colaboradores está vazio, o agente omite a seção — sem alerta falso.

4. Pipeline Caminhos — Bug LangChain BufferMemory corrigido (3 nós) #

O bug

Fix em 3 camadas

Camada 1 — Preparar Prompt Caminhos (prevenção upstream):

// Antes (bugado): passava dadosAnalise completo mesmo sem caminhos
return [{ json: dadosAnalise }];  // ← múltiplas chaves → crash BufferMemory

// Depois (correto): guard quando sem dados
if (links.length === 0) {
  return [{ json: { _semCaminhos: true } }];  // ← 1 chave apenas → sem crash
}
return [{ json: { prompt: promptFormatado } }];  // ← 1 chave → OK

Camada 2 — AI Agent — Caminhos (tolerância a falha):

// Configuração adicionada ao nó:
onError: "continueRegularOutput"  // = continueOnFail habilitado

// Efeito: mesmo que o agente falhe internamente,
// o item de erro é passado adiante e o workflow continua.
// Sem isso, qualquer erro aqui travava toda a execução.

Camada 3 — Extrair Análise Caminhos (guard downstream):

// Antes (bugado): acessava output diretamente
const aiResponse = items[0].json.output;  // ← quebra se output não existe

// Depois (correto): verifica flags antes de acessar
const firstItem = items[0]?.json || {};
const aiResponse = (!firstItem._semCaminhos && !firstItem.error)
  ? (firstItem.output || firstItem.text || '')
  : '';  // string vazia — Gerar HTML Final trata ausência omitindo a seção

Regra geral aprendida: Nós LangChain com BufferMemory sempre devem receber exatamente 1 chave de input. Quando dados podem estar ausentes, usar guard _semCaminhos + continueOnFail + guard no nó seguinte é o padrão de segurança adotado.

Workflow: Relatório de Grupos — Correções Jul/26

Workflow: eJ4CTb9f4fxSS04d · Nó modificado: Processar Dados Grupos + AI Agent - Analise (system prompt) · Validado em 25/07/2026

// Antes (frágil): removia sempre a 1ª linha por posição
const grupos = allGrupos.slice(1);

// Depois (robusto): identifica totalizador por GrupoID === "0" ou por nome de contexto
const totalizador = allGrupos.find(g =>
  g.GrupoID === '0' || g.GrupoID === 0 ||
  (nomeGrupoContexto && g.GrupoColaborador &&
   g.GrupoColaborador.toLowerCase() === nomeGrupoContexto.toLowerCase())
) || allGrupos[0];

const grupos = allGrupos.filter(g => g !== totalizador);

// totalColaboradores vem do totalizador (dado correto), não dos subgrupos
var totalColabs = totalizador
  ? (totalizador.QtdColaboradoresTotal || 0)
  : (grupos.length > 0 ? (grupos[0].QtdColaboradoresTotal || 0) : 0);