​

SDK 개요

Moss SDK는 AI 기반 어시스턴트를 웹 애플리케이션에 임베드합니다. 페이지 컨텍스트를 캡처하고, Moss 백엔드와 통신하며, 인터랙티브한 어시스턴트 UI를 렌더링합니다 — 기존 스타일이나 레이아웃에 영향을 주지 않습니다.

​

작동 방식

사용자가 질문을 하면 SDK는 다음을 수행합니다:

1. 페이지 컨텍스트 캡처 — DOM 구조, 표시되는 텍스트, 선택적 스크린샷
2. Moss 백엔드로 전송 — 사용자의 메시지 및 대화 기록과 함께
3. AI 생성 안내 수신 — 텍스트 응답 또는 단계별 지침을 포함할 수 있음
4. 응답 렌더링 — 요소 하이라이팅 및 코치 마크가 포함된 채팅 모달에서

전체 UI는 Shadow DOM 내부에 렌더링되므로 Moss 스타일이 애플리케이션의 CSS와 충돌하지 않습니다.

​

통합 방법

SDK는 두 가지 통합 방법을 지원합니다: 두 방법 모두 동일한 어시스턴트 UI와 기능을 제공합니다. 기술 스택에 따라 선택하세요.

​

캡처되는 정보

어시스턴트가 현재 페이지에 대한 컨텍스트가 필요할 때 SDK는 다음을 캡처합니다:

• 표시되는 텍스트 콘텐츠 (DOM에서)
• 인터랙티브 요소 (버튼, 링크, 폼 필드)와 레이블 및 상태
• 페이지 스크린샷 (설정 가능: 전체 페이지 또는 뷰포트만)
• 페이지 URL 및 메타데이터

​

브라우저에 저장되는 항목

SDK는 페이지 이동과 새로고침 후에도 대화가 이어지도록 자체 상태를 소량 브라우저 스토리지에 보관합니다. SDK가 기록하는 모든 항목은 moss 접두사가 붙은 키에 저장됩니다. 캡처된 페이지 컨텍스트와 스크린샷은 브라우저 스토리지에 기록되지 않습니다. 백엔드로 전송될 뿐 클라이언트에서는 메모리에만 존재합니다.

​

다음 단계