Pular para o conteúdo principal

Solução de Problemas

Problemas comuns e como corrigi-los.

Problemas de Provider​

"Error: 401 Unauthorized"​

  • Causa: Chave de API inválida.
  • Correção: Vá em Settings > Providers. Reinsira sua chave de API. Certifique-se de que não há espaços extras ou quebras de linha.

"Error: 403 Forbidden"​

  • Causa: Sua chave de API não tem acesso ao modelo solicitado.
  • Correção:
    • Para OpenAI: Alguns modelos exigem um plano pago. Verifique seu acesso em platform.openai.com.
    • Para Anthropic: Certifique-se de que sua conta tem acesso ao modelo Claude que você está solicitando.

"Error: 429 Too Many Requests"​

  • Causa: Você atingiu o limite de taxa ou ficou sem créditos.
  • Correção:
    • Aguarde alguns minutos e tente novamente (limite de taxa).
    • Verifique seu status de faturamento e adicione créditos no site do provider.
    • Considere mudar temporariamente para outro provider.

"Error: 500 Internal Server Error"​

  • Causa: Os servidores do provider estão passando por problemas.
  • Correção: Aguarde alguns minutos e tente novamente. Verifique a página de status do provider.

"Connection Refused" (Ollama)​

  • Causa: O Rephlo não consegue se comunicar com o servidor de IA local.
  • Correção:
    1. Abra um terminal e execute ollama serve.
    2. Verifique se está rodando: acesse http://localhost:11434 em um navegador.
    3. Verifique se outro aplicativo está usando a porta 11434.

"Model Not Found" (Ollama)​

  • Causa: O modelo solicitado não foi baixado.
  • Correção: Execute ollama pull [model-name] no seu terminal (por exemplo, ollama pull llama3).

Problemas de Interface​

"Hotkeys are not working"​

  • Causa (Windows/Linux): Outro aplicativo (como PowerToys ou um jogo) pode ter "roubado" a tecla de atalho.
  • Correção: Vá em Settings > Hotkeys e mude o gatilho para outro (por exemplo, Ctrl + Shift + Alt + Z).

Usuários de macOS: veja Problemas Específicos do macOS abaixo para solução de problemas de teclas de atalho no macOS.

"Tray Icon is Missing"​

  • Causa: O Windows pode tê-lo ocultado no menu de "overflow".
  • Correção: Clique na seta ^ próxima ao relógio. Arraste o ícone do Rephlo para a área principal da barra de tarefas.

Problemas de Recursos​

"Vision/Screenshot not working"​

  • Causa (Windows): As permissões de gravação de tela podem estar negadas nas configurações de privacidade do Windows.
  • Correção (Windows): Execute o Rephlo como Administrador ou verifique Windows Privacy settings > Camera / Screen capture.
  • Causa (macOS): O Rephlo requer permissão de Screen Recording.
  • Correção (macOS): veja Problemas Específicos do macOS abaixo para os passos detalhados.

"Space is not answering questions"​

  • Causa: O space pode estar vazio ou a ingestão pode ter falhado.
  • Correção: Verifique os detalhes do Space. Certifique-se de que os arquivos estão listados e o status diz "Ready". Tente limpar o cache em Advanced Settings.

"Variable not found in Space"​

  • Causa: Você está usando uma variável {{filename}}, mas o arquivo não está no Space ativo.
  • Correção:
    1. Verifique se o Space contém o arquivo referenciado.
    2. Confirme se o nome da variável corresponde ao nome do arquivo (convertido para snake_case, por exemplo, "Style Guide.pdf" -> {{style_guide_pdf}}).
    3. Certifique-se de que o Space correto está ativo.

Problemas Específicos do macOS​

"Hotkeys are not working" (macOS)​

  • Causa: O Rephlo requer permissão de Accessibility para detectar atalhos de teclado globais.
  • Correção:
    1. Abra System Settings > Privacy & Security > Accessibility.
    2. Encontre o Rephlo na lista e ative a opção.
    3. Se o Rephlo não estiver listado, feche e reabra o app.
    4. Reinicie o Rephlo após conceder a permissão.

Importante: as teclas de atalho globais só funcionam quando o Rephlo é executado como um bundle .app assinado. Se você é desenvolvedor e está executando dotnet run a partir do terminal, as teclas de atalho podem não funcionar. Veja o Tutorial de Configuração do macOS para compilar e executar o bundle .app.

"Screenshot / Vision not working" (macOS)​

  • Causa: O Rephlo requer permissão de Screen Recording para capturar o conteúdo da tela.
  • Correção:
    1. Abra System Settings > Privacy & Security > Screen Recording.
    2. Encontre o Rephlo na lista e ative a opção.
    3. Reinicie o Rephlo.

"Permission dialog keeps appearing"​

  • Causa: O Rephlo estava sendo executado sem uma assinatura de código estável. Cada recompilação altera o hash do binário, fazendo com que o macOS o trate como um novo app e redefina as permissões.
  • Correção: Use uma build de release assinada do Rephlo a partir da distribuição oficial. Depois de conceder as permissões uma vez ao app assinado, elas persistem entre atualizações.

