에이전트 외부 공개 (스냅샷)

내가 키운 에이전트를 링크 하나로 외부인이 지금 모습 그대로 써보게 할 수 있습니다. 로그인하지 않은 외부 사용자도 UpServe 계정 없이 채팅 화면에 들어와 에이전트와 대화하며, 비용은 모두 소유자(나)의 크레딧에서 차감됩니다. 공개해도 원본 에이전트는 영향받지 않습니다.

공유의 단위는 스냅샷(snapshot) 입니다. 스냅샷은 공유 시점의 에이전트를 통째로 복제한 사본이며, 이후 원본을 수정하거나 삭제해도 스냅샷은 독립적으로 유지됩니다.

한눈에 보기

항목	내용
공유 단위	스냅샷 (생성 시점 에이전트의 사본)
외부 사용자 로그인	불필요
비용 부담 주체	소유자의 크레딧에서 차감
링크 유형	`link` (단독 페이지) · `embed` (iframe 위젯)
만료	시간 기반 만료 없음 — 소유자가 수동 해제하거나 안전 장치가 자동 차단
버전 업데이트	링크 주소를 그대로 둔 채 최신 상태로 교체 가능 — 이전 버전은 7일간 보관(그 안에 롤백 가능) 후 자동 정리
안전 장치	세션당 / 일일 크레딧 상한, 활성 토글, 자동 revoke
세션 보관 기간	Free 3일 · Starter 14일 · Pro 90일 (소유자 요금제 기준)
첨부 파일 보관	업로드일 기준 90일 후 자동 영구 삭제 (세션 보관 기간과 별도 산정)

원본 · 스냅샷 · 링크 관계


  [원본 에이전트]                                     [외부 사용자]
   (계속 수정 가능)                                   UpServe 가입 ✗
        │
        │ 스냅샷 생성 (시점 동결)
        │
        ├─▶ 스냅샷 A ─┬─ 링크 1 ─▶ /share/abc...  ─▶  익명 방문자
        │             │
        │             └─ 링크 2 ─▶ /embed/xyz...  ─▶  내 사이트 iframe
        │                  (수집 필드 / 크레딧 상한 / 도메인 화이트리스트는
        │                   링크마다 따로 설정)
        │
        └─▶ 스냅샷 B ─┬─ 링크 3 ─▶ /share/def...
                      └─ 링크 4 ─▶ ...

   ※ 스냅샷은 별도 샌드박스로 복제 → 외부 사용자의 활동은 원본에 영향 없음
   ※ 원본 수정은 기존 스냅샷·링크에 반영되지 않음 (새 스냅샷을 발급해야 함)

스냅샷 생성 상태

스냅샷 생성 버튼을 누르면 즉시 대기 중(pending) 상태로 행이 만들어지고, 실제 복사 작업이 백그라운드에서 시작됩니다. 완료되면 준비됨(ready), 오류가 발생하면 실패(failed) 로 전환됩니다. 화면에서 상태를 폴링하며 기다리면 되고, 완료 전까지는 링크를 발급할 수 없습니다.

스냅샷이 캡처하는 것 / 캡처하지 않는 것

스냅샷은 공유 시점의 에이전트를 격리된 별도 환경으로 복제합니다. 이후 원본 에이전트와 스냅샷은 서로 독립적으로 동작합니다.

캡처되는 것

에이전트의 이름, 설명, 아바타, 행동 지침
활성화된 도구 설정
에이전트의 파일 시스템(기억·작업 폴더 등) — 지정한 경로만 별도 샌드박스로 복제

캡처되지 않는 것

원본 에이전트의 대화 히스토리
웹훅, 스케줄, 멀티 에이전트 관계
원본 에이전트의 크레딧·구독 정보

기억 노출 주의. 에이전트의 파일 시스템에는 과거 대화 요약, 메모, 지식 파일 등 개인적인 내용이 포함될 수 있습니다. 스냅샷 생성 전 미리보기 화면에서 복사될 파일 목록을 반드시 확인하고, 외부에 노출하고 싶지 않은 파일은 제외 경로로 빼두세요.

정제해서 포함. 메모리 파일에 담긴 노하우는 공유하고 싶지만 그 안의 개인정보·고유명사까지 그대로 내보내고 싶지 않을 때가 있습니다. 이런 파일은 미리보기에서 정제해서 포함을 선택하면, 개인정보와 고유명사를 일반화한 정제본만 스냅샷에 담깁니다. 원본 파일은 공유되지 않습니다. 정제가 권장되는 파일에는 “정제 추천” 표시가 함께 나타납니다.

