Como resolver uma issue de qualidade

O que são issues de qualidade

Issues são problemas identificados automaticamente pelo sistema ao analisar as conversas e o desempenho do bot. Elas aparecem no painel de qualidade e indicam situações que merecem sua atenção.

Tipos de issue e o que fazer

Pre-flight bloqueado (CRITICAL)

O que significa: O pre-flight mais recente falhou em testes críticos.

O que fazer: Acesse Qualidade > Testes, abra o resultado do pre-flight e leia o comentário de cada caso reprovado. Corrija os problemas indicados (na KB, na persona ou na ferramenta) e execute um novo pre-flight.

Alta taxa de handoff

O que significa: Muitas conversas estão sendo transferidas para humanos.

O que fazer: Verifique os motivos de handoff no dashboard. Se for "baixa confiança", adicione documentos à KB cobrindo os tópicos mais perguntados. Se for "falha de ferramenta", verifique a saúde das Custom Tools.

Baixa confiança nas respostas (LOW_RAG_CONFIDENCE)

O que significa: O bot frequentemente não encontra informação relevante na KB.

O que fazer: Adicione documentos à KB cobrindo os tópicos em que o bot tem baixa confiança. Use a busca da KB para testar quais trechos o bot encontra para perguntas específicas.

Sem conteúdo na KB (NO_KB_CONTENT)

O que significa: A base de conhecimento está vazia ou com poucos documentos.

O que fazer: Adicione documentos à KB com as perguntas e respostas mais frequentes da sua operação.

Readiness desatualizado

O que significa: O pre-flight não é executado há mais de 7 dias.

O que fazer: Execute um novo pre-flight.

Alta taxa de falha de ferramenta

O que significa: Uma ou mais Custom Tools estão falhando com frequência.

O que fazer: Acesse Custom Tools e verifique o health check de cada ferramenta. Verifique se a API externa está acessível e se as credenciais estão corretas.

Ciclo de vida de uma issue

1. Aberta — identificada, aguardando ação
2. Em revisão — você está investigando
3. Resolvida — o problema foi corrigido

Como marcar uma issue como resolvida

1. Abra a issue no painel de qualidade
2. Faça a correção necessária (na KB, na ferramenta, no pre-flight, etc.)
3. Clique em Marcar como resolvida
4. Opcionalmente, adicione uma nota descrevendo o que foi feito

Não ignore issues críticas. Issues marcadas com severidade Crítica indicam problemas que afetam diretamente a experiência do cliente. Resolva-as com prioridade.