챗봇 설정하기

빠른 설정

대부분의 호텔은 약 7분 안에 메시지, 봇 지시문, 고급 설정을 완료합니다.

이 가이드는 투숙객이 일관된 답변을 받을 수 있도록 챗봇의 메시지, 어조, 답변 엔진, 고급 응답 설정, 접근 권한을 구성하는 방법을 안내합니다. 투숙객 답변을 더 일관되게 만들고 싶을 때 사용하세요.

이동: Chatbot → Setup

---

빠른 참조

작업	클릭 위치	결과
환영 메시지 설정	Bot Configuration → Welcome Message	투숙객이 가장 먼저 인사말을 봅니다
기본 응답 설정	Bot Configuration → Default Answer	일치하는 답변이 없을 때 응답이 제공됩니다
봇 어조 정의	Bot Configuration → Bot Instruction	챗봇이 안내를 따릅니다
답변 엔진 선택	Advanced Settings → Answer Engine	RAG와 Agent (Pi) 사이를 전환합니다
응답 스타일 조정	Advanced Settings	temperature, token cap, retrieval depth, grounding mode를 제어합니다
Skill Mode 활성화	Advanced Settings → Skill Mode	구성한 Vertex ADK skill을 사용해 GenAI 응답을 스트리밍합니다
Quick Setup 실행	Quick Setup	메시지와 어조를 미리 채웁니다
채팅 모드 선택	Widget & Access → Chat mode	AI, live chat, hybrid 중 선택합니다
랜딩 페이지 생성	Widget & Access → Create Landing Page	게스트 링크와 QR 옵션이 표시됩니다
위젯 도메인 허용	Widget & Access → Whitelisted Domains	위젯이 웹사이트에서 로드됩니다

플랜 접근

• 챗봇 설정에는 유료 플랜이 필요합니다.
• 무료 플랜 계정에는 업그레이드 안내가 표시되며 변경 사항을 저장할 수 없습니다.

업그레이드하려면 Settings → Billing & Subscription으로 이동하세요.

시작하기 전에

다음 요건을 확인하세요:

• Chatbot 설정을 관리할 권한이 있습니다
• 현재 플랜에 Chatbot 기능이 포함되어 있습니다
• 봇이 사용할 어조를 알고 있습니다

봇 메시지 구성

1. Chatbot → Setup로 이동합니다.

2. Bot Configuration 탭에 머뭅니다.

3. Welcome Message를 짧은 인사말로 업데이트합니다.

4. Default Answer를 도움이 되는 기본 응답으로 업데이트합니다.

5. 각 카드 아래의 Save를 클릭합니다.

   ✓ 성공 메시지가 표시됩니다.

봇 지시문 설정

1. Bot Instruction에 어조와 규칙을 설명합니다.

2. Save를 클릭합니다.

   ✓ 지시문이 저장되고 챗봇에 사용됩니다.

좋은 지시문 예시

“간결하고 친절하게 답변하세요. 확신이 없으면 후속 질문을 하세요.”

고급 응답 설정

1. 페이지 헤더에서 Advanced Settings를 클릭합니다.

2. Answer Engine에서 RAG 또는 **Agent (Pi)**를 선택합니다.

3. 응답 동작을 확인하려면 Generation 섹션을 검토합니다.

4. RAG를 선택한 경우 Retrieval 섹션도 확인합니다.

5. Retrieval에서 Disable grounding RAG engine을 켜거나 끕니다.

6. 다음 범위 안에서 값을 설정합니다.

   • Temperature: 0부터 1
   • Top P: 0부터 1
   • Max Output Tokens: 500부터 3024
   • Retrieval K: 1부터 7

7. Disable grounding RAG engine를 켜면 Retrieval K를 1에서 3 사이로 유지합니다.

8. Save를 클릭합니다.

   ✓ 저장이 성공하면 모달이 닫힙니다.

이 설정이 제어하는 항목

값이 낮을수록 답변이 더 집중됩니다. 값이 높을수록 다양성이 커집니다. RAG는 챗봇 문서와 검색 설정을 사용합니다. **Agent (Pi)**를 선택하면 모달에서 RAG 전용 제어 항목이 숨겨집니다. Disable grounding RAG engine를 켜면 답변 전에 컨텍스트를 직접 미리 가져옵니다. 토큰을 더 사용하지만 검색 신뢰성은 높아집니다. 이 설정은 챗봇 답변과 연결된 음성 흐름에도 영향을 줍니다.

Skill Mode 사용

GenAI 설정을 Vertex ADK를 통해 스트리밍하려면 Skill Mode를 사용하세요.

1. Advanced Settings를 클릭합니다.

2. Use Skill Mode를 켭니다.

3. booking-assistant 같은 Skill Name을 입력합니다.

4. Save를 클릭합니다.

   ✓ Advanced Settings를 다시 열어도 설정이 유지됩니다. ✓ 모달에 입력한 skill 이름이 그대로 남아 있습니다.

