Deyo user guide

처음 설정부터 운영과 삭제까지, 한 흐름으로 안내합니다.

기능 목록만 나열하지 않고 실제 워크스페이스를 만들고 지식을 검증해 고객에게 공개한 뒤 개선하는 순서와 정확한 한도를 설명합니다.

소개·시작하기

Deyo 소개와 시작하기

지식을 근거로 답하고 필요할 때 담당자에게 연결하는 Deyo의 기본 흐름을 안내합니다.

Deyo가 하는 일

Deyo는 웹사이트와 문서, 확정 Q&A를 지식으로 등록해 고객 질문에 답하는 AI 고객 메신저입니다. 답변할 근거가 부족하거나 실제 계정 확인이 필요한 문의는 추측하지 않고 담당자 연결로 전환할 수 있습니다.

운영자는 Playground에서 답변과 근거를 확인하고, 웹 위젯을 설치한 뒤 Inbox에서 AI 대화와 담당자 연결 문의를 함께 관리합니다.

  • 지식 소스: 웹사이트, 학습용 문서, FAQ 파일, 화면에서 작성한 Q&A
  • 품질 확인: Playground 대화 테스트와 평가 질문
  • 고객 접점: 허용한 도메인에서만 동작하는 웹 채팅 위젯
  • 운영: Inbox 답장, 담당자 알림, 사용량과 Insights

처음 공개하기까지

다음 순서로 설정하면 지식 등록과 설치 상태를 하나씩 확인할 수 있습니다.

  1. 1워크스페이스를 만들고 고객에게 보일 AI 이름과 응대 지침을 정합니다.
  2. 2데이터 소스에서 웹사이트, 문서 또는 Q&A를 등록하고 상태가 학습 완료가 될 때까지 기다립니다.
  3. 3Playground에서 대표 질문, 다른 표현의 질문, 답할 수 없어야 하는 질문을 테스트합니다.
  4. 4설정의 보안 탭에 실제 설치할 https origin을 추가합니다.
  5. 5설정의 설치 탭에서 스크립트를 복사해 사이트에 한 번만 넣습니다.
  6. 6담당자 연결과 이메일 또는 Slack 알림을 실제로 시험합니다.

워크스페이스 단위로 운영하기

지식, 대화, 멤버, 위젯 설정, 사용량과 요금제는 워크스페이스별로 분리됩니다. 브랜드나 서비스가 다르면 워크스페이스를 나누고, 같은 고객지원 지식을 여러 채널에서 쓴다면 하나의 워크스페이스를 여러 허용 도메인에 설치할 수 있습니다.

한 계정으로 여러 워크스페이스에 참여할 수 있으며 각 워크스페이스에서 역할과 권한이 다를 수 있습니다.

언어와 안내 범위

위젯 화면 언어는 자동, 한국어, 영어, 일본어 중 선택할 수 있습니다. 자동은 방문자의 브라우저 언어를 기준으로 화면 문구를 고릅니다. AI 답변 언어는 등록한 지식과 응대 지침의 영향을 받으므로 공개 전에 언어별 대표 질문을 확인하세요.

Deyo에는 고객이 호출하는 공개 관리 REST API나 SDK가 없습니다. 설치에는 워크스페이스별 위젯 스크립트를 사용하고, 공개되지 않은 내부 경로를 외부 연동에 사용하지 않습니다.

현재 카카오톡 상담톡·알림톡, 문자와 외부 메신저를 고객 상담 채널로 연결하는 기능은 제공하지 않습니다. 고객 문의는 허용한 도메인에 설치한 웹 채팅 위젯으로 받고, Slack과 이메일은 담당자 연결 알림에 사용합니다.

콘텐츠를 바꾼 뒤 자동 반영을 기다리지 말고 해당 소스를 수동으로 재학습한 다음 Playground에서 다시 확인하세요.

계정·워크스페이스

계정·워크스페이스·역할·소유권

워크스페이스 경계, 팀 역할, 초대와 소유권 이전, 삭제 전 확인 사항을 설명합니다.

워크스페이스와 계정의 차이

계정은 로그인하는 개인 단위이고 워크스페이스는 지식과 대화, 멤버, 위젯, 사용량이 모이는 운영 단위입니다. 계정 한 개로 여러 워크스페이스를 만들거나 초대받을 수 있습니다.

워크스페이스를 전환해도 다른 워크스페이스의 지식이나 대화가 섞이지 않습니다. 요금제와 사용량도 워크스페이스별로 확인합니다.

소유자·관리자·멤버 역할

