에이전트 운영하기

에이전트는 한 번 만들고 끝나는 도구가 아니라, 시간이 지나며 메모리가 쌓이고 자동 실행이 늘어나는 살아 있는 작업자입니다. 이 문서는 만들어둔 에이전트를 오래 잘 굴리기 위해 알아둘 내용 — 잠시 멈추기 / 메모리 정리 / 실행 비용 확인 / 자동 실행 정리 / 스킬 라이브러리 정리 / 삭제 — 를 다룹니다.

한눈에 보기

1. 활성·비활성 — 에이전트 전체를 잠그기

에이전트를 삭제하지 않고 아예 사용하지 않는 상태로 두고 싶다면, 에이전트 상태 토글을 INACTIVE로 바꾸면 됩니다.

에이전트 페이지 → 설정 서브페이지에서 “에이전트 상태” 항목의 토글을 OFF(INACTIVE)로 두면 다음과 같이 동작합니다.

• 에이전트 목록에서 흐리게 표시되거나 별도로 구분됩니다.
• 스케줄·자율 활동·웹훅 등 모든 자동 실행이 차단됩니다.
• 단, 직접 채팅은 계속 가능합니다. (자동 비활성화된 에이전트라면 사용자가 메시지를 보내는 순간 자동으로 다시 활성화됩니다.)

다시 ON(ACTIVE)으로 켜면 즉시 원래대로 동작합니다. 설정·메모리·스킬은 그대로 보존됩니다.

이 토글은 시스템 에이전트에는 표시되지 않습니다.

오래 방치하면 자동으로 잠시 멈춤

직접 손대지 않아도, 일정 기간(약 일주일) 동안 사용자가 채팅을 보내거나 에이전트 페이지를 열지 않으면 에이전트가 자동으로 INACTIVE 상태로 전환됩니다. 전환되면 알림으로 알려드리고, 전환 하루 전에 미리 한 번 안내 알림도 보냅니다.

다시 깨우는 건 간단합니다. 이렇게 자동으로 멈춘 에이전트는 사용자가 다시 메시지를 보내는 순간 곧바로 ACTIVE로 복귀합니다. 별도로 토글을 켤 필요가 없습니다.

이 자동 전환은 “오래 방치된” 에이전트에만 적용됩니다. 사용자가 직접 토글을 끈 경우나 크레딧 부족으로 멈춘 경우에는 메시지를 보내도 자동으로 켜지지 않으니, 해당 원인을 먼저 해결한 뒤 직접 다시 켜야 합니다.

2. 잠시 멈추기 — 자율 실행을 임시로 끄기

UpServe 에이전트는 다음 세 가지 트리거로 사용자가 부르지 않아도 스스로 움직일 수 있습니다.

• 스케줄 — 정해진 시간/주기에 실행 (예: 매일 오전 9시)
• 자율 활동(Heartbeat) — 활동 시간대 안에서 일정 간격으로 스스로 점검
• 웹훅 — 외부 서비스에서 들어오는 신호로 실행

“이 에이전트를 며칠 동안 가만히 두고 싶다”면 위 트리거들을 끄면 됩니다. 각 트리거는 토글 한 번으로 끄고 켤 수 있고, 다시 켜면 그대로 동작합니다.

스케줄 끄기

1. 에이전트 페이지에서 스케줄 서브페이지를 엽니다 (/agents/<에이전트>/schedules).
2. 끄고 싶은 스케줄 카드 오른쪽의 토글을 OFF로 둡니다.
3. 다시 돌리고 싶을 때 토글을 ON으로 돌리면 다음 예정 시각부터 재개됩니다.

스케줄을 완전히 없애지 않아도 되니, “잠깐만 멈추기”에 가장 편한 방법입니다.

자율 활동(Heartbeat) 끄기

자율 활동은 활동 시간대 밴드 안에서 일정한 간격으로 에이전트가 스스로 깨어나 “지금 할 일이 있나?” 확인하는 기능입니다. 끄는 방법은 두 가지입니다.

