Pular para o conteúdo principal

Perguntas frequentes

Primeiros passos

O NeurAI tem um modelo de IA próprio?

Não. O NeurAI é uma plataforma de agente que se conecta ao modelo de IA da sua escolha: OpenAI, Anthropic, DeepSeek, LM Studio ou Ollama. Você traz sua própria chave de API ou usa modelos locais gratuitos.

Preciso saber programar para usar o NeurAI?

Não é obrigatório, mas o NeurAI é otimizado para desenvolvedores. Se você entende o básico de terminal e Git, já consegue aproveitar a plataforma ao máximo.

Posso usar o NeurAI sem pagar nada?

Sim. Com o NeurAI Bridge instalado e o Ollama ou LM Studio configurado, você usa modelos de IA gratuitos e locais sem nenhum custo de API.

Qual modelo de IA devo usar para começar?

  • Máxima qualidade com custo controlado: OpenAI gpt-4o ou Anthropic claude-3-5-sonnet
  • Custo mais baixo: DeepSeek deepseek-chat ou OpenAI gpt-4o-mini
  • Gratuito e privado: Ollama com llama3.1 ou qwen2.5-coder (requer Bridge)

Projetos e chat

Qual a diferença entre um projeto e uma sessão?

Um projeto é permanente — tem um diretório de trabalho, contexto e configurações que persistem sempre. Uma sessão é uma conversa individual dentro do projeto — o histórico é da sessão, mas o contexto do projeto aparece em todas elas.

O agente lembra do que fizemos na última conversa?

O histórico de mensagens é por sessão. Ao iniciar uma nova sessão, o agente começa com o contexto do projeto (que você definiu), mas sem memória das conversas anteriores. Para coisas que o agente sempre deve saber, coloque no contexto do projeto.

Posso usar o NeurAI sem criar um projeto?

Não diretamente — toda sessão precisa de um projeto. Mas criar um projeto leva menos de 1 minuto e você pode deixar o contexto vazio por enquanto.

O agente pode abrir arquivos de qualquer pasta do meu computador?

Sim, desde que o Bridge esteja instalado e o diretório de trabalho do projeto aponte para a pasta desejada. Fora do diretório de trabalho, o agente pode acessar outros caminhos se você fornecer o caminho absoluto.


Bridge e modelos locais

O Bridge precisa de internet para funcionar?

O Bridge precisa de internet para se comunicar com a plataforma NeurAI. Mas se você usar modelos locais (Ollama/LM Studio), as chamadas de IA ficam inteiramente na sua máquina — apenas a orquestração passa pelo servidor.

Posso instalar o Bridge em múltiplas máquinas?

Sim. Cada máquina precisa de um token próprio — gere um token diferente para cada máquina em Agentes Locais. Você pode ter vários Bridges ativos ao mesmo tempo.

O Bridge abre portas no meu roteador ou firewall?

Não. O Bridge inicia a conexão de saída (sua máquina → servidor NeurAI), então não é necessário abrir portas ou configurar port forwarding. A conexão usa WebSocket sobre HTTPS.

LM Studio ou Ollama — qual é melhor?

Depende da preferência:

  • LM Studio: tem interface gráfica, boa para quem prefere não usar o terminal, muitos modelos no catálogo
  • Ollama: mais simples, via linha de comando, inicia como serviço automaticamente, ideal para servidores headless

Ambos funcionam igualmente bem com o NeurAI.


Execução e ferramentas

O agente pode deletar arquivos importantes acidentalmente?

No modo Seguro e Padrão, o agente pede confirmação antes de deletar arquivos. No modo Autônomo, ele pode deletar sem confirmar — use com cautela. Para projetos críticos, prefira o modo Padrão.

O agente consegue fazer commits e push no Git?

Sim. O agente pode executar git add, git commit e git stash. Push requer confirmação explícita — o agente não faz push sem você pedir.

Posso usar o NeurAI para fazer deploy em produção?

Sim, mas com cuidado. Configure o projeto com o ambiente SSH do servidor de produção e use o modo Padrão para revisar cada ação antes de aprovar. Muitos usuários usam o NeurAI para deploys em staging e revisam manualmente antes de produção.

O agente consegue executar scripts Python, rodar testes e instalar pacotes?

Sim para tudo isso. O agente detecta automaticamente o gerenciador de pacotes (npm/pip/cargo/go) e o test runner (Jest, pytest, Go test, etc.) e usa os comandos corretos.


Segurança e privacidade

Meu código é enviado para a OpenAI ou Anthropic?

Se você usar esses provedores, sim — o conteúdo dos arquivos que o agente lê é enviado para o modelo de IA como contexto. Se privacidade é crítica, use modelos locais via Bridge + LM Studio/Ollama.

O NeurAI armazena meu código?

O NeurAI armazena o histórico das sessões (mensagens e resultados de ferramentas) nos servidores da plataforma. Arquivos do seu sistema de arquivos são lidos pelo agente no momento da conversa — não há upload permanente de repositórios.

Posso revogar o acesso do Bridge à minha máquina?

Sim. Vá em Agentes Locais, selecione o agente e clique em Revogar token. O Bridge perde acesso imediatamente. Você também pode simplesmente fechar o Bridge no seu computador.


Solução de problemas rápidos

O agente parou de responder no meio de uma tarefa

Aguarde alguns segundos — pode ser uma ferramenta lenta (comando pesado, download). Se não retomar, pressione Esc para cancelar e reenvie a mensagem.

Aparece "Nenhum provedor de IA ativo"

Vá em Provedores de IA, configure um provedor e clique em Ativar. Guia completo →

O Bridge está "Online" mas o agente diz que não consegue executar comandos

Verifique se o ambiente do projeto está configurado para usar o Bridge (e não o servidor local ou um SSH). Edite o projeto e selecione o Bridge correto no campo Ambiente.

Ver mais soluções de problemas →