팀 협업은 Free를 포함한 모든 플랜에서 기본으로 사용할 수 있습니다. 역할에 따라 변경할 수 있는 범위가 다릅니다.

  • 소유자: 결제, 워크스페이스 이름과 삭제, 소유권 이전을 포함한 전체 권한
  • 관리자: 지식, AI, 위젯, 알림, 보안과 팀의 운영 설정 관리
  • 멤버: 대화 응대와 허용된 조회·테스트 기능 사용

민감한 변경은 필요한 사람에게만 관리자 또는 소유자 권한을 부여하세요.

초대와 소유권 이전

팀 탭에서 이메일로 멤버를 초대하고 역할을 선택할 수 있습니다. 초대가 만료되거나 잘못 보냈다면 다시 보내거나 취소합니다.

소유권은 초대를 수락하고 실제로 로그인한 활성 관리자에게만 이전할 수 있습니다. 현재 소유자는 새 소유자를 선택하고 워크스페이스 이름을 정확히 입력해 확인합니다. 완료되면 이전 소유자는 관리자가 되며 자동으로 되돌릴 수 없습니다.

  1. 1설정 > 팀에서 대상 사용자를 관리자로 초대합니다.
  2. 2대상 사용자가 초대를 수락하고 한 번 로그인했는지 확인합니다.
  3. 3소유권 이전에서 새 소유자를 선택하고 워크스페이스 이름을 입력합니다.
  4. 4권한과 알림 수신자를 다시 확인합니다.

워크스페이스 삭제 전 확인

워크스페이스 삭제는 소유자만 요청할 수 있습니다. 무료 또는 체험 워크스페이스는 삭제 적용 시 접근과 위젯이 차단됩니다. 남은 유료 이용 기간이 있으면 현재 기간 종료일에 삭제가 예약될 수 있습니다.

예약된 삭제는 적용일 전 소유자가 철회할 수 있습니다. 삭제가 적용된 뒤에는 철회할 수 없으며 고객 콘텐츠는 삭제 적용 후 30일 뒤 영구 삭제됩니다. 법령상 보관 의무가 있는 결제·감사 기록은 고객 콘텐츠와 별도로 처리될 수 있습니다.

삭제 전에 필요한 지식 원문과 대화 기록을 별도로 보관하고 사이트에서 위젯 스크립트도 제거하세요.

지식 소스

지식 소스·파일·웹 학습·재학습

지원 형식과 정확한 가져오기 한도, 웹 학습, 삭제와 복원, 수동 재학습 절차를 정리합니다.

등록할 수 있는 지식

웹사이트 주소를 탐색해 페이지를 학습하거나, 학습용 문서와 FAQ 파일을 업로드하거나, 화면에서 확정 Q&A를 직접 작성할 수 있습니다. 서로 다른 출처가 같은 내용을 말할 때는 최신 정본을 남기고 오래된 자료를 정리하세요.

학습 완료 상태의 자료만 답변 검색에 사용됩니다. 처리 중이거나 실패한 자료는 원인을 해결한 뒤 다시 시도합니다.

지원 파일과 가져오기 한도

FAQ 파일은 JSON, JSONL, CSV를 지원합니다. 문서 파일은 Markdown(.md, .markdown), TXT, PDF를 지원합니다. DOCX, PPTX, XLSX, HWP, HWPX는 학습 파일로 지원하지 않으므로 PDF, Markdown 또는 TXT로 변환한 뒤 내용을 확인해 올리세요.

파일 하나는 최대 10MB이고 한 번에 최대 10개를 선택할 수 있습니다. PDF는 300쪽 이하, 추출된 문서는 200만 자 이하, FAQ는 파일당 5,000행 이하입니다.

  • FAQ: .json, .jsonl, .csv
  • 문서: .md, .markdown, .txt, .pdf
  • FAQ 필수 필드: question, answer
  • 검색 표현 확장: alternative_questions 또는 variations

웹사이트 학습과 수동 재학습

웹사이트 주소를 입력하면 탐색 결과에서 학습할 페이지를 선택할 수 있습니다. 로그인 뒤에 있는 페이지, robots 정책으로 막힌 페이지, 브라우저에서만 생성되는 일부 내용은 가져오지 못할 수 있습니다.

원본 웹페이지나 파일 내용이 바뀌어도 항상 자동으로 동기화되는 기능으로 안내하지 않습니다. 데이터 소스에서 해당 자료의 재학습을 직접 실행하고, 완료 후 Playground에서 대표 질문을 다시 확인하세요.

  1. 1데이터 소스에서 변경된 자료를 찾습니다.
  2. 2재학습을 실행하고 처리 상태와 실패 페이지를 확인합니다.
  3. 3학습 완료 뒤 Playground에서 기존 답변과 변경된 답변을 비교합니다.
  4. 4오래된 Q&A나 중복 소스가 남아 있으면 정리합니다.

