Investigações

Tipo

Conceito

Para

Analista, Administrador do Tenant

Na tela

Agentes de IA › Investigações (/agents)

Liberação

Em beta

Uma investigação vigia os dados de uma ou mais Aplicações num horário marcado e lista o que saiu do padrão: o Indicador que mudou e onde mudou, ou quem está fora do normal do seu grupo. Cada resultado é um achado, com o tamanho estimado da diferença e o histórico de semanas anteriores. A comparação é sempre com o padrão dos seus próprios dados, sem meta nem regra para cadastrar. O módulo já se chamou Sentinela, e o nome ainda aparece no Lumo CLI e no nome da função de permissão.

As investigações ficam na tela Agentes de IA, na seção Investigações.

As peças

Peça	O que é
Investigação	O conjunto: nome, o que preocupa, quando repetir e as verificações
Verificação	Uma pergunta fixa sobre os dados de uma Aplicação, de um de dois tipos: Mudanças no indicador ou Comparado ao grupo
Rodada	Uma execução de todas as verificações ativas, no horário ou por Rodar agora
Achado	O que uma rodada encontrou fora do padrão, com o estado em relação às rodadas anteriores

A rodada calcula os achados direto nos dados, sem IA, e não gasta créditos de IA. A IA entra em três pontos: o Gerar com IA, que sugere verificações, o Investigar mais, que pede um parecer sobre um achado, e o Vigiar mudanças, quando alguma coluna da Aplicação ainda não tem papel definido e a IA o propõe.

Quando roda

Opção	Comportamento
Toda semana	Num dia da semana e numa hora cheia
Todo dia	Numa hora cheia
Não repete	Só quando alguém clica em Rodar agora

O horário é o de Brasília. Abrir uma investigação ativa que ainda não tem rodada para o seu acesso dispara a primeira.

Com o acesso de quem

A investigação roda com o acesso de quem lê. Duas pessoas com as mesmas permissões e os mesmos filtros de linha nas Aplicações compartilham a mesma rodada. Quem tem filtro diferente recebe uma rodada própria, com os próprios dados. Nenhum leitor vê, num achado, linhas que não veria num dashboard. Silenciar um achado também vale só para quem compartilha a mesma rodada.

Rodar agora roda com o acesso de quem clicou. Se o acesso usado na rodada não alcança uma Aplicação, as verificações dela são puladas e aparecem como pausadas.

Pessoal e publicada

	Pessoal	Publicada
Quem vê	Só quem criou, inclusive para administradores	Quem acessa pelo menos uma das Aplicações dela
Quem edita	Quem criou	Quem pode publicar e tem acesso total aos dados, sem filtro de linha

Criam investigações os administradores do Tenant e quem tem permissão de criar alertas. Publicam os administradores e quem tem a função Publicar indicadores. Publicar não tem volta: "Não dá para despublicar: para mudar, duplique." Os Indicadores pessoais usados pela investigação passam a ser publicados junto, e a janela lista quais antes de confirmar. Uma investigação publicada abre para os demais em modo de leitura, com Duplicar para ter uma cópia própria.

Como o resultado chega

Canal	O que entrega
A própria investigação	O feed de achados, com o total estimado fora do padrão
Sino	Para quem é dono, quando terminam as rodadas do acesso dele. As rodadas agendadas chegam juntas, num resumo por dia
Alerta	O bloco Investigação manda o resumo da última rodada concluída, com Anexar o PDF da rodada e Incluir os 3 maiores achados. Só recebe quem já pode ver a investigação, e cada destinatário recebe a rodada do próprio acesso. Um alerta marcado antes do horário da investigação entrega a rodada do dia anterior

O módulo depende de liberação no Tenant e pode ser bloqueado por grupo, pela função Usar a Sentinela ou pelo bloqueio de uso de IA.

Pelo Lumo CLI

Investigações também podem ser escritas em YAML, com kind: investigation, na pasta investigations/. lumo scaffold investigation gera um modelo, e lumo investigation roda, publica e lista achados. Veja a referência de investigation.

Relacionado

• Criar uma investigação
• Verificações: os dois tipos e seus campos
• Achados: ler, dispensar e investigar mais