트러블슈팅

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

1. 직원이 응답을 안 해요

이런 증상이라면

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

이 순서로 점검하세요

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

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

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

이런 증상이라면

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

이 순서로 점검하세요

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

3. 예약 실행이 안 돌았어요

이런 증상이라면

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

이 순서로 점검하세요

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

참고: 자동 실행 중 같은 도구 호출에서 오류가 5회 이상 연속되거나, 이미 거부된 동일한 요청을 계속 다시 시도하거나, echo·true처럼 아무 효과가 없는 명령만 반복하면 안전을 위해 자동으로 마무리(요약 정리)됩니다.

4. 푸시 알림이 안 와요

이런 증상이라면

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

이 순서로 점검하세요

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

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

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

이런 증상이라면

평소보다 SU 잔액이 빠르게 줄었거나, 한 직원의 사용량이 비정상적으로 높아 보입니다.

이 순서로 점검하세요

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

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

이런 증상이라면

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

이 순서로 점검하세요

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

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

이런 증상이라면

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

이 순서로 점검하세요

업무 스킬 메뉴(내 서재) 정리 제안 열기: 내 서재 화면 상단 카드의 “삭제를 검토할 스킬 N건” 줄에서 검토 버튼을 누르면 정리 후보 목록에서 해당 스킬의 분류를 확인할 수 있습니다. (관련 알림을 눌러 들어온 경우에는 이 화면이 자동으로 열립니다.)
자주 실패함으로 분류된 경우: 오류 원인을 파악한 뒤 아래 방법 중 선택합니다.
- 외부 서비스 로그인 정보 만료가 원인이라면 직원 설정 또는 업무 스킬 메뉴(내 서재)에서 재연결합니다 (위 6번 항목 참고).
- 외부 서비스 API 사양 변경이 원인이라면 업무 스킬 메뉴의 공식 스킬에서 같은 기능의 대체 스킬을 검색합니다.
- 직접 고치고 싶다면 해당 스킬을 복사해서 수정해 내 파생본으로 만들 수 있습니다.
지원 중단됨으로 분류된 경우: 더 이상 지원되지 않는다는 표시입니다. 업무 스킬 메뉴의 공식 스킬에서 후속 버전이나 대체 스킬을 검색하거나, 기존 스킬을 복사해서 수정해 파생본으로 직접 유지할 수 있습니다.
외부 서비스 로그인 정보 만료가 의심되면: 위 “6. 외부 서비스 인증이 만료됐어요”를 따라 재연결합니다.

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

이런 증상이라면

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

이 순서로 점검하세요

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

공유 전반의 동작은 AI 직원 외부에 공개하기에 상세히 정리되어 있습니다.

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

이런 증상이라면

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

이 순서로 점검하세요

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

참고: 같은 도구 호출이 반복해서 오류를 내거나, 의미 없는 명령만 반복되면 안전을 위해 자동으로 마무리됩니다. 작업을 더 구체적으로 다시 지시해 주세요.

10. “내부 인프라가 불안정합니다” 배너가 떴어요

이런 증상이라면

채팅 화면 위쪽에 “내부 인프라가 불안정합니다. 잠시 후 다시 시도해 주세요.” 라는 띠가 떠 있습니다.
웹·iPhone·Android 어느 쪽에서든 같은 문구로 보입니다.

이게 무슨 뜻인가요

직원이 일할 때 쓰는 실행 환경(AI 작업용 컴퓨터) 쪽이 지금 불안정하다는 뜻입니다. 여러분의 계정, 결제 상태, 직원 설정에는 아무 문제가 없고, 고칠 것도 없습니다. 이 배너는 오류가 아니라 “지금 안 되는 게 당신 탓이 아니다”를 알려주는 안내입니다.

배너가 켜지는 경우는 둘입니다.

방금 내 요청이 그 이유로 실패했을 때: 내 화면에만 뜹니다.
여러 직원에 걸쳐 실패가 쌓여 서비스 전체가 불안정하다고 판정됐을 때: 이때는 직원 채팅 화면을 열어 둔 모든 사람에게 뜹니다(대시보드나 팀 채팅 화면에는 뜨지 않습니다). 단발 실패로는 켜지지 않도록 건수와 비율을 함께 봅니다.