삭제와 7일 복원

일반 지식 소스를 삭제하면 답변 검색에서 즉시 제외되며 삭제된 자료에서 7일 안에 복원할 수 있습니다. 복원 기간이 지나면 다시 원본을 등록하고 학습해야 합니다.

온보딩 중 명시적으로 영구 삭제한 자료나 이미 보존 기간이 끝난 자료에는 같은 복원 규칙이 적용되지 않을 수 있습니다. 중요한 원본은 Deyo 밖의 관리 위치에도 보관하세요.

AI·품질 관리

AI 설정·Playground·평가·담당자 연결

모델과 지침을 설정하고 근거 답변, 평가, 담당자 연결을 검증하는 방법입니다.

모델과 응대 지침

Free는 기본 경량 모델을 사용하고 Starter와 Pro는 제공되는 고급 모델을 선택할 수 있습니다. 고성능 모델을 선택해도 없는 사실을 만들어도 된다는 뜻은 아닙니다. 답변 범위와 담당자 연결 조건은 지식과 운영 지침으로 함께 통제하세요.

응대 지침에는 말투, 답변 순서, 반드시 확인할 조건, 답하지 않고 연결할 범위를 구체적으로 적습니다. 내부 구현이나 비밀 정보를 지침에 넣지 마세요.

Playground에서 확인할 질문

Playground 테스트는 고객에게 노출되지 않으며 월 AI 답변 사용량과 하루 최대 AI 답변 수에 포함되지 않습니다.

  • 정답과 근거가 명확한 대표 질문
  • 띄어쓰기, 줄임말, 다른 어순을 쓴 같은 의도의 질문
  • 여러 문서를 함께 확인해야 하는 질문
  • 등록한 근거로 답할 수 없는 질문
  • 실제 계정·결제 확인처럼 담당자가 처리해야 하는 질문

평가 질문과 개선

Playground의 평가 탭에서 반복 실행할 질문을 관리하면 지식이나 지침을 바꾼 뒤 답변 품질을 비교하기 쉽습니다. 정답 문구만 완전히 일치시키기보다 필요한 사실, 근거, 담당자 연결 여부를 함께 봅니다.

틀린 답변은 먼저 표시된 출처가 최신인지 확인하고, 원문을 고치거나 확정 Q&A를 추가한 뒤 재학습합니다. 서로 충돌하는 자료가 있으면 모델 변경보다 자료 정리가 우선입니다.

담당자 연결을 검증하는 법

등록된 지식으로 답하기 어렵거나 실제 계정 상태, 결제·환불·세금계산서처럼 사람이 확인해야 하는 문의는 담당자 연결로 전환합니다. 서비스 운영 주체, 사업 정보, 제휴나 언론 관련 문의와 방문자가 명시적으로 담당자 연결을 요청한 경우도 담당자가 응대합니다. 연결 조건이나 처리 방식을 묻는 설명형 질문만으로 담당자를 호출하지 않습니다.

연결되면 위젯이 담당자 확인 중 상태로 바뀌고 설정한 이메일 또는 Slack으로 알림을 보냅니다. 담당자는 알림 링크 또는 Deyo Inbox에서 앞선 대화 맥락을 확인한 뒤 같은 위젯 대화에 답장합니다.

담당자 연결 답변에는 근거 소스를 억지로 붙이지 않습니다.

위젯 설치

위젯 설정·설치·허용 도메인·제거·CSP

설치 코드, origin 허용 목록, 디자인, CSP와 제거 절차를 개발자 관점까지 설명합니다.

설치 전 준비

설정 > 위젯에서 브랜드 색상, 첫 인사말, 좌우 위치와 화면 언어를 정합니다. 설정 > 보안에는 위젯을 실제로 띄울 사이트의 origin을 추가합니다.

origin은 https://example.com처럼 프로토콜과 호스트, 필요한 경우 포트까지 포함하고 경로나 마지막 슬래시는 넣지 않습니다. 운영과 스테이징 주소가 다르면 각각 등록합니다.

설치 스크립트 넣기

설정 > 설치에서 현재 워크스페이스용 script 태그를 복사합니다. 사이트 공통 레이아웃의 body 끝부분이나 프레임워크의 안전한 외부 스크립트 로더에 한 번만 추가하세요.

