Triagem em Lote

Auditar a conformidade de milhares de processos à mão — abrir cada um, conferir regra por regra, registrar o achado — é trabalho de semanas para uma equipe inteira. Com a Triagem em Lote do DATTA, você escolhe o contexto, clica em um botão e a plataforma audita o acervo completo enquanto acompanha o progresso ao vivo, processo a processo. O resultado não é um "sim/não" seco: cada processo recebe um laudo em que toda decisão vem com a regra avaliada, o que foi encontrado nos autos e o motivo do veredito.

Veja também: como criar regras de triagem com IA e o detalhe da auditoria de cada processo.

O que a triagem faz

A Triagem em Lote analisa os processos do contexto de processo selecionado e verifica a conformidade de cada um com as regras de triagem ativas. Quais regras entram na análise — as do CPC, do CPP, do CDC ou de vários deles juntos — é uma configuração do próprio contexto, feita uma vez em Sistema›Contextos e válida para todos os processos dele. Você não escolhe isso a cada execução, e a plataforma também não adivinha: ver quais regras a triagem aplica.

A tela fica em Processar›Triagem›Processar, com a trilha de navegação DATTA › Triagem › Processar, e o card principal exibe o rótulo "Triagem em Lote". A execução é assíncrona: ao iniciar, a plataforma responde na hora com um identificador de execução e o processamento segue em segundo plano. Você pode fechar a página — a triagem continua e o acompanhamento é retomado ao reabrir — ou cancelar a qualquer momento. A execução também aparece no painel de execuções em segundo plano.

Nomenclatura. O rótulo passou por renomeações: "Execução em Lote" → "Triagem Processual em Lote" → "Triagem em Lote" (rótulo vigente). Alguns documentos antigos e o painel de execuções em segundo plano ainda podem citar "Triagem Processual em Lote" — é a mesma funcionalidade.

Escolher o que triar

Contexto dos processos

No card Triagem em Lote, chips mostram os contextos de processo cadastrados (ex.: "Processos"), sempre com o rótulo configurado e nunca com a chave interna. A seleção é única: a triagem roda sobre um contexto — um banco de grafos — por vez, e é nele que vivem os processos. Se você chegou à tela a partir de um workspace, o contexto dele já vem pré-selecionado quando for de processo; caso contrário, vem o primeiro contexto de processo cadastrado.

Por que CPC/CPP/CDC não aparecem aqui? Esses são contextos de código legal: guardam artigos, incisos e jurisprudência — são a fonte das regras, não dos processos. Eles são escolhidos no cadastro do contexto de processos, não nesta tela. Uma versão antiga da tela oferecia esses contextos como chips, mas a escolha não tinha efeito: pior, os processos eram localizados pelo contexto ativo da plataforma, então com um código legal ativo (ex.: CPP) a triagem varria uma base sem processos e "não iniciava nada". Hoje a tela envia o contexto explicitamente e a plataforma valida que ele existe, recusando o desconhecido com mensagem acionável.

Sem nenhum contexto de processo cadastrado, o botão fica desabilitado e a tela orienta: "Cadastre um contexto do tipo 'Processo Judicial' em Sistema › Contextos."

Quais regras a triagem aplica

A triagem avalia as regras dos contextos de regra declarados no contexto de processos — o campo "Contextos de regra aplicados na triagem", do formulário de cadastro/edição do contexto (veja gerenciar contextos). São dois eixos diferentes, e cada um responde a uma pergunta:

Com mais de um contexto de regra marcado, a análise usa a união das regras de todos, sem repetir a mesma regra quando ela pertence a mais de um código. Um acervo cível com relações de consumo, por exemplo, pode declarar CPC e CDC ao mesmo tempo.

A configuração é lida a cada execução: alterar os contextos de regra e disparar a triagem em seguida já usa o valor novo, sem reiniciar nada e sem esperar.

