Solução de problemas e perguntas frequentes

Comece pela mensagem da operação que falhou e depois confira o status do projeto, do Agente e da tarefa. As seções abaixo indicam onde procurar ajuda para problemas comuns.

A configuração inicial não permite entrar na área de trabalho

A configuração inicial exige pelo menos um Agente instalado, com login feito e verificado. Apenas instalar ou fechar a janela de login não basta: a lista precisa mostrar Pronto.

Abra os detalhes desse Agente, resolva os problemas de login, rede ou verificação e confira novamente. Consulte Instalar e preparar o Noea.

Um download falha ou fica em preparação

Confira primeiro a rede e o proxy HTTP(S) do sistema. Variáveis de ambiente de proxy têm prioridade; esse mecanismo não oferece suporte a proxies SOCKS. O status de preparação pode aparecer quando o download para de receber dados. Observe as atualizações e tente novamente se uma falha for informada.

Se as falhas se repetirem, copie os diagnósticos do Agente e anote se o problema ocorreu durante o download do ambiente de execução, a instalação do Agente ou a verificação da conexão.

O login funcionou, mas o Agente continua indisponível

O Noea usa os resultados da verificação para decidir se um Agente está pronto. Confira a conta ou o provedor, a cota disponível e a configuração do modelo. No OpenCode, atualize a lista de provedores, confirme a conexão e verifique novamente.

Se a seleção de modelo exigir uma conexão primeiro, conecte uma sessão e confira novamente. Uma configuração aceita por um Agente não é automaticamente aceita por outro.

Um projeto não abre

A intenção pode ser lida, mas as conversas não começam

Confira a pasta de implementação em Ajustes → Projeto atual → Projeto. Vincule uma se nenhuma estiver vinculada ou relocalize a pasta de código original se o caminho antigo estiver inacessível.

Confira também se o Agente está Pronto. Arquivos de intenção legíveis não significam que a pasta de implementação e o Agente também estão prontos.

Uma explicação está ausente ou parece errada

Salve a intenção e depois investigue o parágrafo relevante ou execute Explicar pela barra lateral. Se o requisito precisar de mudanças de código, implemente-o na conversa antes de investigar.

Texto anterior se refere à intenção antes de uma edição. Pode estar desatualizado significa que arquivos de apoio mudaram depois. Confira ambos com o conteúdo atual; consulte Manter as explicações atualizadas.

Nenhuma alteração encontrada na barra lateral não significa que todos os testes passaram ou que não restam lacunas.

Explicar não foi executado após a implementação

Confira Ajustes → Projeto atual → Automação → Explicar automaticamente após implementar. Mudanças apenas de código em conversas comuns, Implementar Diretamente e execuções de implementação interrompidas ou com falha não acionam essa tarefa.

Execute Explicar manualmente quando necessário. Se uma tarefa terminou, mas ainda relata verificações com falha ou incompletas, expanda os resultados, resolva a causa e execute novamente. Veja as regras completas de acionamento automático.

Uma proposta ou plano de organização não pode ser aceito

Se uma proposta disser que o documento mudou, escolha Pedir ao Agente Nova Proposta na Versão Atual. Para um plano de organização desatualizado, escolha Reorganizar.

Propostas comuns permitem editar texto inserido ou de substituição, mas não aceitar alterações ou arquivos individualmente. Rascunhos organizados são somente leitura; você pode manter exclusões propostas antes de aceitar o plano inteiro.

Você deve reenviar uma mensagem que falhou?

Se o Noea disser que a mensagem não foi entregue ao Agente, você pode tentar novamente. Se ela pode ter sido entregue, examine primeiro o registro de execução e as alterações de arquivos para evitar execução duplicada.

Se o Agente recebeu a mensagem, mas parou no meio da tarefa, envie uma nova instrução para conferir o estado atual e continuar. Um cartão de proposta marcado como Implementação não terminada também oferece Continuar Implementando.

Editar uma mensagem, ramificar uma conversa ou parar uma execução não reverte alterações de arquivos.

Um servidor MCP ou Skill não está funcionando

Para MCP, use Testar conexão e confira comando, URL, autorização e variáveis de ambiente indicados pelo resultado. Mesmo depois de um teste bem-sucedido, confirme que o servidor está selecionado na conversa e que o Agente oferece suporte ao método de conexão.

Mudanças de configuração MCP exigem uma reconexão do Agente. Adicionar ou remover um Skill exige uma nova conversa. Tarefas de Explicar e organização não usam essas extensões. Consulte Adicionar servidores MCP e Skills.

O salvamento falha ou uma referência não abre

Um conflito ao salvar significa que outra operação alterou o arquivo no disco enquanto você o editava. Salve seu conteúdo atual separadamente ou recarregue a versão do disco. Recarregar descarta edições não salvas.

Para uma referência quebrada, confira se o arquivo ou material ainda existe e se a pasta de implementação está acessível. Se uma explicação antiga não corresponder mais ao documento, volte ao parágrafo para ler a explicação mais recente e investigue novamente, se necessário.

Envie informações úteis à equipe

Use Feedback na barra lateral para descrever seu objetivo, o resultado real e as etapas que levaram ao problema. Deixe um endereço de e-mail para acompanhamento ou entre em contato pelo endereço [email protected].

Se forem necessários diagnósticos, exporte-os em Ajustes → Sobre ou copie-os do painel de detalhes do Agente. Diagnósticos podem conter estado local e logs, então revise-os antes de compartilhar. O feedback não anexa esses arquivos automaticamente.