처음 시작하기
위젯은 대화에 붙이는 작은 정보 카드예요. 장소·관계·일정 등을 보기 좋게 보여 줍니다. 디자인은 제작 화면에서 정하고, 내용은 실제 대화를 바탕으로 AI가 채웁니다.
제작 → 위젯 제작 → 예시 템플릿 → 내 위젯에 담기에서 모양을 고르세요.
내 위젯 → 수정 → 위젯 설정에서 이름·설명·표시할 정보를 바꾸고 위젯 저장을 누르세요.
대화방 → 입력창의 설정 → 위젯 → 개인 위젯의 추가 → 적용을 누르세요. 다음 답변에 필요한 정보가 채워지면 위젯이 표시됩니다.
위젯 버튼으로 메시지 보내기
위젯 안에 만든 버튼으로 현재 대화방에 내 메시지를 보내는 선택 기능입니다. 채팅방 전체 디자인이나 일반 추천답변을 바꾸는 기능은 아닙니다.
예를 들어 휴대폰 모양 위젯에 ‘안부 묻기’ 버튼을 만들면, 버튼을 눌러 ‘오늘 하루 어땠어?’를 내 채팅 메시지로 보낼 수 있습니다. 모든 위젯에 자동으로 전송 버튼이 생기지는 않습니다. 제작자가 해당 버튼에 메시지 전송 동작을 연결한 경우에 사용합니다.
| 사용하는 곳 | 버튼을 누르면 |
|---|---|
| 제작 중 미리보기 | 전송할 문장만 확인합니다. 실제 채팅·AI 호출은 없습니다. |
| 실제 대화방에 적용한 위젯 | 확인창에서 이 문장 보내기를 누르면 현재 방으로 전송합니다. 취소하면 전송하지 않습니다. |
| 검증 전용 화면 | 실제 전송 대신 전송 결과에 표시해 흐름을 시험합니다. |
실제 방에서는 일반 메시지처럼 AI가 답하므로 서비스 이용량이 발생할 수 있습니다. 답변이나 도입부 재생 중에는 보낼 수 없으며, 작성 중이던 메시지는 유지됩니다.
선택지 버튼 예시 코드
아래 도서관으로 갈까요? 등은 기능 확인을 위해 미리 넣은 고정 예시 문구입니다. AI 추천답변이 아닙니다.
새 위젯 만들기 → 코드 편집에 전체 붙여 넣으면 저장하지 않아도 미리보기에서 버튼을 시험할 수 있어요. 모바일은 미리보기 탭을 누르세요.
function ChoiceCard({ items = ["도서관으로 갈까요?", "잠깐 쉬어 갈까요?"], profile = {name:"카이사르", place:"서재"} }) {
return <section style={{padding:20, borderRadius:16, background:"var(--widget-bg)", color:"var(--widget-text)", border:"1px solid var(--widget-border)"}}>
<small>다음 이야기를 골라 주세요</small>
<h3>{profile.name} · {profile.place}</h3>
<div style={{display:"grid", gap:10}}>
{items.map((text,i) => <button key={i} style={{padding:14, borderRadius:10, border:"1px solid var(--widget-border)", background:"var(--widget-bg)", color:"var(--widget-text)", textAlign:"left", cursor:"pointer"}} onClick={() => sendToChat(text)}>{text}</button>)}
</div>
</section>;
}이 예시를 실제 대화의 데이터와 연결하려면 위젯 설정 → 표시할 정보 → 항목 추가에서 아래 두 항목도 등록하세요.
| 코드에서 쓸 이름 | 타입 | 예시 값 | AI 전달 설명 |
|---|---|---|---|
| items | 목록 (배열) | ["도서관으로 갈까요?","잠깐 쉬어 갈까요?"] | 이번 답변에 자연스럽게 이어지는 사용자의 짧은 선택지 두 개. 공개된 대화 내용만 사용한다. |
| profile | 묶음 정보 (객체) | {"name":"카이사르","place":"서재"} | name은 현재 인물 이름, place는 실제 대화에서 확인된 현재 장소. |
위젯 설명에는 ‘현재 인물·장소와 대화를 이어갈 선택지 두 개를 보여 준다’처럼 적어 주세요. 예시 값은 제작 미리보기용입니다. 실제 방에서는 AI가 채운 내용이 사용됩니다. 이미 시작한 방에는 설정에서 위젯을 추가한 뒤 다음 답변부터 확인하세요.
직접 확인하는 순서
제작 미리보기: 위 예시의 버튼을 누르면 ‘전송 문장 미리보기’가 열리는지 확인하세요. 이곳에서는 실제 전송하지 않습니다.
실제 대화방: 위젯을 적용하고 출력된 버튼을 누르세요. 확인창에서 취소하면 전송되지 않고, 이 문장 보내기를 누르면 내 메시지로 등록됩니다.
답변 중 전송 방지: 답변이 진행 중이면 전송 버튼이 비활성화되는지 확인하세요.
표시할 정보는 무엇인가요?
카드 안에 들어갈 내용의 이름과 작성 기준입니다. 개발 용어로는 Props라고 합니다.
| 항목 | 작성 예 |
|---|---|
| 표시 이름 | 현재 장소 |
| 예시 값 | 왕립 도서관 — 모양을 확인하는 임시 내용 |
| AI 전달 설명 | 이번 대화에서 확인된 현재 장소를 입력한다. |
문자열은 글, 숫자는 수치, 참/거짓은 켜짐·꺼짐 같은 값입니다. 목록은 여러 항목을, 묶음 정보는 이름·장소처럼 관련된 값을 함께 전달할 때 사용합니다. 목록은 [ ], 묶음 정보는 { }로 입력합니다. 각 값은 JSON 기준 500자, 깊이 4단계 이내입니다. 잘못된 형식은 오류로 안내하고 저장을 막습니다. 실제 대화에서 잘못 반환된 값은 이전 정상 값을 유지합니다.
AI에게 제작 부탁하기
새 위젯 만들기 → AI 제작에서 원하는 분위기와 넣을 정보를 적어 주세요. 결과를 확인하고 이 디자인 적용 → 위젯 저장을 누르면 됩니다.
밤에 도착한 휴대폰 메시지처럼 만들어 줘. 보낸 사람·시각·메시지를 보여 주고, ‘안부 묻기’ 버튼을 누르면 ‘오늘 하루 어땠어?’를 채팅으로 보내도록 해 줘. 밝은 모드와 어두운 모드 모두 읽기 편하게 해 줘.
AI 제작은 화면에 안내된 이용 횟수를 사용합니다. 단순 미리보기·버튼 시험·코드 검사는 AI를 호출하지 않습니다.
작품과 대화방에 적용하기
내가 쓸 위젯: 대화방 설정 → 위젯 → 개인 위젯의 추가에서 적용합니다. 해당 방에만 저장됩니다.
내 작품에 기본으로 넣기: 작품 제작의 스토리 설정 → 작품 위젯에 등록하고 작품을 공개·반영합니다. 이후 새 대화에 적용됩니다.
끄기: 대화방 설정에서 개별 OFF로 끌 수 있어요. 끈 위젯은 다음 응답의 데이터 생성에서도 제외됩니다.
공유: 공유 설정에서 허브에 공개하면 닉네임·디자인·설명·표시 정보가 공개됩니다. 비밀 설정이나 개인 정보는 넣지 마세요.
대화방에 넣은 위젯은 별도 사본입니다. 원본을 고쳐도 기존 방의 사본은 자동으로 바뀌지 않으므로, 새 버전을 해당 방에 다시 적용하세요.
저장·수정·나가기
위젯 저장을 눌러야 목록에 등록됩니다. 새 화면만 열면 빈 위젯이 남지 않습니다.
좌측 상단 뒤로 버튼은 저장하지 않은 내용이 있을 때 나갈지 확인합니다.
코드 검사는 문법·금지 항목 검사입니다. 통과 후에도 미리보기에서 실제 버튼 동작을 확인하세요.
Ctrl+Z로 되돌리고 Ctrl+Y 또는 Ctrl+Shift+Z로 다시 실행합니다. Tab은 들여쓰기, Shift+Tab은 내어쓰기입니다.
코드 검사와 오류 안내 시험하기
이 예시는 일부러 오류를 냅니다. 새 위젯의 코드 편집에 넣고 미리보기의 오류 위치 확인을 누르면 원본 4행과 코드 조각이 보여야 합니다.
function ErrorCheck() {
return <section style={{padding:20}}>
<button onClick={() => {
throw new Error("줄 번호 표시를 확인하는 테스트 오류입니다.");
}}>오류 위치 확인</button>
</section>;
}오류가 나면 표시된 줄과 입력값을 확인하세요. 오류 문구를 AI 제작에 전달해 수정을 요청할 수도 있습니다. 코드를 고치면 이전 오류가 남지 않고 새 결과로 바뀝니다.
글꼴·다크 모드 예시 코드
아래 코드를 넣고 코드 검사를 누르세요. 제목이 손글씨로 보이고 외부 글꼴 로드 완료 · Gaegu가 표시되면 실제 글꼴 파일까지 불러온 것입니다. 클릭 확인을 누르면 숫자가 증가합니다.
환경 설정에서 어두운 모드로 바꿔도 배경과 글자가 읽혀야 합니다. Google Fonts를 네트워크에서 차단한 환경에서는 기본 글꼴로 표시됩니다.
function FontCheck() {
const [count, setCount] = useState(0);
return <section className="font-check">
<style>{`@import url('https://fonts.googleapis.com/css2?family=Gaegu:wght@400;700&display=swap');
.font-check { padding:24px; border:1px solid var(--widget-border); border-radius:18px;
background:var(--widget-bg); color:var(--widget-text); }
.font-check h3 { font-family:'Gaegu',cursive; font-size:32px; margin:0 0 12px; }
.font-check button { padding:10px 16px; border-radius:10px; cursor:pointer; }
`}</style>
<h3>오늘도 반가워요, 북극여우!</h3>
<p>이 문장은 기본 글꼴입니다. 제목은 Gaegu 손글씨입니다.</p>
<button onClick={() => setCount(count + 1)}>클릭 확인 · {count}</button>
</section>;
}지원 기능과 제한
| 항목 | 지원 범위 |
|---|---|
| 코드·데이터 | 코드 200,000자 / 표시 정보 30개 / 설명 300자 / 항목 설명 160자 / 값 500자 |
| 문법·동작 | 함수 하나의 JSX, React Hooks, 클릭 이벤트, 함수 내 조건문·보조 함수, 전개, Math·Date·문자열·배열 메서드. 반복 실행과 화면 갱신은 횟수 제한. |
| 화면·스타일 | div·section·button·details·table·svg 등 표시 태그, className·aria-*·role, 인라인 style·style 블록·position·hover·@media·애니메이션 |
| 글꼴 | Google Fonts의 fonts.googleapis.com 스타일과 fonts.gstatic.com 글꼴만 허용 |
| 사용 불가 | import·export·eval·fetch·저장소·DOM 및 부모 화면 접근·HTML 직접 삽입. script·iframe·object·embed·link·meta·base·form·input·textarea·select·foreignObject·image·video·audio·source·a 태그와 외부 미디어·링크 속성 |
함수 이름과 컴포넌트 이름은 같아야 하며 영문 대문자로 시작합니다. 테마에 맞게 바뀌는 색상은 --widget-bg(배경), --widget-text(글자), --widget-muted(보조 글자), --widget-border(테두리)를 사용하세요. 고정한 색상은 자동으로 바뀌지 않습니다.
잘 안 될 때 확인할 것
카드가 안 보여요: 내 위젯과 대화방 설정이 ON인지, 해당 방에 적용했는지 확인하세요. 아직 확인된 대화 정보가 없으면 표시되지 않을 수 있습니다.
버튼이 없어요: 해당 위젯에 전송 버튼을 만들었는지 확인하세요. 모든 위젯에 자동으로 생기는 버튼은 아닙니다.
예시 값이 실제 방에 안 보여요: 예시 값은 제작 미리보기용입니다. 실제 대화의 확인된 값과 구분됩니다.
저장했는데 기존 방은 그대로예요: 기존 방은 별도 사본입니다. 새 버전을 다시 적용하세요.
AI 이용 분량
디자인 코드 전체를 일반 대화 AI에 보내지 않습니다. 켜진 위젯의 설명·항목·자료 구조만 전달하고 실제 표시할 데이터를 받습니다. 항목이나 값이 많으면 AI 처리 분량은 늘 수 있습니다. AI 제작을 요청할 때에는 현재 코드와 요청 문장을 별도 생성 요청으로 전달합니다.