사용자 가이드 둘러보기

에이전트 오류와 해결 방법

AI 에이전트가 Shotomatic에서 받을 수 있는 오류 코드와 중단 이유, 각각의 뜻과 사용자가 할 수 있는 일을 정리했습니다.

업데이트 2026년 11월 16일

Markdown 보기
이 페이지의 내용

Shotomatic 도구가 에이전트의 요청을 처리하지 못하면 code, 메시지, 다시 시도해서 될지 여부, 그리고 사용자가 할 일을 담은 오류를 돌려줍니다. 좋은 에이전트는 그 할 일을 사용자에게 전달합니다. 에이전트가 오류 코드를 알려 줄 때 무엇을 해야 하는지 알 수 있도록 모든 코드를 정리했습니다.

오류 코드

코드뜻할 수 있는 일
approval_required아직 허용하지 않은 에이전트입니다. 허용 전에는 상태만 읽을 수 있습니다.Shotomatic을 열고 허용 카드에서 허용을 선택하세요.
permission_requiredmacOS가 화면 기록이나, 키 입력에 필요한 손쉬운 사용을 허용하지 않았습니다.시스템 설정 > 개인정보 보호 및 보안에서 Shotomatic을 켠 뒤 다시 여세요. macOS 권한을 참고하세요.
license_limit하루 스크린샷 수나 배치당 URL 수 같은 무료 플랜 한도에 도달했습니다.작업을 줄이거나, 내일 다시 하거나, 가격을 확인하세요. 이미 저장한 스크린샷은 남아 있습니다.
pro_feature사용자에게 Pro가 필요한 기능은 에이전트에게도 Pro가 필요합니다.그 기능 없이 작업을 요청하거나 업그레이드하세요.
busy다른 캡처가 실행 중이거나, Shotomatic이 이미 무언가를 묻고 있습니다.다른 작업이 끝나거나 멈출 때까지 기다리고, 열린 카드에 답한 뒤 다시 요청하세요.
source_unavailable창이나 화면이 없어졌거나 캡처할 수 없습니다.창을 다시 열거나 다른 대상을 고르라고 에이전트에게 말하세요.
not_found세션, 문서, 워크플로, 작업 ID가 더 이상 없습니다.항목 목록을 다시 불러오라고 에이전트에게 말하세요.
revision_conflict에이전트가 읽은 뒤 문서가 바뀌었습니다. 대개 사용자가 편집한 경우입니다.에이전트가 문서를 다시 읽고 변경을 다시 적용해야 합니다.
browser_not_installed웹사이트 캡처에 필요한 Shotomatic 브라우저가 아직 설치되지 않았습니다.Shotomatic의 웹사이트 캡처 페이지를 열고 브라우저를 설치하세요.
invalid_request에이전트가 Shotomatic이 쓸 수 없는 값을 보냈습니다.대개 에이전트가 스스로 고칩니다. 반복되면 요청을 바꿔 말해 보세요.
confirmation_declined확인 카드에서 취소를 선택했습니다.할 일이 없습니다. 아무것도 삭제되거나 예약되지 않았습니다.
confirmation_timeout1분 안에 확인 카드에 아무도 답하지 않았습니다.컴퓨터 앞에 있을 때 다시 요청하세요.
unavailableShotomatic 기본 창이 열려 있지 않거나, 앱이 작업을 시작하지 못했습니다.Shotomatic을 열고 기본 창을 띄워 둔 채 다시 요청하세요.
failed그 밖의 문제가 생겼습니다.메시지를 확인하고 다시 시도하세요. 반복되면 지원팀에 문의하세요.

캡처가 일시 정지된 이유

에이전트가 시작한 자동 캡처는 엉뚱한 곳에 키를 누르는 대신 일시 정지합니다.

  • 다른 창이 앞에 있음: Shotomatic은 캡처 중인 창이 앞에 있지 않으면 키를 누르지 않습니다. 창을 다시 앞으로 가져오고 에이전트에게 재개하라고 말하세요. 캡처 중에는 컴퓨터를 만지지 마세요.
  • 화면이 잠김: 잠금을 풀고 에이전트에게 재개하라고 말하세요.

캡처가 끝난 이유

작업이 끝나면 에이전트는 이유를 받습니다. 다음은 정상적인 종료입니다.

  • 내용이 더 이상 바뀌지 않음: 키를 누르는 캡처는 책의 끝처럼 페이지가 바뀌지 않으면 멈춥니다.
  • 중지 조건에 도달: 요청한 스크린샷 수, 시간, 종료 시각에 도달했습니다.
  • 사용자나 에이전트가 멈춤: 사용자가 캡처 완료를 선택했거나 에이전트가 작업을 멈췄습니다. 이미 찍은 스크린샷은 남아 있습니다.

다음은 확인이 필요한 경우입니다.

  • 무료 한도 도달: 무료 플랜 한도 때문에 캡처가 끝났습니다. 그때까지 저장한 스크린샷은 캡처 기록에 있습니다. Action Capture는 무료 플랜에서 5단계가 되면 끝납니다.
  • 창이 닫힘: 캡처 중에 대상 창이 닫혔습니다.
  • 창을 앞에 유지할 수 없음: Shotomatic이 창을 앞으로 가져오지 못했습니다. 창이 보이게 두고 컴퓨터를 쓰지 않은 채 에이전트에게 다시 시작하라고 말하세요.
  • 다른 곳에서 세션이 끝남: 캡처가 실행되는 동안 Shotomatic에서 캡처 세션이 닫혔습니다.

그래도 해결되지 않으면 문제 해결이나 클라이언트 문제 해결 목록을 참고하세요.

에이전트 오류와 해결 방법 | 사용자 가이드 | Shotomatic