미리보기 파일 내용 확인. 파일 시스템 미리보기는 스냅샷 생성 화면에서 제공됩니다. 내용을 확인할 수 있는 파일은 지정된 화이트리스트 경로 안의 텍스트 파일에 한하며, 바이너리 파일은 내용 대신 “바이너리 파일” 표시가 나타납니다.

스냅샷 세션에서 허용되는 도구

스냅샷 세션은 외부 사용자에게 안전한 읽기·출력 계열 도구만 사용할 수 있습니다. 아래는 허용되는 주요 도구입니다.

웹 검색, 페이지 가져오기
이미지 생성
파일 읽기, 파일 공유
스킬 검색·조회
캔버스 목록 조회
카드 전송 (구조화된 UI 응답)
기억 회수, 히스토리 검색, 원본 대화 참조

코드 실행, 브라우저 자동화, 데스크톱 자동화, 스킬 실행, 스케줄 관리, 팀 협업 등은 자동으로 차단됩니다. 스냅샷 세션에서는 사용자 되묻기도 자동으로 비활성화됩니다 — 에이전트는 외부 사용자에게 직접 질문하는 대신 텍스트 응답 안에서 자연스럽게 안내합니다. 추가로 차단하고 싶은 도구는 스냅샷 생성 시 추가 비활성화 도구 목록에 지정할 수 있습니다.

기억 회수·참조 도구는 외부 화면에 도구명이 보이지 않습니다. 기억 회수(memory_scan), 히스토리 검색(history_read, history_search), 원본 대화 참조(source_chat_read) 4종은 실행되어도 외부 사용자 화면에 도구 이름이 표시되지 않고 “recall” 같은 일반 카테고리로만 나타납니다. 그 외 허용된 도구(웹 검색, 이미지 생성 등)는 화면에 실행 이름이 표시됩니다.

원본 대화 참조 안전 장치. 스냅샷 에이전트는 소유자가 공유를 승인한 범위 안에서만 원본 대화 내용을 참조할 수 있습니다. 이 참조는 스냅샷 생성 시점에 동결된 내용만 포함하며, 그 이후 원본 에이전트가 진행한 대화는 포함되지 않습니다. 외부 사용자는 이 참조를 통해 원본 대화를 직접 열람하거나 검색할 수 없습니다.

공유 링크 만들기

에이전트 상세 페이지 → 스냅샷(Snapshot) 탭으로 이동합니다 (/agents/<에이전트>/shared).
약관·개인정보처리방침에 동의한 뒤 스냅샷 생성 을 클릭합니다.
- 미리보기 화면에서 어떤 파일이 복사되는지 확인할 수 있습니다.
- 패키지 크기 상한이 있으므로, 불필요한 파일이나 외부에 노출되면 안 되는 파일은 제외 경로로 빼두는 것이 좋습니다.
- 생성 직후에는 대기 중(pending) 상태이며, 복사가 완료되면 준비됨(ready) 으로 바뀝니다.
생성된 스냅샷에 링크를 추가합니다. 링크마다 다음을 따로 설정합니다.
- 유형: link (외부 단독 페이지) 또는 embed (내 사이트에 iframe으로 삽입)
- 수집 필드: 이름·이메일·전화번호 각각을 필수 / 선택 / 미수집 중 선택
- 세션당 크레딧 상한 (예: 0.50 USD)
- 일일 크레딧 상한 (예: 5.00 USD)
- 허용 도메인 (embed인 경우): iframe을 띄울 수 있는 도메인 화이트리스트
생성된 URL을 복사하여 배포합니다.
- link 유형: https://upserve.app/share/<link_key>
- embed 유형: https://upserve.app/embed/<link_key> — 임베드 코드 스니펫이 함께 제공됩니다.

한 에이전트가 여러 개의 스냅샷을 가질 수 있고, 각 스냅샷은 다시 여러 개의 링크를 가질 수 있습니다. 캠페인별 / 채널별로 링크를 분리하면 사용량을 따로 추적할 수 있습니다.

스냅샷 업데이트

에이전트를 계속 다듬다 보면, 이미 공유해 둔 스냅샷의 내용을 최신 상태로 바꾸고 싶어질 때가 있습니다. 예전에는 스냅샷을 새로 만들고 링크도 다시 발급해야 했지만, 이제는 이미 공유한 링크 주소(단독 페이지·임베드 모두)를 그대로 둔 채 내용만 최신 버전으로 바꿀 수 있습니다.

