🧍 ➜ 🎭 ➜ 🧠 ➜ 💬
내가 만든 3D 캐릭터(아바타)가 화면에서 말을 하고, 내가 가르친 지식으로 질문에 답해 주는 나만의 AI 친구예요.
🧑🏫 비유하자면… 빈 인형에게 얼굴(아바타)·성격(말투)·지식(공부한 내용)을 하나씩 넣어 주는 거예요.
다 넣으면 인형이 살아나 사람들과 대화합니다.
💚 코드는 안 만져요. 인터넷 사이트(GitHub·Vercel)에서 버튼을 누르고, 글자만 입력하면 됩니다.
∞
전체 흐름 한눈에 보기위에서 아래로 6걸음
🧰
1. 준비
Git 설치 + GitHub·Vercel·카카오 가입
▼
📦
2. 내 봇 복제
템플릿을 내 GitHub 저장소로 복사
▼
🚀
3. 인터넷에 올리기
Vercel 배포 → 내 봇 주소 생성 (닉네임 설정)
▼
▼
🎨
5. 아바타 입히기
VRoid로 내 캐릭터 만들어 올리기
▼
🧠
6. 지식·성격 넣기 ⭐
/rag 페이지에서 페르소나 + 지식 등록
🌱 지금 다 외울 필요 없어요. 한 걸음씩 따라오면 됩니다. 소요 시간 약 1시간 (아바타 제외).
🧰 🐙 ▲ 💛
- Git 설치 — 코드를 옮기는 택배 기사 (다운로드)
- GitHub 가입 — 내 코드를 보관하는 창고 (github.com)
- Vercel 가입 — 내 봇을 인터넷에 띄워 주는 무대 (vercel.com)
- 카카오 디벨로퍼스 가입 — 로그인·공유 연결 (developers.kakao.com)
🧑🏫 비유하자면… GitHub은 창고, Vercel은 무대, Git은 창고와 무대 사이를 오가는 택배 기사예요.
🧩 ➜ 📥 ➜ 📤
준비된 봇 템플릿을 그대로 복사해서 내 GitHub 창고에 올립니다.
- GitHub에서 빈 저장소 만들기 (이름:
my-bot, Public, 체크박스 모두 OFF)
- 내 컴퓨터에서 아래를 차례로 (까만 창에 한 줄씩):
git clone https://github.com/sdkparkforbi/my-vrm-bot.git .
rmdir /s /q .git
git init -b main
git add . && git commit -m "내 봇 시작"
git remote add origin https://github.com/[내아이디]/my-bot.git
git push -u origin main
⚠️ 마지막 git remote add 의 주소는 1번에서 만든 내 저장소 주소예요 (템플릿 주소 아님).
🚀
인터넷에 올리기Vercel 배포 + 내 닉네임
📦 ➜ ▲ ➜ 🌐
Vercel → New Project → 내 저장소 선택 → 환경 변수 입력 후 Deploy.
- 닉네임(BOT_ID) 정하기 — 영문 소문자·숫자·하이픈, 예:
bungae
- 환경 변수에 같은 값 2개:
BOT_ID 와 VITE_BOT_ID
- 카카오 키
VITE_KAKAO_JS_KEY (Step 6에서 발급, 지금은 임시값 OK)
- Deploy → 1~3분 후
https://my-bot.vercel.app 같은 내 봇 주소 완성! 🎉
🧑🏫 닉네임이 곧 내 봇의 이름표예요. 이 이름으로 봇이 내 지식·성격을 찾아옵니다. 친구 봇과 절대 안 섞여요.
💛 ➜ 🔑 ➜ 📲
- Kakao Developers → 앱 만들기 → JavaScript 키 복사
- 플랫폼 → Web 에 내 Vercel 주소 등록
- 카카오 로그인 ON + Redirect URI 설정
- Vercel 환경변수
VITE_KAKAO_JS_KEY 를 진짜 키로 교체 → Redeploy
💚 키는 코드에 적지 않고 환경변수로 넣어요. 그래서 안전합니다.
🧍 ➜ 🎨 ➜ 🧑🚀
봇의 얼굴이 되는 3D 캐릭터예요. 두 가지 길이 있어요.
받은 .vrm 파일을 public/avatar.vrm 로 저장하고 push 하면 끝!
💚 안 만들어도 돼요 — 기본 아바타가 이미 들어 있어요. 나중에 바꾸면 됩니다.
🧠
지식·성격 넣기 ⭐이게 봇을 똑똑하게 만드는 핵심
📚 ➜ 🤖 ➜ 💡
내 봇 사이트의 /rag 페이지(또는 화면 오른쪽 위 🧠 아이콘)에서 직접 관리해요. 로그인 후 내 닉네임으로 저장됩니다.
🎭
페르소나 (성격·말투)
"너는 친근한 반말로 설명하는 ○○ 봇이야" 처럼 자유 서술 → 저장
▼
✨
지식 (자동 청크)
텍스트(노트·기사·위키)를 붙여넣고 "청크 생성" → AI가 Q&A로 정리 → 저장
▼
📚
목록 확인
등록된 지식이 쌓이는 걸 보고, 필요 없으면 삭제
🧑🏫 비유하자면… 페르소나는 봇의 성격, 지식은 봇이 공부한 교과서예요. 둘 다 넣어야 똑똑하고 나다운 봇이 됩니다.
💚 텍스트는 한 번에 500~5,000자가 적당해요. 붙여넣고 30초~1분 기다리면 자동으로 정리됩니다.
📋
설문 만들기 방문자에게 의견 받기 · v2 신규
📝 ➜ 🤖 ➜ ✅
내 봇의 /survey 페이지에서 설문을 직접 설계해요. 질문을 추가하고 타입(예/아니오·객관식·척도·주관식)만 고르면 끝.
➕
질문 추가
＋ 버튼 → 질문 입력 → 타입 선택 (객관식이면 선택지도 입력)
▼
⚡
또는 LLM으로 한 번에
ChatGPT/Claude에 "설문 JSON 만들어줘" → 📥 JSON 가져오기에 붙여넣기
▼
💾
저장
대화를 마친 방문자에게 설문 창이 자동으로 떠요
💚 객관식 옵션은 질문을 추가한 뒤 그 질문의 드롭다운에서 골라요.
📊
결과 대시보드 응답을 차트로 · v2 신규
📊 ➜ 📈 ➜ 🧑💼
설문 응답이 쌓이면 차트로 한눈에 봐요. 두 가지가 있어요:
🌐
공개 대시보드 /dashboard
비밀번호·로그인 없이 누구나 — 문항별 막대 차트
▼
🧑💼
관리자 대시보드 /admin
로그인하면 내 봇의 총 응답·평균 시간·일별 추이까지 (관리자 실습)
🧑💼 관리자가 되어보기 — 내 봇을 운영하며 사람들의 반응을 데이터로 확인하는 연습이에요.
💚 응답이 없으면 비어 보여요. 친구들에게 봇을 써보게 하고 설문을 받아보세요!
✅ ➜ 📱 ➜ 🥳
- 내 봇 주소를 카카오톡·QR코드로 친구에게 공유
- 친구 피드백 받기 →
/rag 에서 지식·성격 다듬기
- 반복할수록 봇이 점점 똑똑하고 나다워져요 💛