Corrigir com IA: um clique quando uma publicação falha

Quando uma publicação falha na Mythex, o diálogo agora diz-lhe o que aconteceu de facto e apresenta dois botões em cada falha: Corrigir com IA e Tentar novamente. Corrigir com IA entrega ao agente a falha e o que a sua app imprimiu, para que ele possa corrigir o projeto e publicar de novo — e se nada na sua app estiver errado, simplesmente volta a publicar. Também deixámos de culpar «o nosso lado» por problemas que estavam de facto na app, e passámos a apanhar apps que se avariam alguns minutos depois de irem para o ar.

O que mudou

Corrigir com IA em todas as falhas

Antes, algumas falhas mostravam Corrigir com IA e outras apenas Tentar novamente. A divisão baseava-se em quem parecia ser o responsável: se parecia ser do nosso lado, não queríamos que o agente andasse a perseguir código que estava bem, à custa dos seus créditos.

Isso deixava a seu cargo descobrir que tipo de falha tinha à frente. Agora, cada falha oferece os dois botões. O agente recebe o tipo de falha e o resultado que está por trás dela, por isso corrige a app quando algo na app está errado, e volta a publicar quando nada está. Nunca precisa de dizer qual era o caso.

As exceções são as situações em que a resposta não é código. Um nome de ligação já ocupado sugere outros nomes. Ficar sem créditos oferece uma forma de obter mais.

Mensagens que dizem o que aconteceu

Várias falhas acabavam em «um problema do nosso lado, publique de novo», o que não era verdade, e publicar de novo nunca ajudava. Agora têm mensagens próprias:

• «A sua app não arrancou depois de publicar.» A app foi publicada, mas nunca começou a aceitar ligações. Na maioria das vezes escuta numa porta diferente, ou apenas em localhost. Uma app publicada tem de escutar em 0.0.0.0 e na porta indicada em $PORT. Em vez de esperar um tempo fixo e torcer, verificamos agora se a app aceita de facto ligações na sua porta.
• «Este ficheiro é demasiado grande» / demasiados ficheiros. Os sites estáticos têm um limite de tamanho por ficheiro (cerca de 25–30 MB, dependendo do tipo de site) e um máximo de 20.000 ficheiros. Agora medimos a pasta antes de carregar seja o que for, da mesma forma para todos os tipos de ficheiro, e a mensagem lista todos os ficheiros acima do limite.
• «A sua app parou logo depois de arrancar.» Normalmente, uma definição em falta, como uma variável de ambiente ou um segredo, um erro no primeiro pedido, ou um erro no comando de arranque.

Apanhar apps que se avariam depois de irem para o ar

Uma publicação pode ter sucesso e a app falhar alguns minutos depois: continua a bloquear, ou continua a correr mas deixa de aceitar ligações. A Mythex verifica regularmente as apps publicadas. Se uma app bloquear repetidamente em poucos minutos, ou estiver a correr sem aceitar ligações, a publicação fica marcada como falhada, recebe um email, e o projeto mostra a mensagem com Corrigir com IA.

Uma única falha de que a app se recuperou sozinha não conta como publicação falhada. Se foi porque a app ficou sem memória, recebe um email separado sobre isso.

Quando marcamos uma app em produção como falhada, guardamos também o que a app imprimiu nesse momento. Você nunca vê esse resultado em bruto, mas é o que o Corrigir com IA entrega ao agente, para que ele parta do erro real em vez de adivinhar.

Como usar

1. Clique em Publicar como de costume.
2. Se falhar, leia a mensagem no diálogo. Foi escrita para lhe dizer o que aconteceu, e não apenas que algo aconteceu.
3. Clique em Corrigir com IA. O agente lê o resultado do build ou os registos da app, corrige o projeto e pode publicar de novo.
4. Se a mensagem disser que nada está errado com a sua app — «A publicação está ocupada neste momento» ou «A publicação foi interrompida» — Tentar novamente costuma bastar.
5. Se recebeu um email a dizer que uma app em produção continua a bloquear, abra o projeto: a mesma mensagem e o Corrigir com IA estão à sua espera.

Mantenha o mesmo nome de ligação ao publicar de novo, a menos que a mensagem diga que o nome é o problema.

Porque a criámos

Uma publicação falhada é muitas vezes o primeiro obstáculo real de alguém. A app funciona na pré-visualização, carrega em Publicar, e não arranca. Para quem não é programador, «veja os registos» não é um conselho que consiga pôr em prática. O Corrigir com IA transforma esse momento num clique, e mensagens honestas significam que, quando as lê, apontam para a coisa certa.

Limites

• O Corrigir com IA usa o agente, por isso consome créditos como qualquer outra mensagem.
• Pode corrigir o que está no projeto: código, configuração, o comando de arranque. Não consegue corrigir um nome de ligação já ocupado, um email por verificar ou um saldo de créditos vazio.
• Alguns problemas exigem uma decisão sua, como mover um ficheiro grande para o Armazenamento ou reduzi-lo.

Cada mensagem e o que fazer em cada caso estão na documentação: Resolução de problemas de publicação. Para a competência mais geral de corrigir coisas quando correm mal, veja como depurar uma app criada com IA.