Se o contexto não declara nenhum contexto de regra, a triagem recusa — não tenta adivinhar, e não gasta análise de IA. Cada processo aparece no feed em vermelho com o motivo: "O contexto '{nome}' não declara quais contextos de regra se aplicam a ele. Abra Sistema > Contextos > Gerenciar, edite o contexto e preencha 'Contextos de regra aplicados na triagem'; depois repita a triagem." Basta marcar os contextos de regra no cadastro e rodar de novo.

Por que a recusa é melhor do que o comportamento anterior. Até 08/08/2026 a plataforma tentava descobrir o código aplicável a cada processo por palavras soltas no texto dos autos. Medido em produção: um processo cível de cumprimento de sentença contra a Fazenda Pública foi mandado para um código que não existe nesta plataforma — porque a palavra "administrativo" aparecia em ementas e fundamentações citadas nos autos. O resultado era um laudo "concluído" com zero regras avaliadas, indistinguível de um processo realmente auditado. Recusar com o motivo na tela troca um resultado falso por uma pendência visível.

Abrangência

Quatro modos mutuamente exclusivos — três opções de rádio e uma caixa de seleção:

Marcar Apenas regras novas/atualizadas desabilita os rádios (os modos são exclusivos), e todos os controles ficam bloqueados enquanto a triagem roda.

Cada modo faz exatamente o que o nome diz. "Triar novos documentos" cobre só o que ainda não tem triagem — o processo sem laudo e o documento que chegou depois da última; erro de qualquer tipo é tratado em "Reprocessar erros". Antes do modo dedicado, um laudo com erro de IA era invisível para todos os modos exceto "Reprocessar todos" — porque já tinha auditoria e portanto contava como "já triado" — e o processo ficava preso sem ninguém ver.

Clique em Iniciar Triagem dos Processos. Se nenhum processo se enquadrar no modo escolhido, o card mostra o estado âmbar "Nenhum processo para triar", com um diagnóstico que nomeia o contexto e o banco consultados e sugere o próximo passo por modo — ex.: "Nenhum processo pendente de triagem no contexto 'Processos' (base processotributario). Todos os processos desse contexto já foram triados com sucesso — use 'Reprocessar todos' para refazer a triagem." Quando existem laudos cujo reparo automático já se esgotou (3 tentativas), a mensagem avisa explicitamente e aponta a causa provável — cota do provedor de IA esgotada.

Não é erro, mas também não é o check verde de "Triagem concluída": os dois estados são visualmente distintos justamente para "zero processos" nunca passar por sucesso silencioso. Nada é apagado nesse caminho — a limpeza do modo "Reprocessar todos" só roda depois de o contexto ser validado e de haver processos.

Agendar em vez de clicar

Ao lado do botão de iniciar há Agendar. Ele guarda esta mesma triagem — o contexto e o modo que você acabou de escolher — para uma data específica ou para uma frequência, e quem dispara na hora marcada é o Datta Scheduler, o mesmo relógio que executa as cargas do DATTA Extract.

É o caminho para as rotinas que não deveriam depender de alguém lembrar: triar os documentos novos toda madrugada, reprocessar os erros no domingo (quando a cota de IA já se renovou), ou disparar uma passada única numa data combinada.

Os agendamentos aparecem logo abaixo dos botões, com a repetição em português e a próxima execução, e podem ser pausados, editados e removidos ali mesmo. Remover o agendamento não apaga laudo nenhum.

O passo a passo completo — os cinco tipos de repetição, o que acontece quando a plataforma está fora do ar no horário e o que fazer quando já há uma triagem rodando — está em Triagem em lote agendada.

Acompanhar ao vivo

Assim que a triagem inicia, o próprio card vira uma janela de progresso que acompanha o lote processo a processo, no mesmo espírito da geração de regras com IA. São cinco elementos:

1. Ícone de fase e barra circular de % — um indicador com o percentual no centro enquanto roda; check verde ao concluir; "X" âmbar ao cancelar; ícone vermelho de erro em caso de falha geral.
2. Título e mensagem — "Triagem em andamento…", "Triagem concluída", "Triagem cancelada" ou "Erro na triagem", com o detalhe do que aconteceu.
3. Contador atual/total e barra de progresso horizontal, cuja cor reflete a fase: accent (rodando), verde (concluído), âmbar (cancelado), vermelho (erro). O contador conta processos concluídos; a barra avança de forma contínua porque também soma a fração já avaliada do processo em curso (ver o item 6).
4. Badges de resumo — uma linha de contadores coloridos:
   • ✓ N triados (verde)
   • – N inconclusivas (cinza) — recorte de "triados": o texto foi varrido e nenhuma regra pôde ser classificada.
   • – N sem texto (cinza) — recorte de "triados": o processo não tem texto indexado, então nenhuma regra chegou a ser avaliada.
   • ↻ N já atualizados (cinza — só no modo incremental)
   • ✕ N erros (vermelho)
   • ⚠️ N com erro de IA (rate limit/timeout) (âmbar)
   • ↳ <processo> — o processo sendo analisado neste instante.
5. Feed colorido — lista rolável, em fonte monoespaçada, com uma linha por processo concluído, na ordem de conclusão, com símbolo, número do processo e rótulo da ocorrência:

As três primeiras linhas correspondem aos status de triagem (Conforme, Anomalia, Anomalia Crítica). "Erro de IA" e "Já atualizado" são ocorrências da execução, não status: um processo com erro de IA fica sem veredito e basta reprocessá-lo na próxima triagem. Nas linhas de erro, o feed mostra também o motivo, logo abaixo.

"Triagem inconclusiva" e "Sem texto para avaliar" também são status, e a diferença entre eles decide o que você faz:

• Triagem inconclusiva — o texto existia, foi varrido, e o dado que as regras precisam não estava nele. É veredito sobre o processo: se revisa, não se reexecuta (por isso ele fica fora do "Reprocessar erros" — repetir chegaria ao mesmo lugar queimando cota de IA).
• Sem texto para avaliar — o processo não tem texto indexado, então nenhuma regra chegou a ser avaliada. Não é veredito, é ausência de insumo: a ação é indexar ou reprocessar os documentos e repetir a triagem, e o processo entra automaticamente no "Reprocessar erros". Repetir é barato — sem texto, o laudo sai sem nenhuma chamada de IA.

Regra por trás dos dois: regra que não pôde ser avaliada não carimba o status. Uma regra sem texto não é evidência de conformidade nem de anomalia, então fica fora da conta que decide o veredito. É o mesmo laudo que o painel de processos mostra, e as duas telas leem dele: até 2026-08-12 o feed rotulava esses laudos como "Conforme" e o painel dizia "Triagem inconclusiva" — a divergência entre as telas era o sintoma visível de um lote inteiro que não avaliou regra nenhuma.

1. Progresso dentro do processo em curso — uma linha com avaliando regras: k/N lotes e o tempo restante estimado. Ela existe porque um único processo pode exigir mais de cem chamadas de IA: sem esse detalhe, o contador de processos fica parado por vários minutos e a triagem parece travada, quando na verdade está trabalhando. A estimativa vem do ritmo medido nesta execução e só aparece depois de meio minuto de progresso.

Enquanto o primeiro resultado não chega, o feed exibe "Aguardando os primeiros resultados…".

Por que o progresso não congela

O acompanhamento ao vivo é autenticado e chega em tempo real, quadro a quadro, em vez de depender de recarregar a tela. Três cuidados sustentam isso:

• A plataforma desativa o enfileiramento intermediário das respostas, para que cada resultado apareça assim que fica pronto, e envia um sinal de vida a cada 15 s — importante porque a análise de IA de um processo pode levar até ~180 s.
• Se a conexão cair, a tela reconecta sozinha com espera crescente (de 1 s até 30 s).
• Em paralelo, uma verificação de segurança a cada 2 s consulta o status do lote (a mesma fonte do painel de execuções), então a tela não fica presa no último quadro se o fluxo ao vivo se perder.

