Solução de problemas
Problemas de conta e acesso
Não recebi o e-mail de confirmação
- Verifique a pasta de spam/lixo eletrônico
- Aguarde até 5 minutos
- Em Conta → Perfil, clique em Reenviar e-mail de verificação
Esqueci minha senha
Na tela de login, clique em Esqueci minha senha, informe seu e-mail e siga o link recebido. O link expira em 1 hora.
Não recebi o código OTP do 2FA
- Verifique a pasta de spam (se for por e-mail)
- Aguarde até 60 segundos — SMS pode ter leve atraso
- Clique em Reenviar código na tela de verificação
- Confirme que o número de telefone ou e-mail cadastrado está correto em Conta → Segurança
- Se não conseguir acesso, entre em contato com o suporte informando o e-mail da conta
Problemas com o agente
O agente não responde / está "travado"
- Aguarde 30 segundos — algumas ferramentas demoram (builds, downloads)
- Pressione
Escou clique no botão de parar - Reenvie a mensagem
- Se persistir, recarregue a página e tente novamente
O agente diz "Nenhum provedor de IA ativo"
Você precisa configurar e ativar um provedor de IA:
- Vá em Provedores de IA
- Escolha um provedor (OpenAI, Anthropic, etc.)
- Configure e clique em Ativar
O agente está muito lento
- Verifique sua conexão com a internet
- Se usar modelos locais, o hardware pode ser o gargalo (GPU ou RAM insuficiente)
- Tente um modelo menor ou mais rápido (ex:
gpt-4o-miniem vez degpt-4o)
O agente responde em inglês
Verifique se o agente personalizado ativo tem instruções em inglês — isso pode sobrescrever o comportamento padrão. Adicione ao agente: "Sempre responda em português".
Problemas com o Bridge
Consulte a página de solução de problemas do Bridge para guias específicos.
Problemas mais comuns:
- Bridge não conecta → verificar token e URL do servidor
- Comandos falham → verificar permissões do diretório
- Modelos locais não detectados → verificar modo de conexão no provedor
Problemas com projetos
O agente não encontra os arquivos do projeto
- Verifique o diretório de trabalho nas configurações do projeto — o caminho deve existir
- Se usa Bridge, confirme que o Bridge está online e o diretório está na sua máquina local
- Se usa SSH, confirme que o servidor está acessível e o caminho existe
Erros ao executar comandos
- "Permission denied": o usuário não tem permissão no diretório — ajuste as permissões ou use um usuário com acesso
- "Command not found": a ferramenta não está instalada ou não está no PATH
- "Port already in use": a porta está ocupada — o agente usa
free_portpara detectar isso automaticamente
Problemas com modelos locais (LM Studio / Ollama)
O modelo local não responde
- Confirme que o LM Studio/Ollama está rodando e com um modelo carregado
- No NeurAI, o modo de conexão deve ser Bridge (não Direto)
- Confirme que o Bridge está online
- Teste no terminal:
curl http://localhost:1234/v1/models(LM Studio) ouollama list(Ollama)
Respostas de baixa qualidade com modelo local
Modelos menores (3B) têm capacidade limitada para tarefas complexas. Experimente:
- Um modelo maior (7B ou 13B) se o hardware permitir
Qwen 2.5 Coderpara tarefas de código- Reformule o prompt com instruções mais específicas
Onde obter mais ajuda
- GitHub Issues — reporte bugs ou solicite funcionalidades
- Consulte a documentação completa para guias detalhados