에이전트 공유 (스냅샷)

내가 만든 에이전트를 로그인하지 않은 외부 사용자도 그대로 사용할 수 있도록 링크 한 줄로 배포할 수 있습니다. 외부 사용자는 UpServe 계정 없이 채팅 화면에 들어와 에이전트와 대화하며, 비용은 모두 소유자(나)의 크레딧에서 차감됩니다.

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

한눈에 보기

항목	내용
공유 단위	스냅샷 (생성 시점 에이전트의 사본)
외부 사용자 로그인	불필요
비용 부담 주체	소유자의 크레딧에서 차감
링크 유형	`link` (단독 페이지) · `embed` (iframe 위젯)
만료	시간 기반 만료 없음 — 소유자가 수동 해제하거나 안전 장치가 자동 차단
안전 장치	세션당 / 일일 크레딧 상한, 활성 토글, 자동 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> — 임베드 코드 스니펫이 함께 제공됩니다.

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

`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은 선택 항목입니다. 허용 도메인 검증을 통과한 경우에만 적용됩니다.

외부 사용자가 보는 화면

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

비용과 안전 장치

공유 링크에서 발생하는 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. 한 에이전트당 만들 수 있는 스냅샷·링크 수에 제한이 있나요?

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

더 알아보기

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