Apiway

App Factory나 내 에이전트가 동작하지 않을 때 해결 방법

App Factory나 AI 에이전트가 동작하지 않을 때 확인할 것들을 정리했습니다. 연결된 계정, 에이전트의 도구 권한, 잠든 미리보기, 플랜 문제를 차례로 점검하고 고치는 방법을 단계별로 안내합니다.

업데이트: 2026-10-11

문제는 대부분 다음 네 가지 중 하나입니다: 에이전트가 다른 Apiway 계정에 연결되어 있거나, 에이전트의 도구가 꺼져 있거나, 미리보기가 잠들어 있거나, 플랜에 해당 작업이 포함되어 있지 않은 경우입니다. 앱 페이지가 문제를 알려 주고 이를 해결하는 작업 지시를 줍니다.

단계

  1. 계정 확인하기에이전트에게 이렇게 물어보세요: “Apiway에 연결되어 있어? Apiway 계정 이름을 말하고 내 앱 목록을 보여 줘.” 에이전트는 앱을 소유한 계정의 이름을 말해야 합니다.
  2. 도구 확인하기Claude에서: Settings → Connectors → apiway.ai → Tool permissions → 세 그룹 모두 “Always allow”, 그런 다음 새 채팅.
  3. 미리보기 깨우기페이지에 The preview is asleep 문구가 나오면 Wake up 버튼을 누르세요.
  4. 오류 고치기무언가 고장 나면 앱 페이지에 Fix with your agent 버튼이 나옵니다. 이 버튼은 에이전트용 작업 지시를 복사하며, 에이전트가 원인을 찾아 고치고 미리보기를 업데이트합니다. Fix it with Apiway 버튼은 같은 작업 지시를 Apiway 에이전트에게 줍니다.
  5. 로그 보기⋯ → Log 항목을 누르세요.
  6. 되돌리기⋯ → Versions 항목을 누르고 이전 버전을 미리보기로 되돌리세요.

화면에 나오는 문구와 그 의미

화면 문구할 일
<agent> is not connected to Apiway yet — connect itConnect an agent 아래의 해당 에이전트 페이지에서 연결하세요
The preview is asleepWake up 버튼을 누르세요
Publish your app — it is on any paid plan유료 플랜을 고르세요. 제작과 미리보기는 계속 무료입니다
Free · N days left (무료 · N일 남음)무료 앱은 첫 미리보기부터 30일 동안 호스팅됩니다. 업그레이드하면 계속 유지됩니다
미리보기가 비어 있을 때작업 지시를 에이전트에게 주세요: ⋯ → Task for the agent

잘 안 될 때

  • 에이전트가 여전히 앱을 보지 못할 때: 에이전트의 커넥터 설정에서 Apiway 연결을 해제하고, 앱 소유자 계정으로 apiway.ai에 로그인한 뒤 다시 연결하고 새 채팅을 시작하세요.
  • 삭제된 앱을 되살려야 할 때: 직접 삭제한 앱은 6개월 안에 지원팀을 통해서만 복구할 수 있습니다.
  • 위의 방법이 모두 소용없을 때: Apiway 지원팀에 문의하면서 앱 주소를 알려 주세요.

질문과 답변

새 채팅이 왜 중요한가요?

열려 있는 채팅은 권한을 바꾼 뒤에도 도구 목록을 다시 읽지 않습니다.

내 에이전트가 내 앱을 삭제할 수 있나요?

아니요. 삭제는 사람이 Apiway에서 직접 확인합니다. 창에서 DELETE를 입력하라고 요청합니다.