Troubleshooting Inicial
Guia de diagnóstico para problemas comuns no primeiro ciclo de ativação.
1) Upload não conclui ou demora demais
Sinais comuns:
- Upload fica em processamento por tempo excessivo
- Falha intermitente em arquivos grandes
Verifique:
- Tamanho e formato do arquivo
- Conectividade da rede
- Se o conteúdo tem estrutura legível (texto selecionável)
Ações:
- Tente um arquivo menor para validar fluxo
- Divida documentos muito extensos
- Reenvie o upload e acompanhe o status no widget de progresso
2) Chat responde sem contexto esperado
Sinais comuns:
- Resposta genérica
- Falta de aderência ao conteúdo da base
Verifique:
- Se a base foi criada/importada corretamente
- Se o conteúdo está na visibilidade correta
- Se a pergunta descreve cenário real com detalhe suficiente
Ações:
- Refine a pergunta com contexto operacional
- Atualize títulos e estrutura dos documentos
- Adicione conteúdo faltante para o caso de uso testado
3) Chave de API não funciona
Sinais comuns:
- Erros de autenticação
- Requisições negadas
Verifique:
- Header
x-Api-Key presente
- Chave correta para o ambiente atual
- Chave ativa e não revogada
Ações:
- Gere uma nova chave e teste em chamada simples
- Revogue chaves antigas ou comprometidas
- Evite uso de chave de produção em ambientes de teste
4) Métricas não aparecem em AI Analytics
Sinais comuns:
- Dashboard vazio após primeiros testes
Verifique:
- Se houve uso real de chat com respostas concluídas
- Se o período de filtro está correto
- Se você está na organização certa
Ações:
- Execute novos testes com perguntas reais
- Ajuste o período de análise
- Valide o contexto da organização ativa no topo da aplicação
5) Acesso/permissão inconsistente
Sinais comuns:
- Usuário vê tela mas não consegue executar ação
Verifique:
- Papel do membro na organização (owner/admin/member)
- Permissões do recurso específico
Ações:
- Ajuste role de quem precisa administrar a ativação
- Padronize política de acesso por área
Quando abrir suporte
Se o problema persistir após os checks:
- Registre cenário, horário e passo a passo
- Inclua prints/erros retornados
- Envie para contato com o máximo de contexto operacional