O contador de processos, ainda assim, só avança quando um processo inteiro termina — e isso pode levar minutos em contextos com muitas regras. É o que a linha avaliando regras: k/N lotes resolve: ela mostra o avanço dentro do processo, para que "demorado" nunca seja confundido com "travado". Se mesmo assim a triagem parecer parada, o runbook de triagem que não avança traz a conta que estima a duração e as medições que separam lentidão de falha.

Uma triagem por contexto

Iniciar uma segunda triagem no mesmo contexto enquanto outra roda não acelera nada: as duas passam a dividir o mesmo limite de chamadas de IA e nenhuma termina. Por isso a plataforma recusa a segunda com uma mensagem explicando o motivo — e a tela se reconecta automaticamente à triagem que já está em andamento, que costuma ser o que o usuário queria. Contextos diferentes seguem livres para rodar em paralelo.

Ao cancelar, a triagem interrompe também os processos que estavam sendo analisados naquele instante, liberando o limite de IA de imediato. Os laudos já gravados são preservados e o desfecho fica registrado no painel de execuções em segundo plano.

Cada erro com o seu motivo

Quando um processo falha, a janela não mostra só "erro": mostra por quê. O motivo é derivado do laudo, nesta ordem — tipo de erro, explicação e, por fim, conformidade — e truncado para caber na linha. Causas típicas, sempre em português:

• Limite de requisições / timeout / formato — a análise de IA excedeu a cota por minuto, estourou o tempo limite ou devolveu um formato inesperado.
• Falha interna — uma exceção durante a auditoria, listada com o número do processo e o motivo capturado.

Laudo nunca conta pela metade

A classificação de um processo é feita em lotes de regras enviados ao modelo de IA, e a triagem é tudo-ou-nada:

• Se todos os lotes de regras falham na chamada de IA, o laudo recebe erro de IA — contabilizado como erro, não como sucesso.
• Se o processo recebe veredito (conforme ou anomalia) mas alguns lotes falharam, o laudo é parcial — a explicação avisa que "lotes de regras falharam" — e também conta como erro. Um laudo incompleto nunca entra como "auditado com sucesso".

Por isso a tela separa "N triados" de "N com erro de IA", e a mensagem final fica, por exemplo: "Triagem concluída com avisos: 14 auditados (13 processos conformes e 1 com anomalia), 2 com erro de IA (limite de requisições/timeout/formato). Reexecute os processos afetados." Basta rodar o lote de novo — o modo "Reprocessar erros" pega exatamente esses casos — ou reprocessar cada processo pelo seu detalhe.

Onde o resultado aparece

Concluída a triagem, os laudos ficam no painel de auditoria (trilha DATTA › Visualizar › Dashboards):

• Paginação de 50 processos por página, com o rodapé "N processos — Página X de Y" e os botões ← Anterior / Próxima →. Filtros por status, tipo de erro, número do processo, empresa, pessoa e responsável; ordenação por coluna (padrão: data da auditoria, da mais recente para a mais antiga). Sem resultados para o filtro, a tela mostra "Nenhum resultado encontrado".
• Laudo pesquisável: o texto integral de cada laudo é indexado em trechos de até 200 palavras cada — um índice para o texto completo (datta_auditorias_documents) e outro para os trechos por regra (datta_auditorias_chunks), cada trecho com o vetor do modelo de embedding ativo. A fragmentação evita erros de payload com laudos grandes e torna o laudo encontrável pela busca textual e semântica, por processo.
• Seções expansíveis por processo — Itens em Conformidade (verde), Anomalia Detectada (vermelho) e três seções neutras que separam situações que antes apareciam juntas. A separação existe porque só uma delas exige ação sua:

Nenhuma das três conta como anomalia nem como conformidade; ficam listadas para transparência. Seções vazias mostram "Nenhum item.", e as de sem-contexto são omitidas da exportação em PDF para não poluir o documento.

Quando o processo não tem texto nenhum, a triagem emite o laudo imediatamente, com todas as regras em "Sem Texto Disponível" e sem consumir IA — antes, o mesmo caso gastava a análise inteira para o modelo repetir "não há dados suficientes" regra a regra, e o laudo resultante era indistinguível de um processo realmente analisado.

• Decisão Final e Cabimento de Recurso: em paralelo à análise das regras — de forma melhor-esforço, que nunca derruba a triagem — a IA extrai dois blocos gravados no próprio processo. Decisão Final aparece em verde com o resumo da sentença ou acórdão mais recente, ou em cinza como "Sem Decisão Final" quando ainda não há. Cabimento de Recurso aparece em âmbar como "Cabe Recurso" (qual recurso e prazo) ou em cinza/verde como "Sem Recurso Cabível" / "Transitado em julgado".

Os botões de Itens em Conformidade e Itens Não Conformes abrem o texto dos respectivos itens do laudo — antes, um processo conforme só mostrava "Nenhuma anomalia detectada" e escondia os itens conformes. Tudo isso é exportável para o PDF do laudo, com as mesmas cores e ícones. O detalhe completo está em Detalhe da Auditoria do Processo.

Exemplo prático — auditar um acervo inteiro

1. Sua equipe acabou de carregar 1.200 processos tributários no contexto "Processos". Abra Processar›Triagem›Processar.
2. Confirme o chip do contexto "Processos" e mantenha o modo Triar apenas processos novos.
3. Clique em Iniciar Triagem dos Processos. A janela de progresso abre e o feed começa a listar: 0001234-56… ✓ Conforme, 0007890-12… ⚠ Anomalia detectada…
4. Feche a aba e vá almoçar — a triagem continua em segundo plano. Ao reabrir, o progresso é retomado no ponto em que está.
5. Ao final: "Triagem concluída: 1.198 auditados, 2 com erro de IA". Abra o painel de auditoria, filtre por Anomalia e priorize os processos com anomalia crítica — cada um com a regra violada e a justificativa citada no laudo.

Quem pode usar

Disparar e agendar são permissões diferentes. Disparar é um ato observado, com alguém na frente da tela para ver o resultado e cancelar; agendar deixa a plataforma triando sozinha por tempo indeterminado. As roles padrão analista e usuário avançado recebem as duas — a separação existe para a organização que quer manter a triagem manual e tirar a automática.

A verificação acontece na plataforma, independentemente do que a interface mostra: quem não tem a permissão recebe uma negativa clara, em português. O que a interface esconde ou desabilita é apenas uma dica visual — a barreira de segurança permanece no servidor. As permissões são administradas em Sistema›Segurança›Roles e Permissões e detalhadas no guia de roles e permissões.

Por que o acompanhamento é confiável

• O status ao vivo é autenticado, então chega em tempo real em vez de depender de recarregar a tela.
• O laudo é tudo-ou-nada: um lote de regras que falhou vira erro visível, nunca um "sucesso" falso.
• Cada erro mostra o motivo (limite de requisições, timeout, formato ou falha interna), não só um contador.
• Nenhum nome de contexto é fixo no código: rótulo, base e contextos de regra vêm da configuração — e um contexto de regra que não existe é recusado na hora de salvar o cadastro, não seis meses depois como "nenhuma regra avaliada".
• Laudo grande não estoura o índice: trechos de 200 palavras e painel paginado em 50 por página.
• A extração de decisão e recurso é melhor-esforço e nunca derruba a triagem.

A triagem em lote também pode ser disparada e acompanhada por integração — veja a referência de API, útil para conectar esteiras externas de ingestão.