이 순서로 점검하세요

잠시 기다렸다가 다시 시도: 대부분 몇 분 안에 회복됩니다. 같은 메시지를 다시 보내면 됩니다.
배너는 저절로 사라집니다: 여러분이 닫거나 새로고침할 필요는 없습니다(배너에 별도 시각이 적혀 있지는 않습니다). 다만 배너가 사라졌다고 해서 반드시 회복됐다는 뜻은 아니니, 다시 시도해 보고 또 실패하면 조금 더 기다렸다가 시도하세요.
설정을 바꾸지 마세요: 직원을 삭제하거나 도구를 끄거나 재연결할 필요가 없습니다. 원인이 그쪽에 없습니다.
한참 지나도 계속된다면: 30분 이상 이어지면 벌레 아이콘의 문제 신고하기로 알려주세요. 아래 “고급” 섹션의 신고 방법을 참고하세요.

SU는 어떻게 되나요

실행 환경을 얻지 못해 시작조차 못 한 경우, 그 시간에 대한 SU는 발생하지 않습니다. AI 작업용 컴퓨터의 사용 시간은 실제로 켜져 있던 시간만큼만 계산되기 때문입니다. 반대로 시작은 됐다가 도중에 깨졌다면, 그때까지 켜져 있던 시간만큼은 계산됩니다.
다만 그 요청이 도중에 실패했더라도, 실패 전까지 이미 진행된 AI 사용량은 사용한 것으로 기록됩니다. AI 호출 비용은 호출이 일어난 시점에 바로 기록되며, 실패했다고 해서 자동으로 되돌려지지는 않습니다.
장애 때문에 이례적으로 큰 사용량이 나갔다면 문제 신고하기로 알려주세요.

고급 (Advanced)

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

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

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

분류	사용자에게 보이는 신호	권장 조치
모델 호출 한도	“잠시 후 다시 시도해 주세요”	잠시 대기. 반복되면 직원의 AI 성능 등급을 바꿔 보세요(웹은 권한, 모바일 앱은 설정)
모델 페일오버 발생	화면에 별도 알림 없음 (내부 처리)	정상 동작. 같은 AI 성능 등급 안의 예비 모델이 1회 대체되므로 재시도 불필요
도구 에러	“도구 실행에 실패했습니다”	해당 도구가 의존하는 외부 서비스 연결 / 권한 점검
SU 부족	“사용 가능한 SU가 부족합니다”	구독 또는 요금제 상향
내부 인프라(실행 환경) 장애	채팅 화면 위쪽 “내부 인프라가 불안정합니다” 배너	잠시 후 재시도. 위 10번 항목 참고
사용자 응답 미수신	카드 형태의 질문이 닫혀 있음	카드의 입력란에 답변 입력 또는 직원에게 다시 요청

동일 실패가 계속 반복될 때

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

직원을 일시정지합니다. 자동 실행과 예약 실행이 함께 멈춥니다.
채팅에서 “지금까지 무엇을 시도했고 왜 막혔는지 정리해서 메모에 남겨줘”라고 부탁해 직원의 기억을 정리합니다.
직원의 기억 정리가 끝나면 활성 상태로 되돌리고, 작업을 작게 쪼개 다시 시도합니다.
그래도 같은 자리에서 막힌다면 도구 부여하기에서 다른 도구 조합으로 대체할 수 있는지 살펴보세요.
위 방법으로도 해결되지 않는다면 벌레 아이콘 문제 신고하기로 직접 신고할 수 있습니다. 좌측 사이드바 하단이나 직원 목록 화면 하단뿐 아니라, 직원의 로그 탭·대시보드·팀의 전체 활동 화면에서도 실행 하나하나 옆에 작은 벌레 아이콘이 붙어 있어 그 실행을 바로 지목해 신고할 수 있습니다. 신고 창을 열면 최근 실행 목록 중에서 “어떤 작업에서 문제가 있었나요”를 고를 수 있고(잘 모르겠으면 건너뛰어도 됩니다), 증상만 간단히 적어 보내면 해당 직원의 메타데이터, 최근 자동 실행 이력, 기억 파일 존재 여부, 현재 화면 스크린샷이 자동으로 함께 첨부되어 운영팀이 원인을 빠르게 확인할 수 있습니다.