"Overlay doesn't appear even after granting permissions"​

  • Correção:
    1. Feche o Rephlo completamente (clique com o botão direito no ícone da bandeja > Exit).
    2. Reabra a partir do bundle .app.
    3. Verifique se as permissões de Accessibility E Screen Recording estão concedidas.
    4. Tente o botão Test Overlay em Settings > Hotkeys.

Problemas de Desempenho​

"Responses are very slow"​

  • Causa: Vários fatores podem tornar as respostas mais lentas.
  • Correção:
    • Contexto de Space grande: considere compactar seu Space.
    • Provider lento: mude para um modelo mais rápido, como GPT-5.4 Mini ou Gemini 3.5 Flash, para respostas mais rápidas.
    • Modelo local (Ollama): certifique-se de que sua GPU está sendo utilizada. Verifique os logs do Ollama.

"App feels sluggish on startup"​

  • Causa: Carregamento de Spaces grandes ou muitos commands.
  • Correção: Arquive commands não usados. Remova Spaces antigos que você não precisa mais.

Problemas de Chat​

"Chat history is missing"​

  • Causa: As conversas são armazenadas localmente e podem ter sido apagadas.
  • Correção: Verifique as configurações de retenção de histórico em Settings > Privacy. Se estiver definido como "Immediate", o histórico não é preservado.

"Chat keeps forgetting context"​

  • Causa: Você excedeu a janela de contexto do provider.
  • Correção: Inicie uma nova conversa ou use um provider com uma janela de contexto maior. Verifique a documentação do seu provider para tamanhos específicos de janela de contexto.

Problemas de Variáveis e Templates​

"Variable not found" ou "Invalid variable"​

  • Causa: O nome da variável não corresponde a uma variável de sistema válida ou a um arquivo no seu Space.
  • Correção:
    • Use a sintaxe exata: {{input_content}}, {{space_data_all}} ou {{filename}}.
    • Para variáveis de arquivo: converta o nome do arquivo para snake_case (por exemplo, "Style Guide.pdf" -> {{style_guide_pdf}}).
    • Verifique se o arquivo existe no seu Space ativo.
    • Verifique se há erros de digitação — os nomes de variáveis não diferenciam maiúsculas de minúsculas, mas precisam ser escritos corretamente.

"Space variables ignored in Standalone mode"​

  • Causa: Commands em Standalone não injetam automaticamente os dados do Space.
  • Explicação: O modo Standalone oferece controle manual total. Variáveis como {{space_data_all}} não serão substituídas automaticamente.
  • Correção: Mude para o modo Combination para injeção automática de dados do Space, ou cole manualmente os dados do Space no seu prompt.

Problemas de Space​

"Space full" ou "Token budget exceeded"​

  • Causa: Seu Space excedeu o limite de tokens configurado.
  • Correção:
    1. Abra a visualização de dados do Space e revise o uso atual.
    2. Remova arquivos menos importantes do Space, ou aumente o orçamento de tokens (máximo de 1.000.000 de tokens) — isso reduz diretamente um Space que ultrapassou seu orçamento armazenado.
    3. Mude o data mode para 🗜️ Compact para armazenar resumos gerados por IA em vez do texto completo — isso reduz os tokens contabilizados do Space (confirme o custo em créditos). Em seguida, escolha um nível de compactação:
      • Conservative: Resumo mínimo (preserva detalhes).
      • Balanced: Resumo moderado (padrão, recomendado).
      • Aggressive: Resumo intenso (melhor para Spaces muito grandes).
      • Observação: para um Space muito grande (≈128.000 tokens ou mais), o Compact é desabilitado por design — remova arquivos ou aumente o orçamento em vez disso.
    4. Observação: o 🔍 Smart Search mantém cada requisição pequena, enviando apenas as passagens relevantes, mas conta o texto bruto completo no orçamento do Space — portanto, ele controla o custo por requisição, não um Space que ultrapassou seu limite armazenado.

"Space ingestion failed" (erro de PDF/documento)​

  • Causa: O arquivo não pôde ser processado — possivelmente corrompido, protegido por senha ou em um formato não suportado.
  • Correção:
    • Certifique-se de que o PDF não está protegido por senha.
    • Tente reexportar o documento a partir do aplicativo de origem.
    • Para PDFs digitalizados: o Rephlo extrai apenas texto — imagens dentro de PDFs não são lidas.
    • Verifique se o arquivo não está corrompido abrindo-o primeiro em outro aplicativo.

Problemas de Geração de Imagens​

"This prompt was blocked by our content policy"​

  • Causa: Seu prompt de imagem foi sinalizado pela moderação de conteúdo e rejeitado antes que a geração fosse executada.
  • Correção: Reescreva seu prompt para remover o conteúdo não permitido e tente novamente. Consulte a página Política de Conteúdo para saber o que não é permitido.

"Content moderation is temporarily unavailable"​

  • Causa: O serviço de moderação de conteúdo está temporariamente indisponível (uma interrupção transitória), então seu prompt não pôde ser verificado.
  • Correção: Aguarde um momento e tente novamente.

Obtendo Ajuda​

Como faço para reportar conteúdo de IA prejudicial ou inadequado?​

  • Correção:
    • Logado: clique no seu avatar na parte inferior da barra lateral > Help > Report inappropriate content.
    • A qualquer momento: abra Settings > About > Contact & Support > Report inappropriate content.
    • Isso abre rephlo.app/contact no seu navegador com a categoria de denúncia pré-selecionada.