Sobre os dados
O que cada número, status e motivo desta ferramenta significa, em linguagem simples. Os mesmos termos aparecem nas telas e na planilha Excel exportada.
Números da visão geral e do funil
Os números das telas consideram só as execuções marcadas para o relatório, exceto o gasto real.
Consultas web
Quantas buscas na web foram feitas e aceitas pelo provedor: uma por estado (UF), tecnologia e modelo de consulta. Cada consulta tem um custo estimado e uma resposta bruta guardada.
Resultados
Quantos links as consultas devolveram, contando repetições. O mesmo endereço pode aparecer em várias consultas.
URLs únicas
Quantos endereços diferentes sobraram depois de juntar os resultados repetidos. É o conjunto de onde saem as páginas a baixar.
Páginas selecionadas
URLs que passaram pelos filtros de seleção (fonte oficial, palavras-chave no título ou no trecho, limite por UF) e que o pipeline tentou baixar. As demais ficam registradas com o motivo do descarte.
Páginas baixadas
Páginas selecionadas cujo download foi tentado e respondeu. Um download pode funcionar e mesmo assim não render texto.
Páginas com texto
Páginas baixadas de onde foi possível extrair texto legível. Só essas vão para o classificador com o texto da página.
Classificações
Quantas páginas (pares página-UF) o modelo de linguagem leu e classificou, contando só a classificação vigente de cada uma (ver “Classificação vigente”). Lê o texto da página ou, sem texto, só o título e o trecho do buscador. Uma classificação pode não ter nenhum achado.
Achados
Cada par tecnologia-status que o modelo apontou numa página, com um trecho literal como evidência, contando só os da classificação vigente de cada página. Um achado é uma hipótese a verificar por uma pessoa, não um resultado confirmado.
Classificação vigente
Quando uma página foi classificada mais de uma vez, só uma classificação conta nos números: a que já tem achado verificado por uma pessoa (decisão humana nunca é trocada sozinha); senão a de resposta válida; senão a feita com o texto da página, que vale mais que a feita só com o trecho do buscador; senão a mais recente. Nada é apagado: as outras ficam no banco, e um achado antigo continua abrindo, com o aviso de que foi substituído.
Evidência confere
Percentual dos achados cujo trecho citado existe de fato no texto enviado ao modelo. Veja o termo “Evidência confere”, mais adiante, para o que isso garante e o que não garante.
Verificados
Percentual dos achados que uma pessoa já revisou, confirmando o status ou descartando o achado. É o andamento do trabalho humano, não a qualidade do modelo.
Confirmados
Achados verificados por uma pessoa e mantidos (com o status reportado ou outro, corrigido por ela). Os descartados não entram.
UFs com achado confirmado
Em quantos estados há ao menos um achado confirmado (a conta também incluiria achados municipais, que ainda não existem). É o número que vai para o texto da pesquisa, por isso depende da verificação humana.
Gasto real (todas as execuções)
Soma do custo gravado em todas as chamadas externas, inclusive as de execuções fora do relatório (testes e pilotos custam dinheiro mesmo sem entrar nas contagens). Na busca web o custo é o preço configurado por requisição, uma estimativa; para conferir, compare com o saldo do provedor.
Tecnologias pesquisadas
As seis categorias do vocabulário da pesquisa. O modelo só pode usar estas.
Reconhecimento facial
Sistemas que identificam ou comparam rostos em imagens de câmeras, fotos ou bancos de dados.
Leitura de placas de veículos
Câmeras ou programas que leem placas de veículos automaticamente, por exemplo em rodovias e vias urbanas.
Videomonitoramento inteligente
Câmeras com análise automática de imagem (detecção de eventos, objetos ou comportamentos), diferentes de câmeras que só gravam.
Análise preditiva / policiamento preditivo
Modelos que usam dados históricos para prever onde ou quando crimes tendem a ocorrer e orientar o policiamento.
Outra aplicação de IA
Qualquer outra aplicação de inteligência artificial em segurança pública que não se encaixe nas demais categorias.
Atendimento virtual (BO online, chatbot, WhatsApp)
Serviço ao cidadão por canal virtual (site, WhatsApp, chatbot, assistente ou delegacia virtual), como o registro de boletim de ocorrência online, quando o texto diz que usa inteligência artificial ou automação.
Status do achado
O status diz em que estágio a instituição está com a tecnologia. A definição oficial, em inglês, é a que o modelo recebe no prompt; a explicação em português é a deste painel.
Em uso
A tecnologia já funciona no dia a dia da instituição. É o único status que indica uso comprovado em operação.
Definição oficial (enviada ao modelo, em inglês)the technology is already deployed and operating
Piloto
Há teste, projeto-piloto ou implantação parcial: funciona, mas ainda não é o uso pleno.
Definição oficial (enviada ao modelo, em inglês)test, pilot project or partial deployment
Licitação/contrato
Existe licitação, pregão, contrato ou aquisição em andamento ou já assinada, sem que o texto prove que a tecnologia já opera.
Definição oficial (enviada ao modelo, em inglês)tender, auction, contract or acquisition in progress or signed
Anunciado
A instituição anunciou ou planeja a tecnologia para o futuro, mas o texto não mostra contrato nem operação.
Definição oficial (enviada ao modelo, em inglês)announcement or future plan, with no proven contract or operation
Em estudo
A tecnologia está sendo estudada, avaliada ou desenvolvida internamente, sem piloto, compra nem data de implantação anunciada.
Definição oficial (enviada ao modelo, em inglês)technology under study, feasibility assessment or internal development, with no deployment, pilot, procurement or announced date
Apenas citado
A página só menciona a tecnologia de forma genérica, sem indício de que a instituição a use ou pretenda usá-la.
Definição oficial (enviada ao modelo, em inglês)generic mention, with no indication of deployment by the agency
Descartado (achado incorreto)
Não é um status do modelo: é uma decisão humana. A pessoa que revisa marca como descartado o achado que está errado (a página não fala da tecnologia, o trecho não sustenta o achado, a fonte não serve). Achados descartados não contam como confirmados.
Confiança do modelo
O modelo declara sua confiança em cada achado. Ela ajuda a priorizar a revisão e nunca substitui a verificação humana.
Alta
O próprio modelo disse estar bastante seguro, e a leitura foi feita sobre o texto da página. Mesmo assim o achado precisa de verificação humana.
Média
O modelo indicou segurança moderada: o trecho sugere o achado, mas deixa alguma dúvida (por exemplo, status incerto).
Baixa
O modelo indicou pouca segurança, ou a leitura veio só do título e do trecho do buscador (snippet). Vale olhar primeiro estes achados na revisão.
Por que a leitura só de snippet é sempre baixa
Com apenas o título e o trecho do buscador, o modelo não vê o contexto da página e pode se enganar com facilidade. Por isso o sistema rebaixa para baixa qualquer achado vindo só de snippet, mesmo que o modelo tenha dito alta; a confiança que o modelo devolveu fica guardada ao lado, para auditoria.
Evidência e origem do texto
A evidência é o trecho literal que sustenta o achado. As marcas abaixo são conferências automáticas, sem modelo, para ajudar a revisão.
Evidência confere
O trecho que o modelo citou foi encontrado, palavra por palavra, no texto enviado a ele (ignorando maiúsculas, acentos e espaços repetidos). Isso só garante que o trecho existe, não que ele sustenta o achado. A comparação é feita sem usar o modelo.
Evidência não localizada
O trecho citado não aparece no texto enviado, em geral porque o modelo parafraseou ou resumiu em vez de copiar. O achado pode até estar certo, mas precisa de atenção especial: a tela mostra a passagem mais parecida, como aproximação.
Evidência cita a tecnologia
Verificação branda: o trecho contém alguma palavra do nome da tecnologia (por exemplo, “placas” para leitura de placas). Se não contém, o achado sobe na fila de revisão. É uma ajuda para priorizar, não uma decisão.
Nome da solução
O nome próprio da ferramenta, sistema ou programa do achado (por exemplo, “BO Fácil” ou “SPiA”), como está escrito no texto. O modelo o preenche mesmo quando o trecho de evidência só diz “a ferramenta”, porque o nome pode estar em outro parágrafo. O sistema só guarda o nome se ele aparece no texto enviado ao modelo (título e endereço incluídos); um nome inventado é descartado e fica contado. Em branco (“—”) quer dizer que nenhum nome próprio apareceu. A evidência continua sendo um trecho literal.
Evidência cita a LGPD
O trecho menciona a Lei Geral de Proteção de Dados ou proteção de dados. Para saber quantos achados tratam de LGPD, use esta marca e não a do modelo, que às vezes marca LGPD sem que o trecho a cite.
Texto completo
O modelo leu o texto extraído da página inteira (até o limite de caracteres enviados). É a leitura mais confiável.
Somente snippet
A página não pôde ser baixada ou não rendeu texto, então o modelo leu só o título e o pequeno trecho que o buscador mostrou. Como o contexto é mínimo, a confiança é sempre baixa.
Verificação humana
Todo achado nasce não verificado. Só a decisão de uma pessoa o confirma ou descarta.
Não verificado
Ninguém revisou o achado ainda. Aparece como “Não verificado”.
Verificado
Uma pessoa revisou e manteve o achado, com o status reportado pelo modelo ou com outro, corrigido por ela.
Descartado
Uma pessoa revisou e concluiu que o achado está incorreto. Fica guardado, com o histórico da decisão, mas não conta.
Motivos de descarte de páginas
Páginas encontradas na busca que não foram baixadas. Nenhuma some: cada descarte fica registrado com o motivo.
Domínio na lista de exclusão
A página é de um site que a pesquisa decidiu ignorar (por exemplo, redes sociais ou vídeos). Foi encontrada, mas não será baixada.
Fonte não oficial
O endereço não é de um órgão público (aqui só vale quem termina em .gov.br) e a configuração aceita só fontes oficiais nesta etapa.
Sem palavras-chave no título/snippet
Nem o título nem o trecho do buscador contêm alguma das palavras-chave da pesquisa, então a página foi considerada improvável e não foi baixada. A auditoria do pré-filtro mede se isso perde achados.
Limite de páginas por UF
O estado já tinha atingido o número máximo de páginas a baixar. As páginas mais bem posicionadas entram primeiro; as demais ficam registradas como descartadas por limite.
Motivos de falha na extração do texto
Páginas baixadas de que não saiu texto utilizável.
Texto insuficiente na página
A página foi baixada, mas o texto extraído é curto demais para ser lido (por exemplo, uma página que só carrega depois, com JavaScript). O classificador usa só o título e o trecho do buscador.
Tipo de arquivo não suportado
O arquivo não é de um tipo que o pipeline sabe ler (por exemplo, um arquivo compactado). O tipo aparece entre parênteses.
Erro na extração
Houve um erro inesperado ao extrair o texto. O detalhe aparece entre parênteses e a resposta bruta continua guardada.
Motivos de bloqueio no download
Páginas que o pipeline não baixou por causa do robots.txt do site. As duas situações são diferentes e aparecem separadas.
Proibido pelo site (diretiva Disallow do robots.txt)
O robots.txt do site (arquivo em que o site diz o que os programas podem ler) foi lido com sucesso e proíbe esta página para o pipeline. É uma proibição do próprio site, e o pipeline a respeita; a página não foi requisitada.
Bloqueio preventivo (RFC 9309): robots.txt do site indisponível
Não foi possível ler o robots.txt do site (erro do servidor, tempo esgotado ou falha de rede), mesmo depois de algumas tentativas. Pela RFC 9309 e pela política do pesquisador, sem poder ler as regras o pipeline assume que tudo é proibido e não baixa a página. Não é uma proibição do site: costuma ser uma falha passageira, e a leitura é repetida quando passam alguns minutos.
Escopo e fontes
O que cada achado descreve e de onde veio.
Secretaria estadual
Achado sobre o órgão de segurança do governo do estado. É o foco da pesquisa e o que aparece como “estadual” nas tabelas.
Secretaria ou guarda municipal
Achado sobre um município (guarda municipal, secretaria da prefeitura). É guardado com o nome da cidade e a UF e não se mistura com os resultados estaduais.
Fonte oficial (.gov.br)
O endereço pertence a um órgão público. Fonte oficial pesa mais como prova do que uma reportagem, mas a revisão humana continua necessária.
Fonte oficial depois do redirecionamento
Alguns endereços redirecionam para outro site ao serem abertos. A fonte oficial “final” olha o domínio onde a página foi de fato lida, e é ela que as telas mostram quando existe. Atenção ao caso de um link oficial que termina em site não oficial.
Snippet
O título e o pequeno trecho que o buscador mostra junto de cada resultado. Serve de último recurso quando a página não pode ser lida.
Texto cortado
O modelo lê no máximo um número fixo de caracteres por página. Quando o texto passa do limite, a página mostra onde o corte ocorreu; o que ficou depois dele nunca foi visto pelo modelo.
Execuções, reprodutibilidade e custos
Cada passagem do pipeline é uma execução, com situação, configuração e gasto próprios.
Concluída
A execução terminou sem interrupção: todas as etapas dela rodaram até o fim.
Em andamento
A execução começou e ainda não registrou o fim. Se o pipeline foi encerrado à força, ela fica assim até ser retomada ou marcada como interrompida.
Interrompida
A execução parou no meio (limite de crédito, queda de conexão ou ordem do pesquisador). Os dados já gravados valem; é possível retomar de onde parou.
Falhou
A execução terminou com erro antes de produzir resultado útil. Veja as chamadas e o log para a causa.
Fora do relatório
Marca de uma execução de teste ou piloto que o pesquisador tirou das contas. Nada é apagado: os dados continuam no banco e nas telas por execução, mas deixam de entrar nas somas, nos resumos por UF e no PRISMA. O gasto real continua contando todas as execuções.
Idempotência
Repetir a mesma etapa não repete o trabalho nem o gasto: uma chamada que já deu certo na execução não é feita de novo. Por isso é seguro retomar uma execução interrompida, e importar a mesma planilha duas vezes não duplica nada.
Hash da configuração
Impressão digital curta da configuração completa da execução (provedores, termos, filtros, prompt, vocabulário). Duas execuções com o mesmo hash foram feitas com as mesmas regras, o que permite reproduzir e comparar resultados. Mudar pausas entre chamadas não altera o hash.
Versão do código (commit)
Identificador da versão do código usada na execução. Se havia alterações não gravadas, aparece como “sujo”, seguido de um código do conteúdo: a execução não é reproduzível só pelo commit.
Custo estimado e custo real
O custo gravado em cada chamada é calculado com os preços configurados e com os tokens informados pela API. É uma estimativa; o saldo do provedor, quando existe, é a conferência.
Diferença de créditos (execução)
Consumo de créditos do provedor (saldo no início menos o saldo no fim da passada) menos as chamadas bem-sucedidas registradas. Zero: o provedor cobrou o que o sistema registrou. Negativa: cobrou menos (busca não cobrada, como uma resposta em cache, ou saldo final lido antes de refletir a última busca). Positiva: créditos gastos fora da execução. Não indica erro nos dados; o sistema guarda só o número do saldo, não a resposta da conta.
Resposta bruta
Cópia exata do que o provedor devolveu, guardada em arquivo com impressão digital (hash). É a evidência de que o dado não foi alterado depois da coleta.
Literatura e PRISMA
Termos da segunda parte da pesquisa: artigos científicos, triagem e fluxo PRISMA.
Artigo único
O mesmo estudo pode ser achado por vários termos e em várias bases. O sistema junta as repetições (pelo título) e conta cada artigo uma vez.
Termo de busca
Cada termo é uma consulta própria, identificada por um código (T01, T02...). Os termos e suas versões em inglês ficam registrados com a execução.
Achado por 2 ou mais termos ou bases
Artigos achados por pelo menos dois termos do Google Scholar ou por pelo menos duas origens somadas: cada termo diferente do Scholar conta uma vez e cada base manual (IEEE, ACM, Scopus, SBC OpenLib) conta uma vez. É o mesmo critério do número da Visão da literatura e do filtro “Mais de um termo” da lista de artigos. Só os termos do Scholar aparecem na aba Multi_termo e nas faixas da análise de termos. Muita sobreposição entre dois termos indica que um deles acrescenta pouco à busca.
Buscas manuais (IEEE, ACM, Scopus, SBC OpenLib)
Bases consultadas por uma pessoa no site da própria base. O sistema só conhece o que for informado por planilha: o número de resultados e os artigos importados. O que não foi informado aparece como “não informado”, nunca como zero.
Relevância (Brasil + tema)
Ajuda para priorizar a triagem: o programa procura, no título, no resumo, nos autores e no link de cada artigo, sinais de que ele é brasileiro (Brasil, estados, cidades, polícias, domínio .br) e de que trata de segurança pública (polícia, crime, vigilância, perícia, sistema prisional). As listas de palavras ficam à vista na página de artigos. É uma heurística: pode errar para os dois lados, não exclui nem esconde nada e não decide por você.
Relevância alta
O artigo tem sinal de Brasil e sinal de tema. É o grupo a olhar primeiro, mas continua sujeito à decisão de quem faz a triagem.
Relevância média
O artigo tem só um dos dois sinais: ou parece brasileiro mas o tema não aparece (por exemplo, repositório .br com assunto genérico), ou trata do tema mas sem sinal de Brasil (por exemplo, policiamento preditivo em outro país). Vale conferir caso a caso.
Relevância baixa
Nenhum dos marcadores foi encontrado. Não significa que o artigo seja irrelevante: o título e o resumo podem usar palavras fora das listas. Por isso a triagem continua cobrindo todos os artigos.
Triagem por título e resumo
Primeira leitura de cada artigo: uma pessoa decide, só pelo título e pelo resumo, se ele merece leitura completa.
Triagem por texto completo
Segunda leitura, só dos artigos incluídos na primeira: a pessoa lê o artigo inteiro e confirma ou não a inclusão. É a decisão que define o conjunto final.
Incluir
A pessoa decidiu que o artigo atende aos critérios e segue para a próxima etapa.
Excluir
A pessoa decidiu que o artigo não atende aos critérios. O motivo é registrado e aparece no fluxo PRISMA.
Pendente
Ninguém decidiu ainda sobre o artigo naquela etapa.
Fluxo PRISMA
Diagrama padrão de revisões sistemáticas, que conta quantos registros entraram e saíram em cada etapa. Os números vêm direto do banco.
PRISMA: identificação
Quantos registros as buscas trouxeram (Google Scholar e bases manuais), quantos eram duplicados entre termos e entre bases e quantos foram removidos por ferramenta automática antes da triagem humana.
PRISMA: removidos por ferramenta automática
Artigos que a triagem de escopo do modelo excluiu (veredito atual válido) e sobre os quais nenhuma pessoa decidiu incluir ou excluir. O PRISMA 2020 pede esse número à parte, sem decisão humana. Nada é apagado: se uma pessoa decidir sobre o artigo, ele volta ao fluxo humano e deixa de contar aqui. É o que separa os artigos únicos do total da busca dos artigos que seguem para a triagem por título e resumo.
PRISMA: triagem
Quantos artigos únicos (já sem os removidos por ferramenta automática) foram lidos por título e resumo, e quantos foram incluídos, excluídos ou ficaram pendentes.
PRISMA: elegibilidade
Quantos artigos incluídos na triagem foram avaliados pelo texto completo e com que resultado.
PRISMA: inclusão
Quantos artigos compõem o conjunto final da revisão.
Não informado, não executado
“Não informado” significa que uma busca manual ainda não foi importada; “não executado” significa que a busca no Google Scholar não foi rodada. Em ambos os casos o número real é desconhecido, não zero.
Triagem de escopo pelo modelo
O modelo opina, item a item, se o resultado serve ao escopo; a pesquisa usa a opinião para refinar as consultas, sem apagar nem decidir nada.
Triagem de escopo pelo modelo
O modelo de linguagem lê o título e o resumo de cada artigo (ou resultado web) e diz se ele serve ao escopo da pesquisa: elegível, quarentena ou excluído. É uma opinião registrada à parte da sua decisão, usada para ajustar as consultas de busca. Nada é apagado: o excluído fica oculto das listas por padrão (quarentena temporária) e uma decisão humana sempre prevalece.
Triagem LLM: elegível
O modelo julga o item possivelmente útil para o escopo da pesquisa. Aparece normalmente nas listas.
Triagem LLM: quarentena
O modelo tem dúvida (informação ausente, cortada ou ambígua) e, na dúvida, não exclui. Aparece normalmente nas listas, com o motivo da dúvida.
Triagem LLM: excluído pelo modelo
O modelo tem certeza de que o item é inútil para o escopo (e a conferência automática confirmou: só vale com confiança alta). Fica oculto das listas por padrão (quarentena temporária), mas nunca é apagado: você pode mostrá-lo a qualquer momento e a sua decisão sempre prevalece.
Motivo: fora de segurança pública
O item não trata de segurança pública, policiamento, perícia, justiça criminal ou defesa social (por exemplo, um artigo de saúde ou de agricultura que casou com um termo da busca).
Motivo: sem IA ou tecnologia
O item trata de segurança pública, mas não de inteligência artificial nem de análise automatizada de dados.
Motivo: metodologia irrelevante
Divulgação genérica, opinião superficial, sem dados e sem caráter científico ou técnico.
Motivo: ambiguidade lexical
Um termo da consulta tem mais de um sentido e capturou o item fora do contexto que a pesquisa quer.
Motivo: fora do recorte temporal
Artigo publicado antes de 2022. Por padrão fica fora do recorte; só deixa de ser excluído se o modelo o achar útil mesmo assim (aí aparece como elegível ou em quarentena e a justificativa diz por quê).
Motivo: fora do recorte geográfico
Item estrangeiro e sem utilidade para o contexto brasileiro. Sozinho só leva à quarentena, porque literatura internacional pode servir de referência; só é excluído se também estiver fora do tema.
Motivo: ruído web
Página de erro, catálogo sem texto ou ruído de indexação do buscador.
Ficha de ruído por termo
Para cada consulta da busca, a parcela de itens elegíveis, em quarentena e excluídos pelo modelo, o motivo e a área mais frequentes do ruído e a parcela de itens internacionais. O ruído é a soma de excluídos e em quarentena sobre o total. Só linhas com a conferência automática aprovada entram nos percentuais.
Termo gerador
Entre as consultas que encontraram um item, a que o modelo aponta como provável causa de ele ter sido capturado por engano. O programa confere que é uma das consultas da busca, para poder contar quantos itens ruidosos cada termo gerou.
Sinal negativo
Palavra ou expressão (até três palavras) copiada do título ou do resumo de um item excluído que caracteriza aquele ruído e poderia virar um operador negativo na busca. É uma sugestão do modelo: antes de usá-la, veja o dano colateral.
Dano colateral de um operador negativo
Quantos itens bons (elegíveis, em quarentena ou incluídos por você) também contêm o sinal negativo e se perderiam se a consulta o excluísse. Zero é seguro; até 5% dos itens que contêm o texto é arriscado; mais que isso, ou uma palavra central do tema, é perigoso.
Área temática
A área de onde vem o item segundo o modelo (saúde, educação, agropecuária, trânsito...), entre uma lista fechada. Mostra de onde vem o ruído de cada termo e que tipo de operador negativo ajudaria.
Escopo geográfico
Se o item trata do Brasil, é internacional ou indeterminado. Item internacional não é excluído só por isso, porque pode servir de referência; mas um termo que só traz literatura estrangeira indica que a consulta precisa de foco no Brasil.
Conferência automática da triagem
Depois de cada resposta do modelo o programa confere, sem usar o modelo, se os campos são válidos, se o termo gerador é um dos termos da busca e se o sinal negativo existe no texto; e rebaixa para quarentena toda exclusão sem confiança alta. Linhas que falham ficam marcadas e fora dos percentuais.
Soluções conhecidas e busca no texto
Duas telas para conferir se a coleta encontra o que o pesquisador já conhece.
Solução conhecida
Sistema de IA de segurança pública que o pesquisador sabe que existe e informa em config/solucoes_conhecidas.py (nome, UF e, se quiser, apelidos). A página Soluções conhecidas mostra se a coleta o encontrou nos resultados da busca, no texto das páginas baixadas e nos achados. É uma medida de revocação da coleta, não um resultado da pesquisa; a lista é sua e não entra na configuração das execuções.
Entidade de solução
O mesmo sistema, mesmo escrito de jeitos diferentes pelo modelo (“SPiA”, “SPIA”, “Sistema de Policiamento por Inteligência Artificial”; “BO Fácil”, “B.O. Fácil”). O painel reúne essas grafias em uma entidade, só com regras fixas e sem usar o modelo, em três camadas de confiança: pelo cadastro (nome ou apelido de uma solução conhecida, na mesma UF), sigla e nome por extenso (as iniciais do nome formam a sigla, ou o formato “Nome (SIGLA)”) e unificado por semelhança (a mais fraca: grafia equivalente ou muito parecida, com os mesmos números e na mesma UF, o que separa “Operação Paz I” de “Operação Paz II”). Nunca se reúne entre UFs diferentes, e o valor que o modelo escreveu fica intacto no banco e na planilha: a tela da ocorrência o mostra em “Como o modelo escreveu”. O nome mostrado é o oficial do cadastro ou, nas soluções novas, a grafia mais frequente. Cada grafia reunida mostra a camada e o motivo, para você conferir e, se discordar, cadastrar a solução com seus apelidos.
Busca no texto
Procura de um nome ou frase em todo o texto extraído das páginas já baixadas, e não só na evidência dos achados. Ignora acentos e maiúsculas e, com a opção de palavra inteira, não acha o nome dentro de outra palavra. Só enxerga páginas baixadas: não achar o nome não prova que a solução não é usada.
Confiança na IA e páginas não verificadas
Como se mede o que o modelo acerta e o que ele deixa passar, e o que a coleta não conseguiu ver.
Revisão independente
Duas ou mais pessoas decidem sobre os mesmos achados cada uma por conta própria, sem ver a decisão da outra. Entra pelo comando achados-importar com a opção --independente: a decisão vai só para o histórico e não muda a decisão final do achado. É a única revisão que conta para medir se os revisores concordam.
Kappa de Cohen entre revisores (achados)
Mede quanto dois revisores concordam em confirmar ou descartar um achado, além do que o acaso explicaria: 0 é igual ao acaso e 1 é concordância perfeita. Vem com o percentual de concordância e a faixa de leitura (fraca, razoável, moderada, substancial, quase perfeita), que é uma convenção e não uma lei. Quando quase todos os achados têm o mesmo desfecho, o kappa pode ser baixo mesmo com muita concordância; se todos os achados do par têm um só desfecho, ele não pode ser calculado.
Discordâncias dos achados
Achados em que dois revisores decidiram diferente (um confirmou e o outro descartou, ou deram status diferentes). É a pauta da reunião de consenso e sai na aba Discordancias_achados da exportação, com a decisão de cada um e a decisão final.
Falso negativo (aplicação perdida)
Página em que havia uma aplicação de IA e o modelo não marcou nenhum achado. É o erro que faz o levantamento deixar de ver algo, e só se descobre quando uma pessoa lê páginas que o modelo deixou sem achado.
Auditoria dos negativos do modelo
Conferência humana de uma amostra sorteada de páginas que o modelo classificou sem nenhum achado. A pessoa diz, página a página, se havia uma aplicação de IA que o modelo perdeu (1) ou se o modelo acertou (0). Dá a taxa de falso negativo e, com ela, uma ideia da revocação do modelo. O sorteio é reproduzível (mesma semente, mesma amostra) e proporcional ao tamanho de cada UF.
Limite superior de 95%
Com 95% de confiança, a taxa verdadeira não passa deste valor. É calculado de forma exata (binomial) e vale mesmo com amostras pequenas ou nenhum erro encontrado. Se ele fica abaixo da meta (5% ou 2%), a meta está provada; se não, a amostra ainda é pequena demais.
Amostra com zero erros
Quantas páginas a pessoa precisa conferir, sem achar nenhuma aplicação perdida, para provar que a taxa de falso negativo está abaixo da meta. O número é calculado pelo sistema e cresce quando a meta fica mais rigorosa. Se aparecer algum erro, é preciso conferir mais.
Prontidão metodológica
Quanto já foi rotulado por uma pessoa em relação ao mínimo que cada análise exige para rodar: a regressão logística (H2) pede 200 achados verificados e 40 na classe menos frequente; a análise bibliométrica (H5), 50 decisões de triagem e 10 de cada tipo; a auditoria dos negativos, o número de páginas calculado pelo sistema (59 para a meta de 5%). Os números são os mesmos que os scripts de análise usam para recusar ou rodar. Aparece na página inicial e em Análises, Visão geral. Para gerar só as linhas que faltam: python main.py rotulagem-modelo.
Classe minoritária
Na regressão logística, o menor dos dois grupos do desfecho (achados confirmados ou achados descartados). Com poucos casos num dos grupos o ajuste não é confiável; por isso a análise exige pelo menos 40 na classe minoritária, além dos 200 achados verificados.
Amostra enriquecida
Seleção em que entram de propósito os itens com mais chance de erro (evidência que não confere ou que não cita a tecnologia, texto só de snippet, confiança baixa), para que o grupo menos frequente chegue ao mínimo. Serve à regressão, mas NÃO estima a precisão global do modelo, porque os erros estão em excesso na amostra. Para a precisão global é preciso uma amostra aleatória (rotulagem-modelo --aleatoria).
Folga da rotulagem
Margem percentual (padrão 10%) somada ao que falta para o mínimo, para cobrir linhas que a pessoa pule ou deixe em branco. A folga não vale para a auditoria dos negativos nem para a amostra extra de falsa exclusão, cujos tamanhos já supõem zero erros.
Página não verificável
Página que o download não conseguiu verificar porque o robots.txt do site seguiu inacessível (erro do servidor, tempo esgotado ou falha de rede) em três leituras seguidas ou em pelo menos duas tentativas de download. Não é o mesmo que proibida pelo site: não sabemos o que o site decidiu. Por política (RFC 9309) ela fica fora da coleta, e o levantamento pode ter deixado de ver conteúdo nela.
Página inexistente (404 ou 410)
A última tentativa de baixar a página recebeu o erro 404 ou 410: ela não existe mais ou mudou de endereço. É uma falha da página, não uma proibição do site nem uma falha da coleta.
Última tentativa de download
Uma mesma página pode ter sido tentada em mais de uma execução. Para dizer o que ficou sem verificação vale só a tentativa mais recente de cada página: se a segunda tentativa deu certo, a falha da primeira não conta.