SyntheticSynthetic/Docs
ProdutosNovidades
Dashboard →

AE Agent

Solução de problemas

A maioria dos problemas se resume a três causas: o After Effects não foi reiniciado, a ferramenta errada foi instalada ou o provedor está lento. Veja abaixo os problemas mais comuns e como resolvê-los.

O painel não aparece

Depois de instalar a extensão, o painel só é carregado na inicialização. Feche o After Effects por completo (não só o projeto) e abra de novo; depois, verifique:

Window → Extensions → AE Agent
Se ainda não aparecer na lista, confirme que sua versão do After Effects é compatível com extensões CEP (CC 2021 ou mais recente) e que o .zxp foi instalado sem erros. Se necessário, reinstale com o ZXP Installer.

After Effects não conectado (ponto vermelho)

A barra superior mostra um ponto de status. Verde significa que o AE Agent está conectado ao After Effects; vermelho, que não está. Um ponto vermelho quase sempre significa que o After Effects não está aberto ou ainda não está totalmente pronto — confirme que o AE está rodando com um projeto aberto e, se o ponto não ficar verde, reinicie o painel.

CLI não detectada (assinatura)

Se o AE Agent não encontra a CLI da sua assinatura, a causa mais comum é que o app para desktop está instalado, mas a CLI não.

App para desktop ≠ CLI. Os apps para desktop do Claude / ChatGPT não são as ferramentas de linha de comando. Instale a CLI de verdade via npm (por exemplo, npm install -g @anthropic-ai/claude-code), faça login uma vez pelo fluxo OAuth no navegador e depois abra o seletor de modelos de novo.

Veja Como conectar um provedor para os passos completos de instalação.

O modelo excedeu o tempo limite

As assinaturas via CLI são mais lentas que as chamadas diretas à API, principalmente a assinatura do Gemini em tarefas longas de vários passos no modo Agente. Se uma solicitação exceder o tempo limite, clique em Tentar de novo ou mude para um modelo com chave de API nessa tarefa — as chaves de API costumam ser o caminho mais rápido para trabalhos pesados no modo Agente.

Os modelos somem ao recarregar

Às vezes, os modelos locais ou de assinatura detectados sumiam depois de recarregar o painel. Isso foi corrigido na versão mais recente. Atualize a extensão e, se a lista ainda parecer vazia, clique em Verificar de novo no seletor de modelos para detectá-los de novo.

Problemas de licença

Se sua licença não for validada, confirme que a chave foi digitada exatamente (sem espaços extras), que o plano está ativo e que você está dentro do limite de dispositivos. Você pode revisar e gerenciar as chaves em synthetic.com.ar/dashboard/licenses. Veja como ativar sua licença para mais detalhes.

Ainda com problemas? Abra um ticket em seu painel de suporte informando sua versão do After Effects, o sistema operacional e o provedor que você está usando — normalmente isso basta para identificar o problema rapidamente. Você também pode perguntar no nosso Discord.