Docs do Qalibr — seu guia para a inteligência de intake de bugs. Comece um teste grátis →
PortuguêsConceitos principaisDetecção de duplicatas
Conceitos principais

Detecção de duplicatas

A maioria dos times reporta o mesmo bug de três a sete vezes antes de alguém perceber. O Qalibr captura as repetições para que cada uma não gere um ticket.

Ele precisa do seu backlog primeiro

O Qalibr compara novos relatos com os issues que indexou do seu tracker — não com uma ideia genérica do que é um bug. Então a primeira coisa que acontece quando você conecta o Linear ou o Jira é o Qalibr começar a ler o seu backlog existente: o time ou projeto configurado inteiro, não só os tickets que o Qalibr criou.

  • A indexação começa imediatamente na conexão e depois roda a cada 30 minutos, aproximadamente.
  • Cada passada indexa até 2.000 issues, então um projeto grande vai se completando ao longo de várias passadas — um backlog de alguns milhares de issues normalmente fica completo em algumas horas. Os tickets que o Qalibr cria são indexados no momento da criação.
  • O cabeçalho do dashboard mostra uma contagem de Tickets indexados para você acompanhar.

Enquanto nada estiver indexado, não há com o que comparar, e um relato simplesmente não vai mostrar candidatas a duplicata. Isso é idêntico a “verificamos e não encontramos nada” — então, se você está na primeira hora e não vê candidatas, é por isso.

Se um relato do Slack encontrar um índice vazio, o Qalibr avisa na thread em vez de ficar em silêncio.

Pontuação de correspondência

Quando um novo relato chega, o Qalibr o compara com os issues indexados e apresenta as correspondências mais próximas, cada uma com uma Pontuação de correspondência — exibida como porcentagem (por exemplo, 94% de correspondência). Quanto maior a pontuação, mais confiável a correspondência.

Por padrão ele busca nos seus issues abertos mais qualquer um fechado nos últimos 30 dias, para que um bug que acabou de voltar ainda encontre seu ticket.

A porcentagem é o quanto os dois relatos se parecem. Por trás dela, o Qalibr também pesa uma assinatura de erro compartilhada, palavras-chave em comum e um título semelhante, e é deliberadamente mais cauteloso quando um relato tem poucos detalhes — isso decide quais candidatas vale mostrar e em que ordem, em vez de mexer na porcentagem em si.

Você vê no máximo três candidatas, e apenas as que passam do limiar.

O que você pode fazer com uma correspondência

Quando o Qalibr apresenta candidatas, você escolhe o que acontece — no dashboard:

AçãoResultado
Vincular a esteAdiciona um comentário ao issue existente. Sem um segundo ticket. Funciona também em um issue fechado, sem reabri-lo.
Reabrir como duplicataReabre um issue fechado e vincula o novo relato a ele. Oferecido apenas quando a candidata está fechada.
Rejeitar como duplicataMarca o relato como duplicata confirmada — sem novo ticket e, deliberadamente, sem comentário no original, para você não adicionar ruído a um ticket sobre o qual já decidiu.
Nenhum destes — rotear como novoNenhuma das candidatas se encaixa. O Qalibr abre um ticket novo.

Reabrir funciona no Linear e no Jira. Se o ticket não puder voltar a um estado aberto, o Qalibr registra um ticket novo vinculado ao fechado em vez de falhar.

O Slack mostra os issues semelhantes que ele encontrou, mas a escolha entre eles acontece no dashboard.

Se nada passar do limiar, não há o que decidir — o Qalibr simplesmente roteia o relato como um novo bug quando você aprova. Ele nunca bloqueia um ticket por causa de uma duplicata sem perguntar.

Onde as duplicatas ficam

Relatos que você incorpora a um issue existente — vinculados, reabertos ou rejeitados como duplicata — aparecem no filtro Duplicatas do seu Inbox. Um relato que precisou virar um ticket novo vinculado a um fechado conta como Roteado.

O indicador Taxa de dedup · 30d na tela inicial do seu dashboard acompanha quantas repetições o Qalibr está capturando. Veja O dashboard.