트러블슈팅

UpServe를 쓰다가 “어, 이게 왜 이러지?” 싶을 때 가장 먼저 확인할 항목을 증상별로 정리했습니다. 각 항목은 이런 증상이라면 → 이 순서로 점검 구조로 되어 있으니 위에서부터 차례대로 확인하세요.

1. 에이전트가 응답을 안 해요

이런 증상이라면

• 메시지를 보냈는데 답이 없고, 입력창만 비어 있는 상태가 1~2분 이상 지속됩니다.
• 또는 채팅 화면 어디에도 도구 활동 표시(예: “웹 검색 중”, “브라우저 사용 중”)가 없습니다.

이 순서로 점검하세요

1. 진행 중인지 확인 — 채팅창 하단이나 메시지 영역에 도구 실행 표시(예: “웹 검색 중”, “브라우저 사용 중”)가 떠 있는지 보세요. 길게 걸리는 작업은 수십 초~수 분이 걸리기도 합니다.
2. 승인 / 질문 대기 확인 — 빨간색 또는 강조된 카드로 “승인이 필요해요” 또는 “질문이 있어요”가 떠 있다면, 그 카드의 버튼을 눌러야 다음 단계로 진행합니다. 자세한 동작은 승인 시스템에서 확인하세요.
3. 에이전트가 일시정지 상태인지 확인 — 에이전트 설정에서 상태가 활성으로 되어 있어야 합니다. 크레딧이 0이 되면 자동으로 정지되므로 크레딧·결제 화면도 함께 보세요. 또한 일주일 동안 채팅을 열거나 메시지를 보내지 않으면 비용 누수를 막기 위해 자동으로 비활성화됩니다(미리 한 차례 알림이 옵니다). 이 경우 채팅을 다시 열거나 메시지를 보내면 자동으로 다시 활성화됩니다.
4. 새로고침 후 재시도 — 위 점검 후에도 그대로면 페이지를 새로고침하고 동일 메시지를 다시 보냅니다. 일시적인 연결 문제는 새로고침으로 대부분 해결됩니다. 한 번 더 보내도 응답이 없다면 추가 새로고침이 도움이 됩니다.
5. 로그 확인 — 에이전트 화면 우측 메뉴에서 로그를 열면 마지막 실행 결과와 에러가 보입니다. 같은 에러가 반복되면 아래 “고급” 섹션을 참고하세요.

참고: 특정 상황에서 모델 자원이 일시적으로 부족해지면 자동으로 같은 티어 내 예비 모델로 한 번 전환됩니다. 화면에 별도 알림은 표시되지 않습니다.

2. 승인이 떴는데 잘못 거부했어요

이런 증상이라면

• 도구 실행 승인 카드에서 “거부”를 눌렀는데, 사실은 허락해야 했던 작업이었습니다.

이 순서로 점검하세요

1. 다시 부탁하기 — 가장 간단한 방법입니다. 채팅창에 “방금 거부했는데 다시 시도해줘” 같이 메시지를 보내면 에이전트가 다시 같은 도구를 요청합니다.
2. 자동 승인 설정 변경 — 같은 도구를 자주 쓴다면, 에이전트 설정 화면의 도구 섹션에서 그 도구의 자동 승인을 켤 수 있습니다. 그러면 다음부터는 승인 카드 없이 바로 실행됩니다.
3. 위험 도구는 신중히 — 파일 삭제, 외부 결제 등 위험한 작업은 자동 승인을 끄고 매번 확인하는 편이 안전합니다. 더 자세한 기준은 승인 시스템에 정리되어 있습니다.

3. 스케줄이 안 돌았어요

이런 증상이라면

• 매일 아침 8시에 돌도록 설정했는데, 시간이 지나도 메시지나 알림이 오지 않았습니다.

이 순서로 점검하세요

1. 에이전트가 활성 상태인지 — 일시정지된 에이전트는 스케줄이 자동으로 건너뛰어집니다.
2. 크레딧 잔액 — 잔액이 0이면 자동 실행이 건너뛰어지고 에이전트가 자동으로 비활성화됩니다. 잔액이 거의 남지 않았다면 실행 도중 소진되어 중단될 수 있으니 미리 충전하세요.
3. 사용 도구가 모두 활성화되어 있는지 — 스케줄에서 쓰는 도구가 에이전트 설정에서 꺼져 있으면 실패합니다.
4. 마지막 실행 시각 확인 — 스케줄 화면에서는 각 스케줄의 다음 실행 시각을 볼 수 있고, 각 스케줄 카드의 이력 버튼을 누르면 로그 탭으로 이동합니다. 로그 탭에서 각 실행의 결과 상태와 실패 사유, 크레딧 사용 추이와 일별 통계를 함께 확인할 수 있습니다.
5. 스케줄 자체 검토 — 시간 / 반복 주기를 잘못 입력했을 수 있습니다. 자세한 작성법은 스케줄링을 참고하세요.

참고: 자율 실행 중 에이전트가 도구를 여러 번 호출하지 않고 빈 응답만 반복하면 안전을 위해 자동 중단됩니다.