스냅샷 목록에서 업데이트할 스냅샷을 찾아 업데이트 버튼을 누릅니다.
이전에 발행했던 이름·설명·공유에서 제외할 파일·공유에서 차단할 도구 설정이 기본값으로 채워진 화면이 열립니다. 원본 에이전트에 새로 생긴 파일은 기본적으로 제외 상태로 표시되며, 공유하고 싶다면 체크를 해제해 포함시킬 수 있습니다.
- 원본 대화 반영 시점을 이전 버전 그대로 유지 옵션을 켜지 않으면, 새 버전은 지금 이 순간까지의 원본 대화 내용을 반영합니다.
업데이트를 누르면 새 버전을 만드는 동안 잠시 기다립니다. 완료되면 지금까지 발급했던 모든 링크가 자동으로 새 버전을 가리키도록 바뀝니다. 이미 공유해 둔 URL이나 임베드 코드를 다시 손볼 필요는 없습니다.

이전 버전은 사라지지 않습니다. 스냅샷 목록의 이전 버전 섹션을 펼치면 지금까지 교체된 버전들을 확인할 수 있고, 새 버전에 문제가 있다면 롤백 버튼으로 링크를 다시 이전 버전으로 되돌릴 수 있습니다. 롤백할 때도 링크 주소는 바뀌지 않습니다.

업데이트가 반영되는 순간에 이미 대화 중이던 방문자는 끊김 없이 이전 버전으로 대화를 이어가고, 그 이후 새로 들어오는 방문자만 새 버전을 만나게 됩니다.

이전 버전은 7일 후 자동으로 정리됩니다. 롤백은 이 7일 안에만 가능합니다. 더 빨리 정리하고 싶다면 스냅샷 목록에서 직접 삭제할 수 있습니다.

자동 갱신 (선택)

매번 손으로 업데이트하기 번거롭다면 스냅샷 수정 화면에서 자동 갱신을 켤 수 있습니다. 켜두면 원본 에이전트가 변경되었을 때 설정한 주기(일 단위) 마다 새 버전을 자동으로 만들어 공유 링크를 전환합니다. 링크 주소는 그대로 유지됩니다. 스냅샷 목록에는 자동 갱신이 켜진 스냅샷과 갱신 주기가 표시되고, 원본이 이 버전 이후 변경되어 원본과 차이 있음 상태가 되면 알림으로 알려줍니다. 자동 갱신은 원본이 실제로 변경되었을 때만 동작하며, 변경이 없으면 새 버전을 만들지 않습니다.

`link` vs `embed` 차이

항목	`link`	`embed`
진입 경로	단독 페이지	iframe 내부
iframe 안에서 열기	차단 (보안)	허용
헤더·배경	표시	숨김 / 투명
부모 페이지와 통신	없음	`postMessage`로 사용자 정보 전달 / 자동 높이 조정
도메인 화이트리스트	사용 안 함	허용 도메인만 임베드·메시지 수신

임베드 스니펫 예시


<iframe
  src="https://upserve.app/embed/<link_key>"
  style="width: 100%; height: 600px; border: 0; border-radius: 12px;"
  allow="clipboard-write"
></iframe>

자동 높이 조정이 필요하면 부모 페이지에서 postMessage로 들어오는 { type: 'resize', height } 이벤트를 받아 iframe.style.height를 갱신하면 됩니다.

부모 페이지가 이미 사용자를 알고 있다면 { type: 'user-context', data: { name, email, phone } }을 iframe으로 보내 입장 폼을 건너뛰게 만들 수도 있습니다. phone은 선택 항목입니다. 허용 도메인 검증을 통과한 경우에만 적용됩니다.

외부 사용자가 보는 화면

링크에 진입하면 에이전트 이름·설명과 함께 입장 폼이 표시됩니다.
링크 설정에 따라 이름·이메일·전화번호를 입력합니다 (필수/선택은 소유자가 정합니다).
약관 / 개인정보처리방침 동의 체크박스 — 외부 사용자가 한 번 동의해야 시작할 수 있습니다.
채팅 화면에서 에이전트와 자유롭게 대화합니다. 답변은 실시간 스트리밍으로 도착합니다.

‘나도 만들기’ 링크 (선택). 공유 화면 하단에는 “UpServe로 제공됩니다” 표기가 붙습니다. 소유자가 링크 설정에서 방문자에게 ‘나도 만들기’ 링크 표시를 켜두면, 이 표기에 UpServe 가입 링크가 연결되어 방문자가 마음에 든 에이전트를 직접 만들어 볼 수 있는 진입점이 됩니다. 기본값은 꺼짐이며, 링크마다 따로 설정합니다.

비용과 안전 장치

