Pular para o conteúdo principal

Conectando o Bridge ao NeurAI

Pré-requisitos​

  1. Bridge instalado na sua máquina (Windows / Linux / macOS)
  2. Token gerado na plataforma (Agentes Locais → Novo agente local)

Formas de configurar​

Via interface web (recomendado)​

  1. Inicie o Bridge (duplo clique no executável ou neurai-bridge no terminal)
  2. O Bridge abre http://localhost:48765 no navegador
  3. Preencha a URL do servidor: https://app.neurai-platform.com
  4. Preencha o token
  5. Clique em Conectar

Via linha de comando​

neurai-bridge --server https://app.neurai-platform.com --token SEU_TOKEN

Via variáveis de ambiente​

NEURAI_SERVER=https://app.neurai-platform.com NEURAI_TOKEN=SEU_TOKEN neurai-bridge

Verificando a conexão​

Na interface web do Bridge (http://localhost:48765): você verá o status "Conectado" com a URL do servidor.

Na plataforma NeurAI (Agentes Locais): o agente aparece como Online com o nome que você definiu e o hostname da máquina.

Reconexão automática​

O Bridge se reconecta automaticamente se a conexão cair. O intervalo aumenta progressivamente (backoff exponencial) de 3 segundos até no máximo 30 segundos.

Configurando o projeto para usar o Bridge​

  1. Crie ou edite um projeto no NeurAI
  2. No campo Ambiente, selecione o Bridge conectado (ex: "Meu PC - Escritório")
  3. Defina o diretório de trabalho no seu computador local (ex: C:\Projetos\meu-app)
  4. Salve

Agora todas as operações de arquivo e comandos do projeto rodarão na sua máquina.

Segurança​

  • O Bridge usa WebSocket seguro (WSS) quando o servidor usa HTTPS
  • Autenticação via token único por agente
  • Não abre portas na sua rede — a conexão é iniciada pela sua máquina
  • Você pode revogar o token a qualquer momento em Agentes Locais