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

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

- 유형: 공개 웹페이지
- 정식 페이지: [https://www.shotomatic.com/ko/guide/ai-agents/errors](https://www.shotomatic.com/ko/guide/ai-agents/errors)
- Markdown 페이지: [https://www.shotomatic.com/ko/guide/ai-agents/errors.md](https://www.shotomatic.com/ko/guide/ai-agents/errors.md)

사용자 가이드 둘러보기

이 페이지의 내용

1.  [오류 코드](#오류-코드)
2.  [캡처가 일시 정지된 이유](#캡처가-일시-정지된-이유)
3.  [캡처가 끝난 이유](#캡처가-끝난-이유)

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

## 오류 코드

코드

뜻

할 수 있는 일

`approval_required`

아직 허용하지 않은 에이전트입니다. 허용 전에는 상태만 읽을 수 있습니다.

Shotomatic을 열고 허용 카드에서 **허용**을 선택하세요.

`permission_required`

macOS가 **화면 기록**이나, 키 입력에 필요한 **손쉬운 사용**을 허용하지 않았습니다.

**시스템 설정 > 개인정보 보호 및 보안**에서 Shotomatic을 켠 뒤 다시 여세요. [macOS 권한](https://www.shotomatic.com/ko/guide/get-started/macos-permissions)을 참고하세요.

`license_limit`

하루 스크린샷 수나 배치당 URL 수 같은 무료 플랜 한도에 도달했습니다.

작업을 줄이거나, 내일 다시 하거나, [가격](https://www.shotomatic.com/ko/pricing)을 확인하세요. 이미 저장한 스크린샷은 남아 있습니다.

`pro_feature`

사용자에게 Pro가 필요한 기능은 에이전트에게도 Pro가 필요합니다.

그 기능 없이 작업을 요청하거나 업그레이드하세요.

`busy`

다른 캡처가 실행 중이거나, Shotomatic이 이미 무언가를 묻고 있습니다.

다른 작업이 끝나거나 멈출 때까지 기다리고, 열린 카드에 답한 뒤 다시 요청하세요.

`source_unavailable`

창이나 화면이 없어졌거나 캡처할 수 없습니다.

창을 다시 열거나 다른 대상을 고르라고 에이전트에게 말하세요.

`not_found`

세션, 문서, 워크플로, 작업 ID가 더 이상 없습니다.

항목 목록을 다시 불러오라고 에이전트에게 말하세요.

`revision_conflict`

에이전트가 읽은 뒤 문서가 바뀌었습니다. 대개 사용자가 편집한 경우입니다.

에이전트가 문서를 다시 읽고 변경을 다시 적용해야 합니다.

`browser_not_installed`

웹사이트 캡처에 필요한 Shotomatic 브라우저가 아직 설치되지 않았습니다.

Shotomatic의 웹사이트 캡처 페이지를 열고 브라우저를 설치하세요.

`invalid_request`

에이전트가 Shotomatic이 쓸 수 없는 값을 보냈습니다.

대개 에이전트가 스스로 고칩니다. 반복되면 요청을 바꿔 말해 보세요.

`confirmation_declined`

확인 카드에서 **취소**를 선택했습니다.

할 일이 없습니다. 아무것도 삭제되거나 예약되지 않았습니다.

`confirmation_timeout`

1분 안에 확인 카드에 아무도 답하지 않았습니다.

컴퓨터 앞에 있을 때 다시 요청하세요.

`unavailable`

Shotomatic 기본 창이 열려 있지 않거나, 앱이 작업을 시작하지 못했습니다.

Shotomatic을 열고 기본 창을 띄워 둔 채 다시 요청하세요.

`failed`

그 밖의 문제가 생겼습니다.

메시지를 확인하고 다시 시도하세요. 반복되면 [지원팀에 문의](mailto:support@shotomatic.com)하세요.

## 캡처가 일시 정지된 이유

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

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

## 캡처가 끝난 이유

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

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

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

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

그래도 해결되지 않으면 [문제 해결](https://www.shotomatic.com/ko/guide/troubleshooting/common-issues#ai-%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8%EA%B0%80-%EC%97%B0%EA%B2%B0%EB%90%98%EC%A7%80-%EC%95%8A%EA%B1%B0%EB%82%98-shotomatic%EC%9D%84-%EC%82%AC%EC%9A%A9%ED%95%98%EC%A7%80-%EB%AA%BB%ED%95%A0-%EB%95%8C)이나 [클라이언트 문제 해결 목록](https://www.shotomatic.com/ko/guide/ai-agents/other-agents#%EB%AC%B8%EC%A0%9C-%ED%95%B4%EA%B2%B0)을 참고하세요.

## 이 페이지의 내용

1.  [오류 코드](#오류-코드)
2.  [캡처가 일시 정지된 이유](#캡처가-일시-정지된-이유)
3.  [캡처가 끝난 이유](#캡처가-끝난-이유)

## 이 버전 안내

이 Markdown 페이지는 서버에서 렌더링한 Shotomatic 공개 페이지를 바탕으로 생성됩니다. 조작 요소와 사이트 탐색 메뉴는 제외됩니다. 인용하거나 공유할 때는 정식 페이지를 이용해 주세요.