공유 링크에서 발생하는 LLM·도구 호출 비용은 모두 소유자의 크레딧에서 차감됩니다. 외부 사용자는 비용을 부담하지 않습니다. 따라서 안전 장치 설정이 매우 중요합니다.

장치	동작
세션당 크레딧 상한	한 사용자의 한 세션이 상한을 넘기면 그 세션은 즉시 차단되고 추가 메시지 전송이 막힙니다
일일 크레딧 상한	링크 전체의 하루 사용량이 상한을 넘기면 신규 세션 생성이 거부됩니다 (다음 날 자동 리셋)
자동 revoke	소유자 크레딧 소진 시 (`credit_exhausted`) 또는 소유자 계정 삭제 시 (`account_deleted`) 링크가 자동 비활성화됩니다
링크 토글	소유자가 언제든 링크를 비활성화 또는 삭제할 수 있습니다 (`owner_revoked`)
Rate limit	메타 조회 분당 30회 / 세션 생성 분당 10회·시간당 60회 (외부 IP 기준)

링크를 비활성화하거나 삭제하면 그 시점에 진행 중이던 외부 세션도 즉시 종료됩니다. 외부 사용자에게는 종료 사유가 표시됩니다.


  [외부 사용자]                                       [소유자 계정]
   익명 방문자                                         크레딧 잔고
        │                                                  ▲
        │ 메시지 전송                                      │
        ▼                                                  │ 차감
   ┌──────────────────────────┐                            │
   │  스냅샷 샌드박스         │ ── LLM 호출 / 도구 호출 ───┘
   │  (격리된 별도 환경)      │
   └──────────────────────────┘
        │
        │ 안전 장치 (모두 통과해야 진행)
        ▼
   ┌──────────────────────────────────────────────┐
   │  ⛔ 세션당 상한 초과       → 세션 차단       │
   │  ⛔ 일일 상한 초과         → 신규 세션 거부  │
   │  ⛔ 소유자 잔고 0          → 링크 자동 revoke│
   │  ⛔ 소유자 수동 비활성화    → 즉시 세션 종료 │
   └──────────────────────────────────────────────┘

운영과 모니터링

소유자 화면(/agents/<에이전트>/shared)에서는 다음을 확인할 수 있습니다.

세션 목록: 각 세션의 사용자 정보, 사용한 크레딧, 마지막 활동 시간, 차단 여부
메시지 로그: 세션별 전체 대화 내용 (소유자만 열람 가능)
감사 로그: 링크 생성·수정·revoke·CSV 내보내기 등의 모든 변경 이력
CSV 내보내기: sessions.csv (세션 목록), messages.csv (메시지 상세), usage.csv (크레딧 사용량 집계), audit-logs.csv (감사 로그) 4종

방문자 대화 피드백 활용. 스냅샷을 1개 이상 발행한 원본 에이전트는 외부 방문자들의 대화 기록을 직접 열람할 수 있습니다. 이 기능을 통해 방문자가 에이전트에게 어떤 질문을 하는지, 어디서 막히는지 파악하고 다음 스냅샷 업데이트에 반영할 수 있습니다.

보안과 개인정보

공유 기능은 외부 사용자의 개인정보를 다루므로 다음 정책이 적용됩니다.

데이터 처리 책임자: 소유자(에이전트를 공유한 사람)가 외부 사용자 데이터의 컨트롤러이며, UpServe는 인프라 처리자 역할을 수행합니다.
수집 항목: 사용자가 직접 입력한 이름·이메일·전화번호(선택), 익명 세션 식별자, IP, User-Agent.
방문자 간 세션 격리: 같은 공유 링크에 여러 방문자가 접속해도 각 방문자의 대화는 서로 노출되지 않습니다. 한 방문자의 대화에서 생겨난 내용은 에이전트에 남지 않으므로, 이후 방문자가 이전 방문자의 대화 내용을 볼 수 없습니다. 공유 시점에 소유자가 담아둔 기억은 모든 방문자에게 동일하게 제공되며, 방문자 대화로 인해 바뀌지 않습니다.
세션 보관 기간: 소유자의 요금제에 따라 자동 정리됩니다 — Free 3일, Starter 14일, Pro 90일. 소유자가 구독을 낮추면 유예 기간 후 이전 등급의 보관 기한을 적용합니다.
첨부 파일: 업로드 시점으로부터 90일 후 자동 영구 삭제 (세션 보관 기간과 별도 산정).
대화 내역: 소유자가 스냅샷을 삭제할 때까지 보관.
로그 기록: 90일 보관.
감사 로그: 영구 보존 (분쟁·법적 대응 목적).
개인정보 삭제 요청: 소유자 대시보드에서 특정 세션의 사용자 정보(이름·이메일·전화번호)를 삭제할 수 있습니다.