4. 푸시 알림이 안 와요

이런 증상이라면

• 자율 실행이 끝났는데 휴대폰에 알림이 뜨지 않습니다.

이 순서로 점검하세요

1. 앱 안의 알림 설정 — 설정 → 알림 화면에서 에이전트 응답 같은 받고 싶은 알림 토글이 켜져 있는지 확인하세요.
2. 시스템 권한 — iPhone의 시스템 설정 → 알림 → UpServe에서 알림 허용이 켜져 있어야 합니다.
3. 방해 금지 시간(DND) — 알림 설정의 방해 금지 시간이 활성화되어 있으면 해당 시간대에는 푸시 알림이 발송되지 않습니다. 알림 자체는 앱 안(인앱 알림함)에 기록됩니다.
4. 디바이스 등록 — 앱을 새로 설치했거나 로그아웃 후 재로그인했다면, iPhone에서 UpServe 앱을 한 번 열어주면 디바이스가 다시 등록됩니다.
5. 같은 화면을 보고 있는 경우 — 사용자가 같은 에이전트 채팅을 켜둔 상태에서는 푸시 대신 화면 안의 알림으로만 표시됩니다. 이는 정상 동작입니다.

상세 가이드는 알림 받기에 있습니다.

5. 비용이 갑자기 늘었어요

이런 증상이라면

• 평소보다 크레딧 잔액이 빠르게 줄었거나, 한 에이전트의 사용량이 비정상적으로 높아 보입니다.

이 순서로 점검하세요

1. 로그에서 무엇이 많이 돌았는지 확인 — 에이전트 우측 메뉴 → 로그에서 총 비용·모델별·일별 사용 추이를 확인할 수 있고, 채팅 화면에서는 도구 호출이 묶음으로 표시되어 호출 횟수가 함께 보입니다. 같은 도구가 반복 호출되었다면 다음 항목을 보세요.
2. 에이전트가 반복 루프에 빠졌는지 — 결과를 못 본 듯 같은 도구를 계속 부르고 있다면, 채팅으로 “이미 받은 결과를 그대로 활용해 마무리해줘”라고 종료 조건을 알려주세요.
3. 모델 등급 조정 — 단순한 작업에는 더 가벼운 모델로 충분합니다. 에이전트 설정에서 모델 등급을 한 단계 낮추면 비용이 크게 줄어듭니다.
4. 무거운 도구 제한 — 브라우저, 컴퓨터 사용처럼 한 번 실행에 비교적 큰 비용이 드는 도구는 꼭 필요할 때만 켜둡니다. 자세한 도구 비용 감각은 도구 부여하기에서 확인하세요.
5. 크레딧 정책 확인 — 크레딧·결제에서 무료 크레딧 갱신 주기와 구독 옵션을 다시 살펴보세요.

6. 외부 서비스 인증이 만료됐어요

이런 증상이라면

• GitHub, Linear, Notion, Slack 등을 쓰는 스킬이나 도구에서 “권한 없음” 또는 “다시 연결이 필요해요” 같은 메시지가 표시됩니다.

이 순서로 점검하세요

1. 연결 상태 확인 — 아래 두 곳 중 편한 곳에서 확인할 수 있습니다.
   • 마켓플레이스 → 스킬 — 스킬 목록 화면의 카드에 “재연결 필요” 배너가 표시됩니다.
   • 에이전트 설정 → 스킬 선택기 — 에이전트 설정 화면에서 스킬 행을 펼치면, 외부 서비스 연결 항목이 표시됩니다. “재연결 필요” 상태면 주황색 경고 아이콘이 함께 보입니다.
2. 재연결 — 어느 화면에서든 다시 연결 버튼을 눌러 외부 서비스 로그인을 다시 마칩니다.
3. 권한 범위 — 외부 서비스 쪽에서 권한을 일부 회수했거나 스코프가 바뀐 경우, 다시 연결할 때 원하는 권한을 모두 체크해야 합니다.
4. 재시도 — 재연결을 마친 뒤 동일 작업을 에이전트에게 다시 부탁하면 정상 동작합니다.

7. 스킬이 자꾸 실패하거나 비활성화됐어요

이런 증상이라면

• 스킬 카드에 빨간 점이 표시됩니다.
• 라이브러리 정리 알림을 받았고, 해당 스킬이 “자주 실패함”으로 분류돼 있습니다.
• 또는 “스킬 지원 종료” 알림이 왔습니다.

이 순서로 점검하세요

1. 설정 → 스킬 라이브러리 정리 열기 — 정리 후보 목록에서 해당 스킬의 분류를 확인합니다.
2. 자주 실패함으로 분류된 경우 — 오류 원인을 파악한 뒤 아래 방법 중 선택합니다.
   • 외부 서비스 로그인 정보 만료가 원인이라면 에이전트 설정 또는 마켓플레이스 스킬 목록 화면에서 재연결합니다 (위 6번 항목 참고).
   • 외부 서비스 API 사양 변경이 원인이라면 마켓플레이스에서 같은 기능의 대체 스킬을 검색합니다.
   • 직접 고치고 싶다면 해당 스킬을 내 사본으로 가져와 수정을 요청할 수 있습니다.