Skill 이름 규칙

Skill Name에는 소문자, 숫자, 하이픈만 사용할 수 있습니다. Use Skill Mode가 켜져 있으면 이 필드는 필수입니다. Vertex ADK가 뒤에서 skill을 실행합니다.

Quick Setup 사용(선택 사항)

1. 페이지 헤더에서 Quick Setup을 클릭합니다.
2. 마법사를 따라 메시지와 어조를 생성합니다.
3. 필드에 채워진 결과를 검토합니다.
4. 유지할 섹션마다 Save를 클릭합니다.

채팅 모드 선택

1. Widget & Access 탭을 엽니다.

2. 다음 모드 중 하나를 선택합니다.

   • AI only
   • Live chat only
   • Hybrid (AI + live chat)

   ✓ 선택한 모드가 강조되고 적용됩니다.

랜딩 페이지 링크 만들기

1. Widget & Access에서 Landing Pages를 찾습니다.

2. Create Landing Page를 클릭합니다.

   ✓ 투숙객 접근용 새 링크가 표시됩니다.

3. View QR로 투숙객 코드를 미리 봅니다.

4. 객실이나 안내 구역에 인쇄할 표지가 필요하면 Download chatbot QR를 클릭합니다.

허용 도메인 관리

1. Whitelisted Domains에 yourhotel.com 같은 도메인을 입력합니다.
2. Add Domain을 클릭합니다.
3. 토글로 도메인을 활성화하거나 비활성화합니다.
4. 위젯을 더 이상 동작시키지 않아야 할 때만 도메인을 제거합니다.

문제 해결

Save 버튼이 비활성화됨

증상: 메시지나 지시문을 저장할 수 없습니다.

해결 방법:

1. 필드가 비어 있지 않은지 확인합니다.
2. 불필요한 공백을 제거한 뒤 다시 시도합니다.
3. 플랜에 Chatbot 기능이 포함되어 있는지 확인합니다.

고급 설정이 저장되지 않음

증상: Save 버튼이 계속 비활성화되거나 유효성 검사 오류가 표시됩니다.

해결 방법:

1. 현재 고급 값이 로드될 때까지 기다립니다.
2. 빨간색 유효성 검사 메시지를 모두 확인합니다.
3. Max Output Tokens를 500과 3024 사이로 유지합니다.
4. Retrieval K를 1과 7 사이로 유지합니다.
5. Disable grounding RAG engine가 켜져 있으면 Retrieval K를 1과 3 사이로 유지합니다.
6. 다시 Save를 시도합니다.

RAG 제어 항목이 보이지 않음

증상: Retrieval K 또는 Disable grounding RAG engine을 찾을 수 없습니다.

해결 방법:

1. Advanced Settings를 엽니다.

2. 현재 Answer Engine을 확인합니다.

3. RAG를 선택합니다.

4. Save를 클릭합니다.

   ✓ RAG 전용 제어 항목이 다시 표시됩니다.

Retrieval K 범위가 너무 좁아 보임

증상: Retrieval K가 1에서 3까지만 허용됩니다.

해결 방법:

1. Disable grounding RAG engine를 끕니다.
2. Retrieval K를 다시 확인합니다.
3. 업데이트된 설정을 저장합니다.

Skill Mode가 저장되지 않음

증상: Use Skill Mode를 켠 뒤 저장이 실패합니다.

해결 방법:

1. Skill Name이 비어 있지 않은지 확인합니다.
2. 소문자, 숫자, 하이픈만 사용합니다.
3. booking-assistant 같은 이름을 사용해 봅니다.
4. 다시 Save를 클릭합니다.

랜딩 페이지가 생성되지 않음

증상: 랜딩 페이지 생성 시 오류가 발생합니다.

해결 방법:

1. 페이지를 새로고침한 뒤 다시 시도합니다.
2. 기존 페이지를 교체하라는 안내가 나오면 그대로 따릅니다.
3. 그래도 실패하면 지원팀에 문의합니다.

도메인 토글이 동작하지 않음

증상: 스위치가 바뀌지만 다시 원래대로 돌아갑니다.

해결 방법:

1. 페이지를 새로고침합니다.
2. 도메인을 삭제한 뒤 다시 추가합니다.
3. 토글을 다시 시도합니다.

계속 해결되지 않나요?

다음 경우 success@vouch-technologies.com으로 문의하세요:

• ❌ 여러 번 시도해도 저장이 실패함
• ❌ 랜딩 페이지가 생성되지 않음
• ❌ 문제가 30분 이상 지속됨

함께 보내면 좋은 정보:

• Chatbot Setup 페이지 스크린샷
• 시도한 작업과 오류 메시지
• 문제가 시작된 시각

관련 가이드

• Style the Chatbot Widget
• Create a Live Chat Link for Guests
• Manage Chatbot Documents