발행이 실패하면 버튼 한 번으로: Fix with AI

Mythex에서 발행이 실패하면, 이제 대화상자가 실제로 무슨 일이 있었는지 알려 주고 실패할 때마다 두 개의 버튼을 보여 줍니다. Fix with AI와 Try again입니다. Fix with AI를 누르면 에이전트에게 실패 내용과 앱이 출력한 내용이 전달되어, 프로젝트를 고쳐서 다시 발행할 수 있습니다. 앱에 잘못된 부분이 없었다면 그냥 다시 발행합니다. 또 예전에는 앱 안의 문제인데도 "우리 쪽 문제"라고 돌리던 경우를 없앴고, 발행 직후 몇 분 뒤에 깨지는 앱도 잡아내도록 바꿨습니다.

무엇이 바뀌었나

모든 실패에 Fix with AI

예전에는 어떤 실패에는 Fix with AI가 나오고 어떤 실패에는 Try again만 나왔습니다. 그 구분은 실패가 누구의 잘못처럼 보이느냐에 따라 나뉘었습니다. 우리 쪽 문제처럼 보이면 아무 문제 없는 코드를 에이전트가 크레딧을 써 가며 뒤쫓는 일이 없도록 한 것이었습니다.

그래서 어떤 종류의 실패인지 직접 판단해야 했습니다. 이제 모든 실패에 두 버튼이 모두 나옵니다. 에이전트는 실패 유형과 그 뒤에 있는 출력을 받아서, 앱에 문제가 있으면 앱을 고치고 문제가 없으면 다시 발행합니다. 어떤 경우인지 직접 구분할 필요가 없습니다.

예외는 해결책이 코드에 있지 않은 경우입니다. 이미 사용 중인 링크 이름이면 다른 이름을 제안합니다. 크레딧이 부족하면 충전하는 방법을 안내합니다.

무슨 일이 일어났는지 알려 주는 메시지

여러 실패가 "우리 쪽 문제, 다시 발행하세요"로 끝나곤 했습니다. 실제로는 사실이 아니었고, 다시 발행해도 해결되지 않았습니다. 이제 각 실패에 고유한 메시지가 있습니다.

"앱이 발행 후 시작되지 않았습니다." 앱은 발행되었지만 연결을 받기 시작하지 않은 상태입니다. 대부분 다른 포트에서 듣고 있거나 localhost에서만 듣고 있는 경우입니다. 발행된 앱은 0.0.0.0에서, 그리고 $PORT에 지정된 포트에서 연결을 받아야 합니다. 이제는 고정된 시간을 기다리며 기대하는 대신, 앱이 실제로 포트에서 연결을 받는지 확인합니다.
"파일이 너무 큽니다" / 파일 수가 너무 많습니다. 정적 사이트에는 파일당 크기 제한(사이트 종류에 따라 약 25~30MB)과 20,000개 파일 제한이 있습니다. 이제 업로드 전에 폴더를 모든 종류의 파일에 같은 방식으로 측정하고, 제한을 넘는 파일을 메시지에 모두 나열합니다.
"앱이 시작하자마자 멈췄습니다." 보통 환경 변수나 시크릿 같은 설정이 빠졌거나, 첫 요청에서 충돌했거나, 시작 명령에 오류가 있는 경우입니다.

발행 후 깨지는 앱 잡아내기

발행은 성공해도 몇 분 뒤에 앱이 실패할 수 있습니다. 계속 충돌하거나, 실행은 되지만 연결을 받지 않는 경우입니다. Mythex는 발행된 앱을 주기적으로 점검합니다. 앱이 몇 분 안에 반복해서 충돌하거나 실행 중인데 연결을 받지 못하면, 해당 발행은 실패로 표시되고 이메일이 발송되며, 프로젝트에는 Fix with AI와 함께 그 메시지가 나타납니다.

앱이 스스로 복구한 단발성 충돌은 실패한 발행으로 치지 않습니다. 앱이 메모리를 모두 써서 생긴 문제라면 그것에 관해 별도의 이메일이 옵니다.

라이브 앱을 실패로 표시할 때는 그 순간 앱이 출력한 내용도 함께 저장합니다. 이 원본 출력은 사용자에게 보이지 않지만, Fix with AI가 에이전트에게 전달하는 내용입니다. 그래서 에이전트는 추측하지 않고 실제 오류에서 출발합니다.

사용 방법

평소처럼 Publish를 누릅니다.
실패하면 대화상자의 메시지를 읽습니다. 무언가 실패했다는 것만이 아니라 무슨 일이 있었는지 알려 주도록 쓰여 있습니다.
Fix with AI를 누릅니다. 에이전트가 빌드 출력이나 앱 로그를 읽고 프로젝트를 고치면, 다시 발행할 수 있습니다.
메시지가 앱에는 잘못이 없다고 말한다면, 예를 들어 "잠시 발행이 혼잡합니다" 또는 "발행이 중단되었습니다"라면, 보통 Try again으로 충분합니다.
라이브 앱이 계속 충돌한다는 이메일을 받았다면 프로젝트를 여세요. 같은 메시지와 Fix with AI가 그곳에 있습니다.

메시지에서 이름이 문제라고 하지 않는 한, 다시 발행할 때도 같은 링크 이름을 유지하세요.

이 기능을 만든 이유

발행 실패는 많은 사람이 처음으로 마주치는 실질적인 벽입니다. 미리보기에서는 앱이 잘 작동하는데, Publish를 누르면 올라오지 않습니다. 개발자가 아닌 사람에게 "로그를 확인하세요"는 실행할 수 있는 조언이 아닙니다. Fix with AI는 그 순간을 버튼 한 번으로 바꾸고, 정직한 메시지는 읽었을 때 올바른 곳을 가리키게 합니다.

한계

Fix with AI는 에이전트를 사용하므로, 다른 메시지와 마찬가지로 크레딧을 씁니다.
프로젝트 안의 것, 즉 코드, 설정, 시작 명령은 고칠 수 있습니다. 이미 사용 중인 링크 이름, 인증되지 않은 이메일, 비어 있는 크레딧 잔액은 고칠 수 없습니다.
큰 파일을 Storage로 옮길지, 아니면 더 작게 만들지처럼 사용자가 결정해야 하는 문제도 있습니다.

각 메시지와 그에 대한 대처법은 문서에 있습니다: 발행 문제 해결. 실패했을 때 문제를 해결하는 더 넓은 방법은 AI로 만든 앱을 디버그하는 방법을 참고하세요.