스크립트의 data-workspace-id는 워크스페이스를 식별하므로 다른 워크스페이스의 값을 섞지 않습니다. 로더는 페이지가 준비된 뒤 위젯을 마운트하며 같은 페이지에 중복 삽입해도 하나만 표시되도록 보호됩니다.

외부 script 태그를 추가하고 정확한 origin을 등록할 수 있는 사이트라면 개발자 없이도 직접 설치할 수 있습니다. 사이트 빌더가 사용자 정의 스크립트를 허용하지 않거나 CSP를 직접 관리하기 어렵다면 사이트 관리자나 개발자의 도움이 필요할 수 있습니다.

CSP와 허용 origin

엄격한 Content-Security-Policy를 사용하면 script-src, connect-src, frame-src에 Deyo 앱 origin을 허용해야 합니다. 사이트 정책에 따라 style-src도 위젯이 사용하는 스타일 방식을 허용해야 할 수 있습니다. 먼저 브라우저 개발자 도구의 CSP 오류를 확인한 뒤 필요한 지시문만 최소 범위로 추가하세요.

Deyo의 허용 도메인 목록과 사이트 CSP는 서로 다른 보호 장치입니다. 둘 중 하나라도 막으면 위젯이 로드되지 않을 수 있습니다.

위젯 제거

사이트 코드에서 Deyo script 태그를 삭제하고 배포하면 새로 여는 페이지에서 위젯이 사라집니다. 이어서 설정 > 보안의 허용 도메인에서도 해당 origin을 제거하세요.

이미 열려 있던 탭은 새로고침 전까지 기존 위젯을 보일 수 있습니다. 스크립트를 제거해도 Deyo의 기존 지식과 대화 데이터가 자동 삭제되지는 않습니다. 데이터 삭제가 필요하면 해당 소스 또는 워크스페이스의 삭제 절차를 별도로 진행합니다.

Inbox·운영

Inbox·대화·알림·Insights·사용량

고객 대화를 이어받고 담당자 알림, 사용량, 지식 갭을 운영하는 방법입니다.

Inbox에서 대화 처리

Inbox에는 위젯 대화와 담당자 연결 상태가 모입니다. 담당자는 대화 맥락과 AI 답변을 확인하고 고객에게 직접 답장할 수 있습니다.

사람이 응대한 뒤 다시 AI 응대로 돌릴 때는 고객이 받을 다음 답변의 기준과 최신 지식 상태를 먼저 확인하세요. 대화를 닫는 것은 운영 상태를 정리하는 동작이며 원본 지식을 바꾸지 않습니다.

이메일과 Slack 알림

설정 > 알림에서 담당자 연결이 발생했을 때 받을 이메일 또는 Slack Incoming Webhook을 등록할 수 있습니다. Slack과 이메일은 담당자 연결 알림 채널이며 모든 AI 대화를 동기화하거나 Slack에서 고객에게 직접 답장하는 기능은 제공하지 않습니다. 알림 링크로 Deyo Inbox를 열어 고객에게 답장합니다.

업무시간을 켜면 담당자 응답 시간과 미응답 알림 계산에 사용됩니다. 실제로 운영하지 않는 시간표를 임의로 넣기보다 조직의 응대 기준이 있을 때만 설정합니다.

AI 답변 사용량

월 사용량에는 위젯에서 고객에게 실제로 전달된 AI 답변이 집계됩니다. Playground 테스트, 평가 실행, 담당자 연결만 이루어진 경우, 오류로 전달되지 않은 답변은 AI 답변 사용량에 포함되지 않습니다.

설정 > 보안에서 하루 최대 AI 답변 수를 둘 수 있습니다. 비워두면 플랜의 월 한도만 적용되고, 하루 한도는 월 한도를 늘리지 않습니다.

Insights와 반복 개선

Insights는 대화 수, 담당자 연결, 준비된 소스와 반복되는 지식 갭을 확인하는 Pro 기능입니다. 수치는 개선할 질문을 찾는 단서이며 자동으로 원문을 수정하거나 재학습하지 않습니다.

반복되는 미답변을 원문 또는 확정 Q&A에 반영하고 수동 재학습한 뒤 Playground 평가로 회귀를 확인하는 순환을 권장합니다.

요금제·결제

체험·요금제·결제·해지·워크스페이스 삭제

플랜별 한도와 체험, 결제 화면 확인, 해지와 유료 워크스페이스 삭제 수명주기를 안내합니다.

플랜별 기본 한도