• 간단히 OFF: 스케줄 서브페이지에서 자율 활동 카드의 토글을 OFF.
• 활동 시간대 비우기: 같은 카드의 편집을 열어 모든 시간대 밴드를 삭제하면 비활성 상태가 됩니다.

자율 활동을 끄면 에이전트는 사용자가 직접 메시지를 보내거나 스케줄·웹훅이 호출될 때만 동작합니다.

웹훅 끄기

웹훅 서브페이지에서 웹훅 수신을 OFF로 두면 외부 신호로 깨어나지 않습니다.

메시지 한 줄로 잠깐만 멈추고 싶을 때는 채팅에 “오늘은 더 일하지 마”라고 말해도 됩니다. 단, 이건 이번 자율 흐름에 대한 부탁일 뿐 다음 스케줄 시간이 되면 다시 깨어납니다. 확실하게 멈추려면 위 토글을 사용하세요.

3. 메모리 정리 — 잘못 배운 내용 되돌리기

에이전트는 작업하면서 자기만의 메모리 노트(Brain) 를 쌓아갑니다. 사용자 취향, 자주 쓰는 데이터, 작업 노하우 등이 자동으로 쌓이는데, 가끔 잘못 학습되거나 더 이상 맞지 않는 내용이 남기도 합니다.

Brain 패널에서 무엇이 쌓였는지 확인하기

에이전트 채팅 화면 오른쪽 도구 모음에서 두뇌 모양 아이콘을 누르면 Brain 패널이 열립니다. 이 패널에는 다음이 보입니다.

• SOUL.md / AGENT.md / MEMORY.md — 에이전트의 정체성·방침·메모리 인덱스
• 사용자 메모(user) — 사용자 취향·맥락
• 피드백(feedback) — 작업 완료 후 정리된 노하우
• 프로젝트(project) — 진행 중인 프로젝트 정보
• 참조(reference) — 자주 보는 자료
• 기타(other) — 위 분류에 속하지 않는 메모리 파일

각 파일을 눌러 내용을 직접 확인하거나 편집할 수 있습니다. 캐시가 오래되었다면 오른쪽 위 새로고침 버튼을 한 번 눌러주세요.

잘못된 내용을 되돌리고 싶을 때

가장 자연스러운 방법은 에이전트에게 말로 부탁하는 것입니다. 사용자가 직접 파일을 손대지 않아도 됩니다.

전체 초기화 — 대화·메모리 통째로 지우기

에이전트 페이지 → 설정 서브페이지 맨 아래 위험 영역에서 “에이전트 초기화” 를 누르면 다음이 사라집니다.

• 대화 기록 전체
• Brain(메모리·노트) 전체
• 캔버스 문서, 진행 중 태스크
• 임시 스케줄(자율 활동을 제외한 일반 스케줄)
• 첨부파일·스크린샷
• 작업 공간(샌드박스) — 다음 사용 시 새로 생성됩니다

남는 것: 에이전트 자체(이름·도구·스킬·설정) 과 자율 활동 스케줄. 즉, “이 에이전트 한 번 백지에서 다시 시작할래”에 가까운 동작입니다. 확인창이 한 번 뜨고, 누른 뒤에는 되돌릴 수 없습니다.

4. 설정 서브페이지에서 바꿀 수 있는 것

에이전트 페이지 → 설정 서브페이지에서 변경 가능한 항목을 한눈에 정리합니다.

5. 실행 로그·비용 확인

에이전트 페이지 → 로그 서브페이지(/agents/<에이전트>/logs)에서 최근 사용 내역과 크레딧 소비를 확인할 수 있습니다.

기간은 7일 / 30일 / 90일 중 선택할 수 있습니다.

표시되는 항목:

• 총 사용 크레딧 — 선택한 기간 동안의 합계
• 총 요청 수 — 모델 호출 횟수
• 트리거별 사용량 — 사용자가 직접 보낸 메시지 / 스케줄 / 웹훅 / 자율 활동 등으로 나눠 표시 (멘션 등 기타 트리거는 색상 없이 회색으로 표시됩니다)
• 유형별 비용 — LLM 호출 비용과 인프라/도구(샌드박스 등) 비용의 두 가지 비중
• 모델별 사용량 — 어떤 모델이 얼마나 쓰였는지
• 일별 추이 — 막대 차트로 최근 사용 패턴
• 스케줄 실행 이력 — 자동 실행이 언제 어떤 결과로 끝났는지

크레딧이 예상보다 빨리 줄어든다면, “트리거별” 항목에서 자율 활동·스케줄 비중이 크지 않은지 먼저 확인하세요. 자율 활동을 너무 자주 깨우도록 설정해두면 사용자가 부르지 않아도 크레딧이 계속 빠집니다.

6. 스케줄·웹훅 정리

더 이상 안 쓰는 자동화는 OFF만 해둬도 동작하지 않지만, 화면을 깔끔하게 유지하려면 삭제하는 게 좋습니다.

• 스케줄 삭제: 스케줄 서브페이지에서 각 카드의 삭제 버튼.
• 웹훅 비활성: 웹훅 서브페이지에서 OFF.
• 앱 푸시 알림: 에이전트 페이지 → 설정 서브페이지 → 채널(Channels) 섹션에서 토글을 OFF로 두면 이 에이전트의 푸시 알림이 꺼집니다.

자율 활동(Heartbeat) 스케줄은 삭제 대신 토글 OFF 또는 활동 시간대 비우기를 권장합니다. 다시 켜고 싶을 때 동일한 프로필을 그대로 쓸 수 있기 때문입니다.

7. 스킬 라이브러리 정리

스킬을 많이 설치하다 보면 오래된 스킬, 더 이상 실행되지 않는 스킬, 같은 역할을 하는 중복 스킬이 쌓이게 됩니다. 이 정리 기능은 개별 에이전트 설정이 아니라 내 계정 설정(Settings) 에 있습니다. 내 계정 Settings → 스킬 라이브러리 정리(/settings/library-cleanup) 페이지를 열면 UpServe가 주기적으로 스캔한 정리 후보 목록을 카드로 볼 수 있습니다.

어떤 항목이 검출되나요?

5가지 유형으로 분류됩니다.

어떻게 사용하나요?

1. /settings/library-cleanup 페이지를 엽니다.
2. 화면에 정기 검사 토글이 있습니다. ON이면 주기적으로 자동 검사를 실행합니다. OFF로 두면 자동 검사를 건너뜁니다. 현재 정리 후보가 없을 때는 빈 화면의 “지금 실행” 버튼으로 수동 검사를 돌릴 수 있습니다.
3. 검출된 항목 카드가 표시되면, 항목별 체크박스로 선택한 뒤 “선택 항목 적용” 또는 “선택 항목 기각” 을 누릅니다.
   • 적용: 해당 스킬 설치를 제거하거나 원본 업데이트를 반영하는 권고 조치가 실행됩니다.
   • 기각: 그 항목을 이번 라운드에서 무시합니다. 다음 주기 검사에서 다시 나타날 수 있습니다.
4. 모두 처리했거나 전부 무시하려면 “모두 기각” 버튼을 사용합니다.

자율 스킬 시스템이 어떻게 스킬 품질을 개선하는지 더 알고 싶다면 스킬과 자율 스킬 시스템을 참고하세요.

8. 삭제 — 에이전트 완전히 정리하기

에이전트 페이지 → 설정 서브페이지 맨 아래 위험 영역에서 “삭제” 를 누릅니다.

사라지는 것

• 자동 실행: 스케줄, 자율 활동, 웹훅, 이벤트 트리거가 즉시 멈춥니다.
• 작업 공간(샌드박스)이 정리됩니다.
• 팀 안에 있던 에이전트라면 팀 연결이 끊깁니다.
• 에이전트 목록에서 보이지 않게 됩니다.