자세한 내용은 외부 사용자에게 노출되는 공유 에이전트 약관 과 개인정보처리방침 을 참고하세요.

자주 묻는 질문

Q. 원본 에이전트를 수정하면 이미 배포된 공유 링크에 반영되나요?

아닙니다. 스냅샷은 생성 시점에 동결됩니다. 다만 스냅샷 목록에서 업데이트 기능을 사용하면, 이미 공유해 둔 링크 주소를 그대로 유지한 채 최신 상태로 새 버전을 만들 수 있습니다. 자세한 방법은 위 “스냅샷 업데이트” 섹션을 참고하세요.

Q. 외부 사용자가 에이전트의 기억 파일이나 메모를 영구적으로 바꿀 수 있나요?

아닙니다. 외부 사용자의 활동은 원본 에이전트에 영향을 주지 않습니다. 또한 한 방문자의 대화에서 생겨난 내용은 에이전트에 저장되지 않기 때문에, 같은 공유 링크를 통해 들어온 다른 방문자가 이전 방문자의 대화 내용을 볼 수 없습니다. 공유 시점에 소유자가 담아둔 기억은 모든 방문자에게 동일한 출발점으로 제공되며, 방문자 대화로 인해 바뀌지 않습니다.

Q. 공유 페이지에서 첨부 파일 업로드나 이미지 생성을 사용할 수 있나요?

기본적으로 가능합니다(파일 공유와 이미지 생성 도구가 허용됩니다). 비용 통제가 걱정된다면 스냅샷 생성 시 추가 비활성화 목록에 빼두면 됩니다.

Q. 비밀번호 보호나 만료일 설정이 가능한가요?

현재는 지원하지 않습니다. 대신 링크 자체를 비활성화하거나 삭제하는 방식으로 접근을 즉시 차단할 수 있고, 일일/세션 크레딧 상한으로 노출을 제한할 수 있습니다.

Q. 한 에이전트당 만들 수 있는 스냅샷·링크 수에 제한이 있나요?

기능적인 개수 제한은 두지 않습니다. 다만 스냅샷마다 별도의 샌드박스가 복제되므로, 활용하지 않는 스냅샷은 정리하는 편이 좋습니다.

더 알아보기

도구 부여하기 — 공유 전 어떤 도구를 활성화할지 결정하기
스킬과 자율 스킬 시스템 — 외부 사용자가 의존할 스킬을 정리하기
공유 에이전트 약관
공유 에이전트 개인정보처리방침

고급 (Advanced)

아래 내용은 일반 사용 시 알 필요가 없습니다. 업데이트·롤백의 내부 동작을 정확히 이해하고 싶을 때만 참고하세요.

스냅샷 업데이트 동작 방식

업데이트는 기존 스냅샷을 고쳐 쓰는 것이 아니라, 원본 에이전트의 현재 상태로 완전히 새로운 스냅샷을 만든 뒤 기존 링크들을 한 번에 새 스냅샷으로 전환하는 방식으로 동작합니다. 전환이 끝나기 전까지는 이전 버전이 계속 응답을 이어갑니다.
전환 시점 이전에 이미 대화를 시작한 방문자는 접속했던 버전으로 세션이 유지되고, 전환 이후 새로 들어오는 방문자만 새 버전으로 안내됩니다.
“이전 버전”으로 넘어간 스냅샷은 대체된 시점부터 정확히 7일이 지나면 백그라운드 정리 작업이 자동으로 영구 삭제합니다 (연결된 방문자 세션·실행 환경 포함). 롤백은 이 7일 안에서만 가능합니다.
롤백해도 새로 만든 버전 자체는 삭제되지 않고 목록에 남지만, 그 순간부터는 어떤 링크와도 연결되어 있지 않습니다. 이 버전을 다시 쓰려면 새 링크를 발급하거나(새 주소로 발급됨) 이 버전을 대상으로 다시 업데이트를 실행해야 하는데, 업데이트는 그때마다 원본 에이전트의 현재 상태를 새로 복제하는 것이라 롤백 전 이 버전의 내용이 그대로 되살아나는 것은 아닙니다.
원본 에이전트가 삭제된 스냅샷은 업데이트할 수 없습니다(업데이트 버튼이 비활성화됩니다) — 반영할 원본이 더 이상 존재하지 않기 때문입니다.
스냅샷 파일을 직접 편집하는 기능은 없습니다. 내용을 바꾸려면 항상 원본 에이전트를 먼저 고친 뒤 업데이트를 실행해야 합니다.