Solução de problemas

A maioria dos problemas aparece como um aviso: uma mensagem que indica o que parou e o motivo. Esta página cobre os que as pessoas encontram mais.

Instalação e inicialização

O Windows diz que o instalador é de um editor desconhecido. As compilações ainda não têm assinatura de código. Escolha Mais informações e, em seguida, Executar assim mesmo.

O aplicativo para macOS não se atualiza sozinho. Aplicativos para macOS sem assinatura não conseguem. Baixe a nova versão na página de lançamentos e instale-a por cima da antiga.

O aplicativo diz que sua porta está ocupada. Outra coisa está ouvindo onde o processo local do aplicativo (o gateway) quer iniciar, geralmente uma cópia antiga que não foi encerrada. O painel nomeia o processo e oferece encerrá-lo (Encerrar esse gateway para um Perfica antigo, caso contrário Encerrar seguido pelo seu nome ou PID), ou Usar outra porta desta vez apenas para esta sessão.

O aplicativo diz O gateway não pôde ser iniciado. O processo local travou ou não respondeu dentro de um minuto. O painel mostra as últimas linhas que ele imprimiu. Pressione Tentar novamente; se falhar de novo, relate o bug com essas linhas.

Eu fechei a janela e o aplicativo continua rodando. Isso é intencional, para que os loops continuem rodando. Encerre com Sair do Perfica no menu da bandeja.

Um loop parou

Um loop que para diz o motivo, em um aviso e em seu painel no canvas. Os motivos comuns:

O que o aplicativo diz	O que fazer
O loop atingiu suas máximas execuções ou seus limites de erro	Leia a aba Log do Manager para ver qual bubble continuava falhando. Corrija a causa ou aumente o limite nas configurações do loop e pressione Play.
Não há trabalho restante: cartões estão aguardando em Draft	Aprove os cartões em que deseja que se trabalhe e pressione Play.
Os cartões estão aguardando uns aos outros	Dois ou mais cartões dependem um do outro. Abra o Task Book e pressione Parar de aguardar em um deles.
A cota do modelo esgotou, com o horário em que ele tenta novamente	Nada: o loop reinicia sozinho nesse horário e continua tentando enquanto o quadro for deixado sozinho. Pressione Play para tentar agora, Adicionar uma chave paga para continuar sem esperar, ou use um pool.
O provedor do modelo parou de responder	O provedor não respondeu mesmo depois que o Perfica perguntou novamente três vezes ao longo de cerca de sete segundos. Nenhum erro foi contabilizado. Verifique se ele está rodando e pressione Play.
O orçamento de passadas do quadro está esgotado	As máximas execuções de cada loop, somadas, formam o orçamento do quadro. Aumente o máximo no loop que você quer que vá mais longe.

Depois de corrigir uma parada, Play limpa as contagens de erro do loop e o inicia novamente.

Uma passada terminou em ERROR

ERROR significa que o agente nunca chegou a rodar de verdade. Causas comuns:

• A chave pertence a outro provedor. Um bubble aponta para uma chave salva para um provedor diferente. Escolha a chave certa no inspetor do bubble.
• O modelo não consegue fazer o trabalho. Alguns modelos pequenos não conseguem chamar ferramentas nem manter a estrutura da resposta. Escolha um modelo maior para esse bubble.
• Uma imagem, e ninguém para vê-la. O modelo do bubble não consegue ver imagens e nenhum modelo de visão está configurado. Defina um na página Models em Modelos auxiliares.

Comandos e ferramentas

“Um comando foi recusado porque não pôde ser colocado em sandbox”. O sandbox está ligado, mas seu backend não está pronto. Settings › Autonomy › Command sandbox mostra a única etapa para corrigi-lo e o comando exato para copiar. Os comandos ficam recusados até lá; eles nunca rodam sem sandbox.

“Os agentes precisam do Git for Windows para executar linhas de comando”. Os agentes precisam do Git for Windows para executar correntes de comandos e redirecionamentos. Instale-o. Nada precisa ser reiniciado: o próximo comando o procura novamente.

Um comando aguarda por uma resposta que nunca chega. As aprovações aparecem na janela do aplicativo. Se nenhuma janela estiver aberta, o comando será recusado em vez de aguardar.

“Os agentes precisam de um navegador para ver o aplicativo em execução”. A revisão visual e as ferramentas de navegador precisam do Chrome, Edge ou de um Chromium baixado. Settings › Autonomy › Agent browser oferece o download. Nada precisa ser reiniciado.

A busca na web diz que está fora do ar. A busca integrada não respondeu, então os resultados vieram apenas do npm, GitHub, Stack Overflow, MDN e Wikipedia. Ela reinicia na próxima busca. Uma chave da Brave ou Tavily envia cada busca para esse serviço em vez da integrada.

A prévia

A prévia não vai iniciar. As prévias precisam de um script dev ou start no package.json do projeto (ou em uma pasta de primeiro nível). Um quadro que coloca comandos em sandbox não pode rodar um. Se ele travou, a aba Report mostra o código de saída e as últimas linhas do seu log.

Nenhum relatório final após uma execução. Apenas execuções que ficaram sem trabalho por conta própria entregam o relatório. Uma execução que você pausou ou parou, ou uma que atingiu um limite, não escreve um relatório. Para obter um mesmo assim, abra a aba Report do Manager e pressione Escrever relatório.