문제 해결
이 가이드는 Neotask 사용 중 발생할 수 있는 일반적인 문제와 해결 방법을 다룹니다.
라이선스 및 활성화
"유효하지 않은 라이선스 키"
- 키 형식 확인:
SC-XXXXXXXX-XXXXXXXX-XXXXXXXX-XXXXXXXX - 추가 공백이나 누락된 문자 확인
- 활성 인터넷 연결 확인
- 키를 주의 깊게 다시 입력해 보세요
"라이선스가 취소됨"
- 서버에 의해 라이선스가 취소되었습니다
- neotask.ai에서 청구 상태를 확인하세요
- 오류라고 생각되면 지원팀에 문의하세요
"라이선스 만료됨"
- 구독이 만료되었습니다
- 청구 포털을 통해 플랜을 갱신하세요
- 만료되면 앱이 읽기 전용 모드로 진입합니다
"오프라인 유예 기간 만료됨"
- 72시간 이상 오프라인 상태였습니다
- 자동 재검증을 위해 인터넷에 연결하세요
- 연결되면 앱이 정상 작동을 재개합니다
"버전 차단됨"
- 보안상의 이유로 앱 버전이 차단되었습니다
- 즉시 최신 버전으로 업데이트하세요
- 자동 업데이트가 알려드려야 합니다; 그렇지 않으면 웹사이트에서 다운로드하세요
게이트웨이 문제
"게이트웨이 시작 실패"
- 포트 18789가 사용 가능한지 확인합니다 (다른 앱에서 사용하지 않는지)
- 앱 재시작을 시도합니다
- 대시보드에서 게이트웨이 상태를 확인합니다
- macOS의 경우 시스템 설정 → 개인 정보 보호 및 보안에서 앱이 필요한 권한을 가지고 있는지 확인합니다
"3회 시도 잠금"
- 게이트웨이 실패가 3회 연속 발생하면 작업이 차단됩니다
- 앱을 재시작하여 잠금 카운터를 재설정합니다
- 계속 발생하면 근본적인 오류를 파악하기 위해 로그를 확인합니다
"게이트웨이 연결 끊김"
- 로컬 런타임의 연결이 끊겼습니다
- 게이트웨이 패널에서 "재연결"을 클릭합니다
- 계속 연결이 끊기면 앱을 재시작합니다
- 방화벽이 로컬호스트 연결을 차단하지 않는지 확인합니다
음성 문제
"오디오 입력이 감지되지 않음"
- 마이크 권한 부여:
- macOS: 시스템 설정 → 개인 정보 보호 및 보안 → 마이크 → Neotask에 대해 활성화
- Windows: 설정 → 개인 정보 → 마이크 → 앱이 접근하도록 허용
- 마이크가 음소거되지 않았는지 확인합니다
- 시스템 설정에서 올바른 입력 기기가 선택되었는지 확인합니다
"웨이크 워드가 작동하지 않음"
- 설정에서 음성 활성화가 활성화되어 있는지 확인합니다
- 웨이크 모드가 "Porcupine"으로 설정되어 있는지 확인합니다 ("단축키" 또는 "끄기"가 아님)
- 웨이크 구문을 명확하게 말합니다: "Hey Neotask"
- 대신 키보드 단축키를 사용해 보세요 (Cmd+Shift+Space / Ctrl+Shift+Space)
- 다른 앱이 마이크를 사용하고 있는지 확인합니다
"TTS 오디오가 끊기거나 지연됨"
- 인터넷 연결 확인 (TTS는 ElevenLabs API가 필요합니다)
- ElevenLabs에서 속도 제한이 발생하고 있을 수 있습니다
- 설정에서 다른 목소리를 사용해 보세요
- 백그라운드 네트워크 활동을 줄이세요
"음성 단축키가 작동하지 않음"
- 다른 앱이 동일한 단축키를 가져갔을 수 있습니다
- 설정 → 활성화 → 키보드 단축키에서 단축키를 변경합니다
- macOS에서 시스템 설정 → 키보드 → 단축키에서 충돌을 확인합니다
연결 및 네트워크
"서버에 연결할 수 없음"
- 인터넷 연결 확인
- 브라우저에서 neotask.ai에 접근할 수 있는지 확인합니다
- 기업 방화벽 뒤에 있는 경우 HTTPS 트래픽이 허용되는지 확인합니다
- 일시적으로 VPN을 비활성화해 보세요
"API 요청 실패"
- 인터넷 연결 확인
- 라이선스가 활성화되어 있는지 확인합니다
- BYOK를 사용하는 경우 API 키가 유효하고 크레딧이 있는지 확인합니다
- 대시보드를 새로 고침해 보세요
에이전트 및 세션
"에이전트를 생성할 수 없습니다: 한도 초과"
- 에이전트 수는 플랜에 따라 제한되지 않습니다; 커스텀 에이전트 생성에는 유료 플랜이 필요합니다
- 무료 플랜에서 이 메시지가 표시되면 유료 플랜으로 업그레이드하여 커스텀 에이전트를 생성하세요
- 미사용 에이전트를 삭제하여 워크스페이스를 깔끔하게 유지하세요
"에이전트가 응답하지 않음"
- 게이트웨이 상태 확인 (실행 중이어야 함)
- 에이전트의 모델에 접근할 수 있는지 확인합니다 (API 키 유효, 제공업체 가용)
- 일일 예산 확인, 초과된 경우 UTC 자정까지 에이전트가 일시 중지됩니다
- 세션 재설정을 시도합니다
"세션 메시지가 로드되지 않음"
- 페이지/앱 새로 고침
- 게이트웨이 연결 상태 확인
- 세션이 매우 길면 새 세션 만들기를 시도합니다
청구 및 결제
"결제 실패"
- 카드 세부 정보가 올바른지 확인합니다
- 국제 거래에 대한 은행의 차단 여부를 확인합니다
- 다른 결제 방법을 시도합니다
- 문제가 지속되면 지원팀에 문의하세요
"사용 할당 초과"
- 에이전트의 토큰 소비가 구독에 포함된 할당을 초과했습니다
- 추가 사용량은 사용 요금으로 청구됩니다. 자세한 내용은 대시보드의 사용량 페이지를 확인하세요.
- BYOK 모드로 전환하여 (자체 API 키 사용) 토큰 비용을 제공업체로 직접 라우팅합니다
- 예상치 못한 초과를 방지하기 위해 일일 예산 한도를 설정합니다
"결제 후 플랜이 업데이트되지 않음"
- Stripe 웹훅은 약간의 지연이 있을 수 있습니다 (일반적으로 1분 미만)
- 대시보드를 새로 고침합니다
- 5분 후에도 업데이트되지 않으면 결제 확인서와 함께 지원팀에 문의하세요
성능
"앱 시작 시 느림"
- 실행 시 라이선스 검증 및 게이트웨이 시작이 발생합니다, 이는 정상입니다
- 시스템이 최소 요구 사항을 충족하는지 확인합니다
- 불필요한 백그라운드 앱을 닫습니다
"높은 CPU 사용량"
- 항상 켜져 있는 웨이크 워드(Porcupine)를 사용하는 경우 최소한의 CPU를 사용하지만 비활성화할 수 있습니다
- 사용하지 않을 때는 음성 세션을 일시 중지합니다
- 활동 모니터 / 작업 관리자에서 멈춘 게이트웨이 프로세스를 확인합니다
"높은 메모리 사용량"
- 긴 채팅 세션은 메모리를 축적합니다
- 주기적으로 새 세션을 만드세요
- 앱을 재시작하여 축적된 상태를 지웁니다
도움 받기
- 문서: 여기에 있습니다, 지식 베이스를 탐색하세요
- 지원: neotask.ai/support의 지원 페이지를 방문하세요
- 연락처: 웹사이트의 연락 양식을 사용하세요
- 상태: neotask.ai에서 서비스 상태를 확인하세요