보존되는 것

• 대화 기록과 메모리 자체는 데이터베이스에 남아 있습니다(소프트 삭제). 사용자가 직접 다시 보거나 복구하는 UI는 제공되지 않지만, 다른 기록과 엮인 부분(예: 누가 어떤 스킬을 만들었는지)을 보존하기 위해 유지됩니다.
• 첨부파일·아바타 는 다른 대화나 공유 기록을 깨뜨리지 않기 위해 그대로 남습니다.
• 이 에이전트가 만든 스킬·캔버스 중 마켓플레이스에 공개해뒀거나 다른 사람에게 공유한 항목은 그대로 유지됩니다.

삭제하지 못하는 경우

• 에이전트가 지금 실행 중일 때 는 삭제가 막힙니다. 잠시 기다렸다가 실행이 끝난 뒤 다시 시도하세요.
• 공유 에이전트(시스템 에이전트) 는 일반 사용자가 삭제할 수 없습니다.

삭제 후에는 에이전트 상세·로그·비용 통계 페이지에서도 더 이상 조회되지 않습니다. 이미 삭제된 에이전트에 대해 삭제를 다시 요청해도 오류 없이 성공으로 처리됩니다.

고급 (Advanced)

아래 내용은 일반 사용자에게 필요하지 않습니다. 메모리 구조를 직접 들여다보거나, 자율 활동을 세밀하게 조정해야 할 때만 참고하세요.

Brain 파일 구조

Brain 패널은 에이전트 작업 공간의 .brain/ 폴더를 그대로 보여줍니다. 주요 파일:

Brain 파일은 에이전트 전용(private) 입니다. 팀원과 공유해야 하는 정보는 에이전트에게 “팀 공유 메모로 옮겨줘”라고 부탁하면 별도 공유 영역(team_state)에 저장됩니다.

패널은 파일을 직접 편집할 수 있습니다. 새로고침 버튼을 누를 때만 작업 공간을 깨워 최신 상태를 가져옵니다. 평소에는 로컬 캐시만 사용하므로 패널을 열어두어도 비용이 발생하지 않습니다.

자율 활동(Heartbeat) 동작 요약

자율 활동 스케줄은 다음과 같이 동작합니다.

• 활동 시간대(밴드): 요일·시작 시각·종료 시각·간격을 묶은 단위. 여러 밴드를 둘 수 있습니다.
• 간격 프리셋: 30분 / 1시간 / 2시간 / 3시간 / 4시간 / 6시간 / 8시간 / 12시간 / 24시간.
• 타임존: 사용자 타임존을 기본으로 따르며, 카드 편집 화면에서 변경 가능.
• 밴드가 0개면 비활성: 모든 밴드를 삭제하면 자율 활동이 멈춥니다.

자율 활동 중에는 일반 사용자 메시지와는 다른 경량 컨텍스트로 깨어나며, 할 일이 없다고 판단하면 곧바로 종료합니다(불필요한 모델 호출을 피하기 위함). 자세한 동작은 사용자 대시보드의 비용 로그에서 트리거별 사용량으로 확인할 수 있습니다.

삭제 후 데이터 보관 정책 (확인 가능한 범위)

• 에이전트 레코드: status = DELETED 로 표시하고 deleted_at 시각을 기록합니다. 목록·검색에서 즉시 제외됩니다.
• 작업 공간(샌드박스): 즉시 정리됩니다.
• 자동 실행 설정: 스케줄·이벤트 트리거·웹훅 콜백이 일괄 비활성화됩니다.
• 대화·캔버스·태스크 등 콘텐츠 행: 보존됩니다. 사용자가 직접 영구 삭제하고 싶다면 별도 문의가 필요합니다.

위 정책은 코드(AgentService.delete)에서 직접 확인한 내용이며, 변경 시 이 문서도 함께 갱신됩니다.