3. 지원 중단됨으로 분류된 경우 — 원작자가 더 이상 지원하지 않는다는 표시입니다. 마켓플레이스에서 후속 버전이나 대체 스킬을 검색하거나, 기존 스킬을 내 사본으로 가져와 직접 유지할 수 있습니다.
4. 외부 서비스 로그인 정보 만료가 의심되면 — 위 “6. 외부 서비스 인증이 만료됐어요”를 따라 재연결합니다.

8. 공유 링크를 받은 사람이 못 열어요

이런 증상이라면

• 내가 공유한 링크를 외부 사용자에게 보냈는데, “사용할 수 없는 링크” 또는 “이용이 일시 중단되었습니다” 같은 화면이 뜬다는 연락을 받았습니다.

이 순서로 점검하세요

1. 공유 활성 토글 — 에이전트 우측 메뉴의 스냅샷(Shared) 화면에서 해당 공유가 활성화되어 있는지 확인합니다. 토글이 꺼지면 즉시 접속이 차단됩니다.
2. 소유자(나)의 크레딧 — 공유 에이전트는 소유자의 크레딧에서 비용이 나갑니다. 소유자 크레딧이 바닥나면 외부 사용자도 사용이 막힙니다.
3. 세션 / 일일 상한 도달 — 안전 장치로 설정한 세션당 크레딧 상한에 도달하면 해당 세션은 영구 차단됩니다. 일일 링크 상한에 도달하면 그날(UTC 기준) 새 세션 진입이 막히지만, 다음 날(UTC 자정 이후) 자동으로 새 세션을 다시 열 수 있습니다. 상한값을 올리면 즉시 풀립니다.
4. 링크 자체가 비활성화되었는지 — 공유 스냅샷 화면에서 해당 링크를 직접 꺼두었다면 외부 사용자 접속이 차단됩니다. 새 스냅샷을 만든다고 해서 이전 링크가 자동으로 꺼지지는 않으며, 오너가 직접 끄거나 크레딧 소진 시 자동 비활성화됩니다.

공유 전반의 동작은 에이전트 공유 (스냅샷)에 상세히 정리되어 있습니다.

9. 컴퓨터 사용 / 브라우저 도구가 멈춰 보여요

이런 증상이라면

• 미리보기 화면이 한참 같은 상태로 멈춰 보이거나, 진행 표시는 있는데 결과가 안 옵니다.

이 순서로 점검하세요

1. 활동 표시 확인 — 메시지 영역에 “스크린샷 찍는 중”, “클릭”, “타이핑” 등의 라벨이 일정 간격으로 갱신되고 있다면 정상적으로 작업 중입니다. 페이지 로딩이나 사이트 응답이 느려 시간이 걸리는 경우가 많습니다.
2. 짧게 대기 — 무거운 페이지(예: 로그인이 필요한 대시보드, 광고가 많은 사이트)는 안정화까지 10~30초가 걸립니다.
3. 에이전트에게 상태 묻기 — 답답하면 채팅창에 “지금 어떤 단계야? 막혔으면 다음으로 넘어가줘”라고 입력하면 에이전트가 현재 상황을 말하거나 다른 방법으로 전환합니다.
4. 재시도 / 단순화 요청 — 동일 페이지에서 계속 멈추면 “이 페이지 대신 다른 방법으로 정보를 모아줘”라고 부탁하거나, 작업을 더 작은 단계로 나눠 다시 시켜보세요.

참고: 도구 호출이 여러 번 비어서 돌아오면 안전을 위해 자동 중단됩니다. 작업을 더 구체적으로 다시 지시해 주세요.

고급 (Advanced)

아래 내용은 일반 사용자에게는 필요하지 않습니다. 같은 문제가 반복되거나 직접 원인을 파악하고 싶을 때만 참고하세요.

활동 로그에서 마지막 에러 분류 확인

에이전트 우측 메뉴의 로그에는 각 실행의 결과 상태(완료 / 실패 / 건너뜀)와 마지막 에러 메시지가 함께 표시됩니다. 같은 사유의 실패가 반복된다면 다음과 같이 분류해 대응할 수 있습니다.

동일 실패가 계속 반복될 때

같은 에러가 3회 이상 반복되면 다음 순서를 권장합니다.

1. 에이전트를 일시정지합니다. 자동 실행과 스케줄이 함께 멈춥니다.
2. 채팅에서 “지금까지 무엇을 시도했고 왜 막혔는지 정리해서 메모에 남겨줘”라고 부탁해 에이전트의 기억을 정리합니다.
3. 에이전트의 기억 정리가 끝나면 활성 상태로 되돌리고, 작업을 작게 쪼개 다시 시도합니다.
4. 그래도 같은 자리에서 막힌다면 도구 부여하기에서 다른 도구 조합으로 대체할 수 있는지 살펴보세요.