Pular para o conteúdo principal

Solução de problemas do Bridge

Bridge não conecta​

Sintoma: status "Desconectado" ou "Conectando..." por muito tempo.

Soluções:

  1. Verifique se a URL do servidor está correta (https://app.neurai-platform.com)
  2. Confirme que o token está correto e não expirou (gere um novo em Agentes Locais)
  3. Verifique sua conexão com a internet
  4. Firewalls corporativos podem bloquear WebSocket — tente em outra rede

Agente aparece offline na plataforma​

Sintoma: o Bridge está rodando localmente, mas a plataforma mostra o agente como offline.

Soluções:

  1. Verifique o status no painel do Bridge (http://localhost:48765)
  2. Clique em Reconectar no painel
  3. Reinicie o Bridge
  4. Gere um novo token e reconfigure

Comandos falham com "permission denied"​

Sintoma: o agente tenta executar um comando e recebe erro de permissão.

Soluções:

  • No Linux/macOS: verifique as permissões do diretório de trabalho
  • No Windows: execute o Bridge como administrador se necessário
  • Confirme que o usuário que roda o Bridge tem acesso aos arquivos do projeto

LM Studio / Ollama não é detectado​

Sintoma: o agente não consegue se conectar ao modelo local mesmo com o Bridge ativo.

Soluções:

  1. Confirme que o LM Studio está com o servidor iniciado (porta 1234)
  2. Confirme que o Ollama está rodando: ollama list deve retornar modelos
  3. No NeurAI, no modo de conexão do provedor, certifique-se de selecionar Bridge
  4. A URL no NeurAI deve ser http://localhost:1234/v1 (LM Studio) ou http://localhost:11434/v1 (Ollama)

Runtimes não detectados​

Sintoma: o Bridge conecta mas o agente diz que Node.js / Python não está instalado.

Causa: o Bridge detecta runtimes no PATH do sistema. Se Node.js foi instalado via nvm, fnm ou versão personalizada, pode não estar no PATH padrão.

Solução:

  • No Windows: adicione o Node.js ao PATH do sistema (não apenas do usuário)
  • No Linux/macOS: certifique-se que o runtime está acessível sem ativar nvm manualmente (ex: adicione ao .bashrc)

Interface web não abre​

Sintoma: o Bridge inicia mas http://localhost:48765 não carrega.

Soluções:

  1. Verifique se a porta 48765 não está em uso por outro processo
  2. Tente abrir manualmente no navegador
  3. Execute com --no-ui se a interface não for necessária

Logs do Bridge​

Para diagnóstico, execute com output no terminal:

neurai-bridge --server https://app.neurai-platform.com --token SEU_TOKEN --no-ui 2>&1 | tee bridge.log

Os logs mostram tentativas de conexão, ferramentas executadas e erros detalhados.