표시된 한도는 워크스페이스별입니다. 결제 화면과 사용량 화면에 표시되는 현재 플랜을 기준으로 확인하세요.

  • Free: 월 AI 답변 30건, 정제 텍스트 1MB, 논리 지식 소스 3개, 웹 학습 1회 50페이지
  • Starter: 월 AI 답변 500건, 정제 텍스트 10MB, 논리 지식 소스 100개, 웹 학습 1회 150페이지
  • Pro: 월 AI 답변 2,000건, 정제 텍스트 40MB, 논리 지식 소스 300개, 웹 학습 1회 300페이지, Insights와 Deyo 브랜딩 숨김

7일 체험과 결제 확인

새 워크스페이스의 체험은 7일이며 정제 텍스트 5MB, 지식 소스 10개, 웹 학습 1회 150페이지의 체험 지식 한도를 사용합니다. 카드가 등록되지 않았다면 체험 종료만으로 자동 결제되지 않습니다.

결제 예정 여부는 결제 화면에 표시되는 적용일, 금액, 결제 주기와 다음 결제일을 기준으로 확인하세요. 결제 화면에 청구 없음으로 표시되는 운영자 제공 플랜은 결제수단 등록이나 자동 청구 대상이 아닙니다.

플랜 변경과 해지

워크스페이스 소유자가 설정 > 결제에서 제공되는 플랜과 적용 시점을 확인해 변경합니다. 변경 전에 새 한도로 줄어드는 지식과 사용량 영향을 확인하세요.

해지 예약이 완료되면 화면에 이용 종료일이 표시됩니다. 종료 전 재개가 제공되는 경우 소유자가 같은 결제 화면에서 철회할 수 있습니다. 계정별 결제 승인, 환불, 세금계산서처럼 실제 거래 확인이 필요한 요청은 담당자에게 연결합니다.

일시적인 결제 처리 상태를 추정하지 말고 현재 워크스페이스의 결제 화면을 기준으로 안내하세요.

보안·문제 해결

보안·개인정보·문제 해결

도메인 제한과 최소 권한, 데이터 수명주기, 위젯·학습 문제를 점검하는 순서를 제공합니다.

최소 권한과 origin 제한

워크스페이스 역할은 업무에 필요한 최소 권한으로 부여하고 더 이상 참여하지 않는 멤버와 만료된 초대를 정리하세요. 소유자 계정은 결제, 삭제와 소유권 이전 권한이 있으므로 특히 안전하게 관리해야 합니다.

위젯 허용 도메인은 정확한 https origin만 등록합니다. 빈 목록이나 일치하지 않는 origin에서는 운영 위젯이 동작하지 않습니다.

지식과 대화 데이터 관리

공개 답변에 필요하지 않은 비밀키, 비밀번호, 주민등록번호, 결제수단 전체 번호 같은 민감정보는 지식에 넣지 마세요. 고객에게 입력을 요청하는 응대 지침도 최소화합니다.

일반 지식 소스는 삭제 후 7일 안에 복원할 수 있고, 삭제가 적용된 워크스페이스의 고객 콘텐츠는 30일 뒤 영구 삭제됩니다. 자세한 처리 기준은 개인정보처리방침과 이용약관을 함께 확인하세요.

회사는 회원 고객 데이터를 독자적인 광고 목적으로 판매하거나 사용하지 않습니다. AI API로 전송되는 데이터는 공급자의 API 정책에 따라 기본적으로 범용 모델 학습에 사용되지 않는 설정을 전제로 처리합니다.

위젯이 보이지 않을 때

  1. 1페이지 소스에 설치 스크립트와 올바른 data-workspace-id가 한 번 들어갔는지 확인합니다.
  2. 2현재 페이지의 프로토콜·호스트·포트가 설정의 허용 도메인과 정확히 일치하는지 확인합니다.
  3. 3브라우저 개발자 도구에서 CSP, 네트워크, iframe 차단 오류를 확인합니다.
  4. 4캐시를 비우거나 새 시크릿 창과 모바일 화면에서 다시 확인합니다.
  5. 5문제가 계속되면 발생 URL, 시각, 브라우저, 화면 캡처와 오류 문구를 담당자에게 전달합니다.

학습이나 답변이 기대와 다를 때

  1. 1데이터 소스 상태가 학습 완료인지, 실패 페이지나 파일 오류가 있는지 확인합니다.
  2. 2질문의 답이 실제 원문에 명확히 적혀 있고 서로 충돌하는 자료가 없는지 확인합니다.
  3. 3원문을 변경했다면 수동 재학습을 완료합니다.
  4. 4Playground에서 질문, 답변, 표시된 근거와 발생 시각을 기록합니다.
  5. 5계정 확인이나 서비스 범위 밖 문의는 답을 추가하기보다 담당자 연결 조건을 점검합니다.