사용·설정 매뉴얼

아바타와 첫 대화 시작하기

1. 서비스 주소를 엽니다.

   휴대폰에서는 https://로 시작하는 배포 주소를 사용하세요. 처음에는 아바타 대기 화면과 대화 기록 영역이 보입니다.

2. 대화 시작을 누르고 마이크를 허용합니다.

   브라우저의 권한 요청에서 허용을 선택하세요. 일반 음성 대화에는 카메라 권한이 필요하지 않습니다. 카메라 기능을 사용할 때만 별도로 허용합니다. 연결 중에는 버튼을 반복해서 누르지 않고 화면 안내를 기다립니다.

3. 아바타가 연결되면 음성으로 질문합니다.

   예: “주요 기능을 알려 주세요.” 인식된 질문과 답변은 대화 기록에 표시됩니다. 현재 화면에는 텍스트 질문 입력창이 없습니다.

4. 사용을 마치면 대화 종료를 누릅니다.

   다시 시작하면 새 대화를 시작합니다. 이전 대화 기록을 이어 가는 기능은 제공하지 않습니다.

대화 화면의 버튼

메뉴를 열고, 수정하고, 저장하기

화면 아래 가로줄 다음에 설정이 있습니다. 각 메뉴 앞의 + 또는 메뉴 이름을 누르면 펼쳐집니다. 다시 누르면 접힙니다.

설정 목록 맨 아래의 ＋ 매뉴얼 ↗은 바로가기입니다. 누르면 이 매뉴얼을 새 탭에서 바로 열며, 기존 대화 화면은 유지됩니다. 매뉴얼 본문은 한국어입니다.

“저장하고 적용”의 의미

설정값을 바꾸면 해당 메뉴의 저장하고 적용 버튼이 활성화됩니다. 누르면 현재 브라우저에 저장하고 대화 화면에 적용합니다. 저장이 끝나거나 변경사항이 없으면 버튼이 비활성화됩니다. 메뉴를 접는 것만으로 저장되지는 않습니다.

카드 편집 화면은 수정 즉시 미리보기가 바뀝니다. 미리보기에 보이는 초안과 실제 대화에 적용된 설정은 다릅니다. 마지막으로 저장하고 적용해야 실제 대화와 새 공개 링크에 반영됩니다.

설정은 브라우저와 접속 도메인별로 보관됩니다. 다른 기기로 자동 동기화되지 않으며 사이트 데이터를 지우면 사라질 수 있습니다. 카드 설정은 JSON 파일로 보관할 수 있습니다. 저장 공간을 사용할 수 없으면 화면에 임시 적용 안내가 표시됩니다.

전체 화면·채팅창·카메라 영상·테마

전체 화면으로 시작하기

1. 화면 설정 → 전체 화면으로 시작을 켭니다.

   끄면 기존 기본 화면으로 시작합니다. 채팅창 표시 여부는 별도로 선택하되, 모바일 전체 화면에서는 항상 숨깁니다.

2. 저장하고 적용을 누릅니다.

   바로 전체 화면으로 전환하며, 다음 접속에도 이 브라우저의 저장값을 사용합니다.

3. 영상 오른쪽 위 아이콘을 눌러 기본 화면으로 돌아옵니다.

   PC에서는 Esc로도 돌아올 수 있습니다. 마이크·대화 종료는 영상 위에 남고, 채팅 보기는 PC 전체 화면에서만 사용할 수 있습니다. 기존 영상·음성·대화 기록은 유지됩니다.

전체 화면에서만 마이크와 푸시투토크가 아바타 영상 위 하단 중앙에 겹쳐 표시됩니다. 별도의 하단 칸이나 버튼 테두리·배경 박스 없이, 보이지 않는 터치 영역만 64px 높이로 넓힙니다. 푸시투토크는 설정에서 켰을 때만 마이크 오른쪽에 나타납니다. 누르고 말한 뒤 손을 떼세요. 손가락이 아이콘 밖으로 이동해도 손을 떼거나 터치가 취소되면 마이크가 닫힙니다. 전체 화면을 전환할 때도 누르기 상태가 해제됩니다.

추천 질문과 축소 아바타는 조작 버튼 위쪽에 배치됩니다. 모바일의 긴 카드는 위쪽 전환 버튼과 아래쪽 통화 조작 영역 사이에서 스크롤할 수 있습니다.

PC 전체 화면의 하단 왼쪽에는 채팅 아이콘, 오른쪽에는 대화 종료가 있습니다. 모바일 전체 화면에서는 채팅 아이콘을 숨기고, 좁은 화면에서는 종료를 통화 종료 아이콘으로 표시합니다. 기본 화면으로 돌아오면 버튼은 원래 크기로 복원됩니다.

영상의 전환 버튼은 현재 보기만 바꿉니다. 저장한 기본 모드나 기존 공개 링크는 바뀌지 않습니다. 기본값을 바꾸려면 기본 화면으로 돌아와 화면 설정에서 저장하세요.

처음 열 때는 브라우저 안을 가득 채우며 주소창이 남을 수 있습니다. 직접 전체 화면 버튼을 누르면 지원하는 브라우저에서 주소창까지 숨깁니다. 브라우저가 허용하지 않아도 앱 안에서 화면을 넓히는 동작은 유지됩니다. 브라우저 전체 화면의 사용자 조작 조건

아바타 위에 카메라 영상 표시하기

1. 화면 설정 → 카메라 영상 보기를 켭니다.

   가로·세로를 각각 3칸으로 나눈 위치 중 가운데를 제외한 8곳을 선택합니다. 기본 위치는 오른쪽 아래입니다.

2. 저장하고 적용을 누르고 카메라 권한을 허용합니다.

   아바타 상황 인식 설정의 카메라 사용 허용도 자동으로 켜집니다. 이미 연결한 카메라가 있으면 그대로 사용하고, 없으면 선택한 기기에 연결을 요청합니다. 권한 거부·기기 오류로 실제 카메라가 연결되지 않으면 영상 보기를 켜지 않습니다. 자동 상황 인식 스위치와 작성 중인 다른 설정은 그대로 유지합니다.

카메라 영상은 원본 비율을 유지하며 아바타 화면 위 선택한 위치에 표시됩니다. 기본 화면·전체 화면·모바일에서도 같은 위치를 기준으로 크기를 맞춥니다. 영상 왼쪽 위 카메라 아이콘과 전체 화면의 하단 통화 조작 영역은 비워 둡니다.

하단 추천 질문 인덱스와 겹치면 카메라 영상을 인덱스 위로 올립니다. 왼쪽 아래·가운데 아래·오른쪽 아래 모두 가로 위치와 영상 크기를 유지하며 인덱스 위에 간격을 두고 표시합니다. 인덱스가 없거나 숨겨지면 원래 선택한 위치로 돌아갑니다. 인덱스의 높이가 바뀌거나 화면을 확대·축소할 때도 다시 맞춥니다.

카메라 영상 표시 여부·위치와 카메라 사용 허용·자동 상황 인식 설정은 이 브라우저에 저장되며 새로 만드는 공유 링크에도 그대로 포함됩니다. 공유 화면에서도 하단 인덱스를 피해 같은 위치에 표시합니다. 공유 방문자는 자신의 기기에서 카메라 권한을 허용하고 연결해야 합니다. 기존 공유 링크의 설정은 바뀌지 않습니다.

카메라 영상 보기와 채팅창 표시는 독립적인 설정입니다. 기본 화면에서는 채팅창이 영상 밖의 별도 영역(PC 오른쪽, 좁은 화면 아래)에 표시됩니다. 전체 화면에서 둘 다 볼 수 있는 경우는 데스크톱 웹입니다. 채팅 위치를 자동 배치로 설정하면 카메라가 오른쪽일 때 채팅창은 왼쪽, 카메라가 왼쪽이면 채팅창은 오른쪽을 우선합니다. 카메라가 가운데이면 빈 공간을 선택하며, 카드·축소 아바타·인덱스와도 겹치지 않게 이동합니다. 모바일 전체 화면에서는 채팅창과 채팅 보기 버튼을 숨기며, 기본 화면으로 돌아오면 원래 채팅 표시 상태로 복원합니다.

카드·축소 아바타·추천 질문·제목·처리 상태 안내도 서로 겹치지 않게 배치합니다. 카드 위치와 조작 버튼을 우선하고, 공간이 부족한 나머지 요소는 잠시 숨겼다가 공간이 생기면 복원합니다. 화면 크기·채팅 보기·카드 표시가 바뀔 때마다 다시 계산하며 저장한 설정이나 대화 연결은 바꾸지 않습니다.

촬영한 사진은 예외입니다. 사진을 다른 콘텐츠보다 위에 표시하므로 사진과 다른 오버레이가 겹치는 것은 허용합니다. 사진을 닫으면 아래 콘텐츠를 다시 볼 수 있고 카메라·전체 화면·통화 조작 버튼도 유지됩니다.

데스크톱 전체 화면의 채팅창 위치 설정

1. 화면 설정 → 채팅창 표시를 켭니다.

   채팅창 표시가 꺼져 있으면 위치 선택도 비활성화됩니다.

2. 전체 화면 채팅창 위치에서 자동 배치 또는 8방향을 선택합니다.

   자동 배치가 기본값입니다. 카메라가 오른쪽이면 왼쪽 채팅, 왼쪽이면 오른쪽 채팅을 우선합니다. 직접 선택할 때는 카메라 위치처럼 가운데를 제외한 가로·세로 3칸의 8곳에서 고릅니다.

3. 저장하고 적용을 누릅니다.

   선택한 위치는 데스크톱 웹의 전체 화면에만 적용됩니다. 기본 화면에서는 채팅창이 영상 밖에 있고, 모바일 전체 화면에서는 기존처럼 채팅창과 채팅 보기 버튼을 숨깁니다. 기본 화면에서 미리 저장한 위치는 나중에 전체 화면으로 전환할 때 사용합니다.

직접 고른 위치에도 겹침 방지가 우선합니다. 카메라·인덱스·제목·조작 버튼 등과 겹치면 가장 가까운 안전한 공간으로 옮기고, 빈 공간이 없으면 잠시 숨깁니다. 카드가 하나라도 표시되면 위치와 관계없이 전체 화면 채팅창과 카메라 영상을 숨기며, 마지막 카드가 사라지면 복원합니다. 임시 이동·숨김으로 저장한 위치는 바뀌지 않습니다.

채팅 위치는 브라우저에 저장되고 새 공개 URL에도 포함됩니다. 공유 방문자에게도 동일한 위치와 겹침 방지 정책을 적용합니다. 위치 정보가 없는 이전 저장값·기존 공유 링크는 자동 배치로 열립니다.

상황별 오버레이 표시·숨김·복원 규칙

카메라에 관한 규칙은 카메라 영상 보기를 켜고 기기를 연결한 경우에 적용됩니다. 채팅 위치 설정은 카메라 표시 여부와 독립적으로 데스크톱 전체 화면에서 적용됩니다. 화면 설정의 카메라 영상 보기와 채팅창 표시는 각각 독립적으로 저장하며, 공간에 따른 임시 이동·숨김은 저장값을 바꾸지 않습니다.

채팅창과 테마

화면 설정 → 채팅창 표시를 끄고 저장하면 채팅창이 숨겨지고 아바타가 확보된 가로 공간을 채웁니다. 음성과 대화 기록은 계속 유지됩니다.

숨긴 상태에서 대화 제어의 채팅 아이콘을 누르면 잠시 다시 열 수 있습니다. 이미지·동영상·음악 결과가 있을 때 유용합니다. 이 임시 조작은 저장된 설정을 바꾸지 않으며 새로고침하면 저장한 표시 상태로 돌아갑니다. 공개 링크에서도 같습니다.

PC 전체 화면에서는 아바타 영상이 화면 전체를 채우며, 채팅창은 화면 높이의 약 30%인 반투명 오버레이로 표시됩니다. 카드가 하나라도 나오면 오버레이 채팅창을 숨기고 마지막 카드가 사라지면 복원합니다. 자동 배치에서는 카메라가 없으면 오른쪽 아래를 기준으로 하고, 카메라가 있으면 수평 반대편을 우선합니다. 직접 위치를 고르면 그 위치를 먼저 사용합니다. 응답 카드·축소 아바타·카메라 영상·추천 질문 인덱스·마이크 조작 영역을 피해서 이동합니다. 빈 공간이 부족하면 채팅창과 채팅 버튼을 잠시 숨겼다가 카드가 닫히면 복원합니다. 저장한 채팅 표시 설정과 대화 기록은 유지됩니다.

모바일 전체 화면에서는 가로·세로 모두 채팅창과 채팅 보기 버튼을 숨깁니다. 화면 설정에서 채팅창 표시를 켰거나 공개 링크로 접속해도 같습니다. 음성과 대화 기록은 계속 유지되며, 기본 화면으로 돌아오면 이전 채팅 표시 상태가 복원됩니다. 채팅의 이미지·동영상·음악 결과는 기본 화면으로 돌아와 확인하세요.

상단 오른쪽의 라이트 모드 / 다크 모드 버튼으로 화면 색상을 바꿉니다. 테마는 방문자 자신의 브라우저에 저장됩니다. 사용자가 직접 만든 카드 HTML과 업로드한 배경 이미지는 자체 색상을 유지하므로 밝은 배경과 어두운 배경 모두에서 읽기 좋은지 확인하세요.

목소리·언어·캐릭터·배경 선택

녹색 영상의 배경 바꾸기

1. 실제 영상 배경이 녹색인 캐릭터를 선택합니다.
2. 캐릭터 옆 아바타 배경 → 이미지 업로드에서 원하는 이미지를 고릅니다.
3. 저장하고 적용 후 대화를 시작해 녹색 영역이 교체되는지 확인합니다.

업로드는 10MB 이하, 4천만 픽셀 이하 이미지를 지원합니다. 긴 변은 최대 1,600px로 줄여 브라우저에 보관합니다. 배경은 영역을 채우면서 일부가 잘릴 수 있으므로 가장자리에 중요한 문구를 넣지 않는 편이 좋습니다.

누르는 동안만 말하기

기본값은 꺼짐입니다. 켜고 저장하면 대화 제어에 작은 확성기 아이콘이 나타납니다. 아이콘을 누른 채 말하고 손을 떼면 내 목소리 전송이 닫힙니다. 키보드로는 버튼에 초점을 둔 상태에서 Space 또는 Enter를 누르고 말할 수 있습니다.

아바타가 어떤 역할로 답할지 정하기

아바타 설정 → 아바타 역할·말투에서 지시문을 작성합니다. 역할·말투는 대화 방식과 태도를 정하며, 구체적인 상품 가격·운영 시간 등은 응답 카드의 음성 참고 내용에 함께 관리하면 편리합니다.

1. 역할·말투 불러오기에서 예시를 선택합니다.

   고객지원, 영업, 교사, 여행, 취업·진로, IT, 부동산, 호텔, 박물관, 운동 코치의 10개 직업별 예시를 제공합니다.

2. 저장할 이름과 역할·말투 지시문을 편집합니다.

   이름은 80자, 지시문은 6,000자 이내입니다. 누구인지, 무엇을 안내하는지, 답변 길이와 말투, 모를 때 어떻게 안내할지 구체적으로 적습니다.

3. 필요하면 내 목록에 별도 저장합니다.

   새 역할로 저장해 두면 나중에 다시 불러올 수 있습니다. 개인 목록을 선택한 상태에서는 수정한 내용 저장과 목록 삭제도 가능합니다.

4. 아바타 설정의 저장하고 적용을 누릅니다.

   개인 목록에 보관하는 것과 대화에 적용하는 것은 별개입니다. 진행 중에 지시문을 바꾸면 새 대화로 시작합니다.

당신은 링크브릭스 도서관 안내 도우미입니다. 이용자의 질문에 친절하게 한두 문장으로 답하세요. 운영 시간과 이용 규칙은 설정된 안내 자료를 바탕으로 설명하세요. 확인되지 않은 정보는 추측하지 말고 안내 데스크에 문의하도록 알려 주세요.

공통 언어 규칙: 사용자가 별도로 다른 언어를 요청하지 않는 한 아바타 설정에서 선택한 대화 언어로 답합니다. 따라서 지시문을 한국어로 작성해도 대화 언어를 English로 선택하면 영어 답변을 사용합니다. 자동 선택이면 사용자의 언어에 맞춥니다.

최초 인사, 카메라 미연결 안내, 상황 트리거의 지정 대사, 워크플로우 응답에도 같은 언어 규칙을 적용합니다. 화면·카드 편집 언어나 호출어의 언어를 바꿔도 아바타의 대화 언어는 바뀌지 않습니다.

적용 중인 역할로 되돌리기는 편집 중인 지시문을 현재 적용값으로 되돌립니다. 개인 목록을 삭제해도 지금 편집 중인 지시문이나 이미 진행 중인 대화를 곧바로 지우지는 않습니다.

사진을 찍고 편집하거나 주변을 보여 주기

아바타 상황 인식 설정은 아바타 설정 바로 다음에 있습니다. 처음에는 카메라와 자동 상황 인식이 모두 꺼져 있고 새로 설정하는 인식 모드는 VORA-HYBRID입니다. 기존에 저장한 설정은 유지합니다. 켜기·끄기는 다른 설정과 같은 슬라이드 스위치입니다.

1. 카메라 사용 허용을 켜고 저장하고 적용을 누릅니다.

   영상 왼쪽 위에 작은 카메라 아이콘이 생깁니다. 이 단계만으로 카메라 권한을 요청하거나 사진을 업로드하지 않습니다. 화면 설정의 카메라 영상 보기를 켜고 저장하면 이 허용 스위치를 자동으로 켜면서 기기 연결도 요청합니다.

2. 카메라 아이콘을 눌러 기기를 연결합니다.

   전면·후면 또는 장치 이름을 선택하고 선택한 카메라 연결을 누릅니다. 브라우저 권한을 허용하세요. 실제 영상이 들어오면 녹색 표시가 켜집니다. 미리보기는 창을 빈 공간 없이 채우고, 촬영 사진은 원본 비율을 유지합니다. 창에는 원본 영상 크기와 분석에 사용할 사진 크기가 표시됩니다.

3. 대화를 시작하고 카메라로 확인할 내용을 묻습니다.

   “내 옷이 어때?”, “여기 분위기 어때 보여?”, “이 문서 읽어줘”처럼 현재 화면의 분석을 요청하면 호출어 없이 백그라운드에서 새 사진 한 장을 촬영합니다. 카운트다운·셔터 소리·사진 오버레이 없이 분석 결과를 말합니다. 자동 상황 인식은 켜거나 꺼도 되며 카메라 연결과 워크플로우 사용은 켜져 있어야 합니다. “보라”를 붙여도 같은 요청을 한 번만 처리합니다.

카메라가 꺼져 있을 때

“카메라 사용해 줘”라고 요청했는데 연결되지 않았다면, 아바타가 선택한 대화 언어로 권한 허용·기기 선택·연결 방법을 안내합니다. 카메라 기능 자체가 꺼져 있으면 먼저 아바타 상황 인식 설정에서 켜야 합니다. 공개 페이지에 설정 메뉴가 없다면 페이지를 만든 사람에게 기능 활성화를 요청하세요. 카메라 사용 요청만으로 사진을 찍거나 브라우저 권한을 자동으로 허용하지 않습니다.

화면 카운트다운으로 사진 찍기

1. 카메라를 연결하고 “사진 찍어줘”라고 말합니다.

   사진 촬영에는 보라 호출어나 워크플로우 연결이 필요하지 않습니다.

2. 화면의 3 → 2 → 1을 기다립니다.

   숫자를 1초씩 표시한 뒤 촬영합니다. 기기에 선택한 언어의 음성이 있으면 숫자 음성도 함께 나올 수 있습니다. 음성이 없거나 아바타가 말하는 중이어도 화면 카운트다운과 촬영은 진행됩니다.

3. 셔터 소리와 함께 나타나는 사진을 확인합니다.

   사진은 아바타 영상 위에 표시됩니다. 다시 찍으려면 “사진을 다시 찍어줘”라고 말하세요. 카운트다운 중 다른 말을 하거나 카메라를 끄고 다른 탭으로 이동하면 진행 중인 촬영을 취소합니다.

방금 찍은 사진 편집·분석하기

이미지 편집을 지원하는 워크플로우를 연결한 뒤 “보라, 이 사진을 지브리 스타일로 편집해줘”, “보라, 이 사진 배경만 바꿔줘”처럼 설정한 호출어를 포함해 말하세요. 직전 사진을 사용하며 새로 촬영하지 않습니다. “보라, 이 사진에 뭐가 보여?”는 저장된 사진을 분석하는 요청입니다.

편집 요청이 시작되면 사진 오버레이가 자연스럽게 사라지고 “보라가 편집 중입니다.”가 표시됩니다. 완성된 이미지는 아바타의 답변과 함께 채팅창에서 확인하세요. 이어서 편집하거나 사진에 대해 물으면 가장 최근 편집 결과를 사용합니다. 결과가 나오기까지 최대 150초 동안 기다릴 수 있습니다.

워크플로우에 이미지 분석 툴 연결하기

현재 화면 질문은 원래 질문과 촬영 이미지의 URL을 워크플로우에 전달합니다. 워크플로우에 이미지 분석·인식 툴을 연결하고, Camera Context 아래 Image URL 줄의 전체 주소를 툴의 이미지 입력으로 넘기세요. 주소를 텍스트로만 전달하는 모델은 사진 내용을 볼 수 없습니다. 이미지 생성·편집 툴만 연결되어 있다면 별도의 이미지 분석 툴도 필요합니다. 실제 이미지를 읽은 결과로 답하도록 설정하세요.

자동 상황 인식 켜기

자동 상황 인식을 켜고 인식 모드를 고릅니다. 상황 응답 추가 또는 손 흔들기 예시 추가 (한 손·두 손)로 최대 5개의 응답을 만들고 저장하고 적용을 누르세요. 카메라가 연결되고 대화를 시작하면 작동합니다. 별도 워크플로우 연결 없이 선택한 인식 모드로 분석합니다.

카메라 사용과 자동 인식은 따로 설정합니다

처음에는 상황 응답이 비어 있습니다. 자동 인식 스위치만 켜지 말고 사용할 조건과 대사를 추가하세요. 아래의 기본값은 새로 설정할 때의 값이며, 이미 저장한 선택은 유지됩니다.

인식 모드: 어디에서 영상을 분석할까요?

VORA-LOCAL의 기기 처리는 자동 상황 인식 영상에 적용됩니다. 조건 문장을 해석하는 작업, 아바타 대화, 사용자가 따로 요청한 사진 분석·편집에는 서버 연결이 사용됩니다. LOCAL로 전환해도 진행 중인 별도 사진 촬영·편집을 모드 변경만으로 취소하지는 않습니다.

신규 방문자의 기본 모드는 VORA-HYBRID이며, 이전 버전에서 저장한 VORA-AI 설정은 그대로 유지합니다. 서버가 제공하지 않는 모드는 선택할 수 없고, HYBRID를 제공하지 않는 배포에서는 신규 기본값도 VORA-AI입니다.

기기 처리 성향과 실행 장치

VORA-HYBRID와 VORA-LOCAL에서 표시됩니다. 여기서 말하는 기기는 페이지를 보고 있는 방문자의 PC·휴대폰입니다. 서버의 GPU나 CPU를 선택하는 옵션이 아닙니다.

위 숫자는 분석 목표이며 카메라 촬영·발화 횟수나 응답 시간 보장이 아닙니다. 실제 분석 빈도는 서버가 허용한 상한, 기기 성능, 조건에 필요한 최소 관찰 빈도에 맞춰 조정합니다. 빠른 반응으로 바꿔도 조건의 유지 시간이나 음성 대기 순서를 생략하지 않습니다.

HYBRID의 두 가지 서버 보완 옵션

두 항목 모두 서버 분석이 기본입니다. 해당 조건 중지를 선택하면 해당 이유로 처리할 수 없는 조건만 멈추고, 다른 실행 가능한 조건과 아바타 대화는 계속 사용할 수 있습니다.

첫 번째는 조건의 지원 여부, 두 번째는 현재 장치의 실행 가능 여부에 대한 선택입니다. 기기 미지원 조건을 중지해도 두 번째 항목이 서버 분석이면 실행 실패한 기기 조건의 영상은 서버로 전송될 수 있습니다. 자동 영상의 기기 내 처리만 원하면 VORA-LOCAL을 선택하세요.

조건 확인: 문장과 처리 위치를 먼저 확인하기

1. 상황 응답 추가 또는 손 흔들기 예시 추가 (한 손·두 손)를 누릅니다.

   최대 5개까지 만들 수 있습니다. 사용할 응답을 켜고 이름·조건·적어도 한 언어의 대사를 채웁니다. 예시는 “카메라에 보이는 손 중 하나 이상이 좌우로 흔들리고 있다.”라는 조건과 인사 대사를 함께 채워 줍니다. 한 손만 흔들거나 두 손을 함께 흔들어도 감지하며, 정확히 한 손만 또는 반드시 두 손 모두를 요구하는 조건이 아닙니다. 첫 접속 때 자동으로 등록되는 기본 규칙은 아닙니다.

2. 눈으로 확인할 수 있는 조건을 적습니다.

   예: “한 손으로 V자 손동작을 2초 동안 유지한다.” 손·팔·사물이 화면 안에 충분히 보이도록 연결한 카메라를 조정합니다. 여러 조건을 적었다면 모두 충족해야 하는지, 하나만 충족해도 되는지 구체적으로 적으세요.

3. 조건 확인을 누르고 해석을 읽습니다.

   각 응답의 기기 분석·서버 분석·중지 여부가 표시됩니다. 기기 조건은 손동작·자세·사물 개수, 모두 충족 또는 하나 이상 충족, 지정한 유지 시간도 확인할 수 있습니다. 의도와 다르면 문장을 수정하고 다시 확인합니다. 기기 분석 표시만으로 실제 카메라 감지 성공이 확인된 것은 아닙니다.

4. 저장하고 적용을 누릅니다.

   조건 확인은 미리보기이며 실행 설정을 저장하지 않습니다. 저장하고 적용에서도 필요한 검사를 자동으로 진행하므로 조건 확인 버튼을 반드시 따로 누를 필요는 없습니다. 조건·모드를 수정하거나 확인 결과가 만료되면 다시 검사합니다.

VORA-AI에서는 조건 확인 버튼이 표시되지 않습니다. VORA-LOCAL에서 중지로 표시되는 활성 조건은 수정하거나 꺼야 적용할 수 있습니다. 손가락 하트와 머리 위 하트는 손·팔이 충분히 보여야 하며, 화재·연기 조건의 기기 분석은 전용 모델을 제공하는 배포에서만 사용할 수 있습니다.

응답마다 정하는 민감도와 반복 방식

VORA-HYBRID와 VORA-LOCAL의 각 상황 응답 안에서 설정합니다. 응답마다 다른 값을 사용할 수 있으며 기본값은 표준 · 재감지 시 한 번입니다.

기기 감지는 여러 관찰과 유지 시간을 확인하므로 민감으로 선택해도 사진 한 장만으로 즉시 반응하지 않습니다. 문장에 “2초 동안”처럼 더 긴 유지 시간을 지정하면 그 시간도 충족해야 합니다. 민감도는 서버 이미지 분석 모델의 설정을 변경하지 않습니다.

CPU 전환이나 잠깐의 관찰 중단만으로 같은 동작을 새 상황으로 보지는 않습니다. 기기 규칙이 실행 불가로 HYBRID의 서버 보완에 넘어간 경우에도 유지 시간과 반복 정책을 이어서 적용합니다. 처음부터 VORA-AI를 사용하거나 기기 미지원으로 서버에 배정된 조건은 아래의 서버 촬영 간격별 반복 정책을 따릅니다.

손 흔들기와 다른 상황을 함께 등록하기

VORA-HYBRID는 응답마다 처리 위치를 정합니다. 예를 들어 “사용자가 카메라를 향해 손을 흔들고 있다.”는 기기에서, “사람이 쓰러졌다.”는 미지원 조건을 서버로 보완하도록 설정했을 때 AI에서 분석합니다. 쓰러짐을 추가해도 기존 손 흔들기의 조건·대사·사용 여부는 유지됩니다. 조건 확인에서 각 응답의 처리 위치를 확인하세요. 같은 관찰에서 여러 조건이 동시에 맞으면 위에 놓인 응답 하나를 선택하고, 서로 다른 분석 결과는 도착한 순서로 대기합니다.

손 흔들기는 손바닥을 충분히 보여 주면서 좌우로 움직여야 합니다. 손을 가만히 들고 있는 것만으로는 반응하지 않습니다. 두 손이 보여도 구분 가능한 손을 각각 관찰합니다. 기본 재감지 시 한 번에서는 계속 흔드는 동안 한 번만 반응하며, 움직임을 멈춘 것이 확인된 뒤 다시 흔들면 손을 화면 밖으로 내리지 않아도 다시 반응합니다.

서버 조건만 반응한다면 기기 인식 상태가 준비 중·성능 제한·사용 불가인지 확인하고 필요하면 다시 시도하세요. 서버 촬영 간격은 기기에서 실행 중인 손 흔들기의 관찰 빈도를 바꾸지 않습니다.

서버 분석의 촬영 간격

처음 값은 30초·3장으로, 실제로는 10초마다 한 장씩 바로 분석합니다. 촬영 간격과 해상도는 VORA-AI 및 HYBRID에서 서버로 보내는 사진에 적용합니다. 기기 분석의 빈도는 위의 기기 처리 성향을 사용하며, VORA-LOCAL에서는 서버 촬영 옵션이 숨겨집니다. 아래의 촬영 간격별 반복 정책은 서버로 배정된 기존 AI 규칙에 적용됩니다.

사진을 한 장 찍을 때마다 즉시 분석 요청을 보냅니다. 예를 들어 기존 5초·2장 설정은 2.5초에 첫 사진을 찍어 바로 분석하고, 5초에 다음 사진도 즉시 분석합니다. 앞선 결과를 기다리지 않으며 업로드 준비를 포함해 최대 5개 요청을 병렬 처리합니다. 모두 진행 중이거나 업로드가 바쁘면 새 사진을 쌓지 않고 건너뜁니다. 화면 정지·촬영 누락 시 이전 사진을 복제하지 않습니다. 한 요청에서는 최대 5개 상황 조건을 함께 검사하고, 조건이 맞으면 우선순위가 가장 높은 응답 하나를 말합니다. 같은 조건의 반복 발화는 아래 촬영 간격별 규칙을 따릅니다. 촬영 빈도는 유지되지만 개별 분석으로 API 요청 수가 늘어납니다.

자동 상황 인식을 켜거나 주기·해상도·규칙을 바꾸고 저장하고 적용을 눌러도 연결한 카메라와 선택한 장치는 유지됩니다. 적용한 시점부터 새 촬영 구간을 시작합니다. 카메라 사용 허용을 끄거나 대화를 종료하면 카메라 연결을 해제합니다.

상황 분석 중에도 음성 대화를 계속할 수 있습니다. 사용자가 질문하면 아바타가 먼저 답하고, 대기 중인 상황 응답을 결과가 도착한 순서로 이어 말합니다. 예를 들어 “대한민국의 수도는?”에 “서울”이라고 답한 뒤 상황에 맞는 응원 대사를 말합니다. 분석과 필요한 대사 번역은 그동안 계속 진행됩니다. 사진을 모으는 대기와 추가 고정 대기는 없으며, 업로드·분석·음성 생성·재생에는 시간이 필요합니다.

긴 촬영 간격의 첫 분석을 받으려면 해당 간격보다 오래 대화를 유지해야 합니다. 예를 들어 기존 1시간 설정은 6분 후 첫 사진부터 바로 분석하므로 한 시간이 지날 때까지 기다리지 않습니다. 대화 종료나 탭 이탈 시 촬영과 진행 중인 작업을 취소합니다.

서버 분석의 360p / 720p / 1080p 해상도

기본값은 720p, 최대는 1080p입니다. 가로 기준 최대 1920×1080이며 세로 영상은 이에 대응하는 세로 비율로 처리합니다. 원본이 작으면 확대하지 않습니다. 높은 해상도는 작은 물체나 글자 확인에 도움이 될 수 있지만 데이터와 API 비용이 늘 수 있습니다. 요청할 때 찍는 한 장은 최대 1080p입니다.

360p는 전송량을 줄이고 싶을 때, 720p는 일반적인 장면 확인, 1080p는 작은 물체나 글자를 더 자세히 보여 주고 싶을 때 선택합니다. 해상도를 높여도 흐림·어두움·가림이 해결되지는 않습니다.

상황 응답의 이름·대사·우선순위

상황별 음성 응답 편집

• 어떤 상황에서 말할까요?에는 사진에서 직접 보이는 조건을 구체적으로 적습니다.
• 아바타가 말할 내용에 전달할 내용이나 예시 문장을 적습니다. 아바타가 선택한 언어의 스크립트를 사용하며, 비어 있으면 다른 언어로 작성한 스크립트를 번역합니다. 57개 지원 언어를 선택해 직접 작성할 수 있습니다.
• 서버의 기존 AI 규칙은 한 장에서 조건이 감지되면 응답합니다. 다음 사진까지 조건을 유지할 필요가 없습니다. 촬영한 한 장이 하나의 분석 요청이 되며, 기존 마지막 사진 기준 설정도 같은 방식으로 적용됩니다.
• 기존 AI 규칙의 빠른 촬영은 같은 조건의 반복 발화를 줄입니다. 1초 설정은 같은 조건의 발화를 요청한 뒤 10초 동안 한 번만 말하며, 같은 조건이 대기 중이면 추가하지 않습니다. 5초 설정은 2.5초마다 촬영하지만 같은 5초 촬영 주기 안에서 같은 조건은 한 번만 말합니다. 다음 주기에는 다시 말할 수 있습니다. 다른 조건은 각각 처리하고, 한 요청에서 여러 조건이 맞으면 발화 가능한 위쪽 응답 하나를 선택합니다. 나머지 간격은 조건에 맞는 요청마다 한 번 말합니다.
• 첫 조건이 확인되면 주기 종료를 기다리지 않고 바로 발화를 요청합니다. 촬영 직후에도 실제 음성까지는 업로드·분석·음성 생성·재생 시간이 더해집니다. 대화나 음성이 진행 중이면 결과 도착 순서대로 이어 말합니다. 10초 이상 기다렸거나 이전 촬영 결과라는 이유로 생략하지 않습니다. 불확실한 결과는 말하지 않으며, 카메라 해제·설정 변경·대화 종료 시 대기 응답을 비웁니다.

상황 대사와 응답 순서

아바타가 말할 내용에는 전달할 내용과 의도를 입력합니다. 아바타는 이를 응답 가이드로 사용하며, 문장을 그대로 읽지 않고 의미와 사실을 유지하면서 자연스럽게 바꿔 말할 수 있습니다. 예를 들어 우리 모두 화이팅!을 다 같이 힘내봐요!로 말할 수 있습니다. 가이드에 없는 사실·약속·행동을 덧붙이지 않도록 합니다. 선택한 아바타 언어의 내용을 사용하고, 해당 언어가 비어 있으면 다른 언어의 내용을 번역합니다.

상황 응답도 아바타 설정에서 선택한 음성과 기존 페르소나의 말투를 사용합니다. 캐릭터는 화면의 외형·동작을, 음성은 인사·대화·상황 응답의 목소리를 정합니다. 상황별 톤 지정 기능은 제공하지 않습니다. 기존에 저장된 내용 앞의 [톤 설명]은 자동으로 제외하고 뒤의 내용만 사용합니다.

V자는 얼굴 앞에 보여도 위치 때문에 제외하지 않습니다. 다만 손과 벌어진 두 손가락이 카메라에 선명하게 보여야 합니다. 가림, 흐림, 옆으로 돌아간 손, 작은 화면 속 손은 놓칠 수 있습니다. 감지가 어려우면 손을 얼굴 옆으로 옮겨 카메라를 향해 보여 주세요.

로컬로 처리하는 손동작은 기기에서 감지합니다. 감지 후의 음성 생성과 아바타 재생은 별도 과정입니다. 카메라 미리보기를 끄거나 카드 때문에 영상이 잠시 숨겨져도, 연결된 카메라의 상황 인식은 계속됩니다.

시작 인사·사용자 대화·진행 중인 음성이 끝난 뒤 상황 대사를 이어 말합니다. 응답 준비 후 음성이 시작되지 않으면 자동 복구를 한 번 시도합니다. 이미 음성이 시작되었거나 사용자가 말하기 시작하면 같은 대사를 자동으로 겹쳐 재생하지 않습니다. 카메라 해제·설정 변경·대화 종료 시 이전 응답의 복구를 취소합니다.

인식 상태와 다시 시도

공유 URL과 모바일

공유에는 카메라 사용·자동 인식·인식 모드·보완 정책·주기·해상도·상황별 응답이 적용됩니다. 기기 ID나 연결 여부는 공유하지 않습니다. 방문자는 자신의 카메라 권한과 기기를 선택하며, 카메라 아이콘으로 끄거나 바꿀 수 있습니다.

공유 방문자는 이 기기의 상황 인식 설정에서 자신의 인식 모드·기기 처리 성향·실행 장치만 바꿀 수 있습니다. 원본 조건·대사·민감도·반복·우선순위·보완 정책·카메라 사용 허용은 페이지 소유자가 정합니다. 변경은 해당 공유 페이지의 방문자 설정이며 원본 공유를 수정하지 않습니다. 모드 선택만으로 카메라가 켜지지 않으며 저장하고 적용을 눌러야 반영됩니다.

카드는 왼쪽 위 카메라·오른쪽 위 전체 화면 버튼과 전체 화면의 아래쪽 통화 조작 영역을 비워 두고 표시됩니다. 모바일에서도 이 조작 영역 사이에서 카드 내용을 스크롤하고 닫을 수 있습니다.

휴대폰은 HTTPS에서 사용하세요. 다른 탭·앱으로 이동하면 카메라를 끄고 모아 둔 사진을 버립니다. 돌아오면 아이콘으로 다시 연결합니다. 카메라 변경은 마이크·누르는 동안 말하기·아바타 세션을 다시 시작하지 않습니다.

이미지 보관과 API 사용

서버로 전달하는 사진은 크기를 제한하고 메타데이터를 제거한 뒤 임시 저장소에 올립니다. 편집에는 원본의 짧은 CDN 주소를 자동으로 전달하므로 사용자가 주소를 복사할 필요가 없습니다. 자동 분석용 서명 URL은 5분 뒤 만료됩니다. 자동 분석 사진은 처리 후 삭제하고 요청 사진과 미완료 업로드는 10분 뒤 정리합니다. 편집 결과 이미지의 보관 기간은 연결한 워크플로우에 따라 다릅니다.

VORA-AI와 HYBRID의 서버 자동 분석, 조건 문장의 해석, 질문의 카메라 사용 여부 판별(텍스트만), 필요한 스크립트 번역에는 API 사용 비용이 발생할 수 있습니다. 기기에서만 분석하는 자동 영상은 이 이미지 업로드·서버 이미지 분석 경로를 사용하지 않습니다. 인식 모드·보완 정책·서버 해상도·촬영 간격을 함께 확인해 사용량을 관리하세요.

VORA 워크플로우 연결과 호출어

워크플로우는 외부 검색이나 별도 작업이 필요한 질문에 사용합니다. 기본값은 사용 안 함입니다. 일반 대화와 응답 카드 기능은 워크플로우를 켜지 않아도 사용할 수 있습니다.

1. 연결 정보와 호출어를 확인합니다.
2. 워크플로우 사용을 켜고 저장하고 적용을 누릅니다.
3. 대화에서 “보라, 오늘 서울 날씨를 알려 줘”처럼 호출어와 요청을 함께 말합니다.

호출어가 들어간 질문은 워크플로우가 우선합니다. 아바타가 답을 알고 있거나 카드 조건과 일치해도 연결된 워크플로우를 실행합니다. “보라오늘 서울 날씨 알려줘”처럼 붙여 인식되어도 처리합니다. “보라색”, “보라빛”, “보라매”, “보라카이” 같은 일반 단어는 호출하지 않습니다.

“보라”만 먼저 말해도 됩니다. 10초 안에 시작하는 다음 발화 한 번을 같은 요청으로 연결합니다. 호출어만 검색하거나 예전 질문을 다시 보내지 않습니다. 연속 질문은 각각 한 번씩 순서대로 처리하며, 대기 한도를 넘으면 다시 요청하도록 안내합니다.

어떤 요청에 호출어가 필요한가요?

외부 워크플로우 요청은 원칙적으로 호출어가 필요합니다. 연결된 카메라의 현재 화면을 분석하는 명시적 질문만 예외입니다. 아래는 기본 호출어 보라를 사용하는 예시입니다. 설정에서 호출어를 바꿨다면 해당 단어를 사용하세요. 영어 기본 호출어는 vora입니다.

현재 화면 분석은 카메라가 실제 연결되어 있을 때 한 장을 새로 찍어 처리합니다. 저장된 사진을 지칭하는 분석과 편집, 새 이미지 생성은 호출어가 필요합니다. “서울을 그려줘” 다음에 “야경”이라고만 답하면 이미지를 생성하지 않습니다. 실행하려면 “보라, 서울의 야경을 이미지로 그려줘”처럼 호출어와 작업 내용을 함께 말하세요.

호출어를 나눠 말할 때는 “보라” → 10초 안에 “이 사진을 편집해줘” 순서도 가능합니다. 이 연결은 다음 발화 한 번에만 적용됩니다. 다음 작업을 요청할 때는 호출어를 다시 포함하세요. 음성 인식에서 호출어가 빠졌다면 대화 기록을 확인한 뒤 호출어와 질문을 다시 말해 주세요.

현재 카메라 화면의 명시적 분석 질문을 제외하면, 호출어가 없는 외부 워크플로우는 실행하지 않습니다. 새 이미지 생성·촬영 사진 편집·저장된 사진 분석에는 호출어가 필요합니다. “야경”처럼 주제나 스타일만 답해도 워크플로우를 호출하지 않습니다. 아바타가 직접 답하기 어려우면 워크플로우를 켜거나 호출어를 넣어 다시 질문하도록 안내할 수 있습니다. 호출어가 이미 확인되어 조사 중일 때는 다시 호출어를 말하라는 안내를 하지 않도록 처리합니다. 연결된 워크플로우가 실제로 그 검색·작업을 지원해야 결과를 받을 수 있습니다.

처리 중 표시와 결과

워크플로우를 호출하면 화면 중앙에 연한 반투명 안내가 표시됩니다. 요청에 따라 아래 문구를 사용하며 선택한 아바타 언어에 맞춰 표시합니다(57개 언어). 결과에 대한 첫 음성이 도착하면 안내가 사라집니다. 오류가 나오면 내용을 확인하고 잠시 후 다시 요청하세요.

음성으로 새 이미지 생성하기

이미지 생성을 지원하는 워크플로우를 연결하고 “보라, 노란색 고양이 캐릭터 이미지를 한 장 그려줘”처럼 설정한 호출어와 함께 말하세요. 별도 이미지 생성 버튼이나 카메라·촬영 사진은 필요하지 않습니다. 생성 결과는 채팅창의 답변 아래에 표시됩니다. 이미 찍은 사진을 바꾸려면 촬영 사진 편집 방법을 사용하세요.

사용자 요청은 호출어를 포함한 원문 그대로 전달합니다. 호출어와 질문을 나눠 말한 경우 두 원문을 줄바꿈으로 연결합니다. 별도 추가 조건으로 선택한 대화 언어, 짧은 답변 1~2문장, 미디어와 참고 링크를 합쳐 2개 이하를 요청합니다. 사용자가 다른 답변 언어를 명시하면 해당 요청을 우선합니다. 워크플로우 변수 오버라이딩은 하지 않습니다.

워크플로우가 반환한 음성 본문을 아바타가 추가 요약 없이 한 번 읽도록 요청합니다. 대화 기록에는 실제 아바타가 말한 내용만 표시하고, 관련 이미지·음악·동영상과 참고 링크를 그 답변 아래에 붙입니다. 원본 JSON이나 별도의 중복 답변은 표시하지 않습니다. 검색·생성 결과를 모두 받은 뒤 음성을 시작하므로 작업에 따라 기다리는 시간이 달라집니다.

짧은 답변 조건은 음성용 워크플로우 요청에만 적용합니다. 응답 카드의 자세한 내용·디자인과 AI로 작성하기의 전체 HTML/CSS는 유지됩니다.

카드와 추천 질문을 구분하기

VORA 응답 카드 설정에서는 대답할 자료와 화면 디자인을 함께 관리합니다. 기본 응답 카드는 주요 기능·요금 안내·모드 비교·고객지원의 4개입니다. 첫 화면의 추천 질문도 기본 4개지만 서로 다른 설정입니다.

카드 목록에서 할 수 있는 일

• 첫 화면 제목·추천 질문: 맨 위 버튼을 눌러 아바타 위 문구와 추천 질문을 편집합니다.
• 카드 선택: 목록에서 편집할 항목을 누르면 해당 카드의 설정과 디자인이 열립니다.
• 이 응답 사용: 끄면 해당 카드의 답변 자료·화면 표시·연결 추천 질문을 사용하지 않습니다.
• 카드 추가: 새 항목을 만듭니다. 선택한 편집 언어 전용으로 생성됩니다.
• 카드 복사 / 삭제 / ↑ / ↓: 선택 카드의 편집 영역 위에서 복제·삭제·순서 변경을 합니다.

응답 카드 기능 사용을 끄면 등록된 카드 응답 기능 전체를 끕니다. 일부만 제외하려면 목록의 개별 체크박스를 사용하세요.

카드 하나는 카드 디자인 → 표시 위치 → 질문·표시 조건 → 음성 스크립트 순서로 설정합니다. 먼저 보여 줄 화면과 위치를 정하고, 어떤 사용자 질문에 표시할지와 그때 말할 내용을 연결하세요.

기본 카드에서 시작하기

기본 고객지원 카드의 문의 이메일은 contact@horizonai.ai입니다. 카드 디자인 코드에서 자신의 서비스 주소로 변경할 수 있습니다.

처음에는 기존 카드 4개의 전체 디자인 코드와 표시 위치·호출 조건이 채워져 있습니다. 음성 탭에도 실제로 답변에 사용하는 카드 글이 보입니다. 기본 카드를 하나 선택하고 복제하면 언어별 코드·음성·호출 조건·위치까지 함께 복사하므로 원본을 남기고 새 주제를 만들 수 있습니다. 추천 질문에는 자동 추가되지 않으므로 필요한 항목만 직접 연결하세요.

자동 조건의 카드는 관련 대화에서 AI가 선택할 수도 있습니다. 사용자가 특정 질문을 했을 때만 표시하려면 입력한 표현만 → 사용자로 바꾸고 문구를 등록하세요. 기존 저장 설정이 있으면 새 기본값으로 덮어쓰지 않습니다.

이름과 화면 문구 구분하기

추천 질문을 카드에 연결하면 카드의 사용 여부와 언어 조건에 따라 함께 보이거나 숨겨집니다. 연결은 클릭 동작이나 음성 호출 조건을 만들지 않습니다. 실제로 카드를 띄울 문장은 호출 조건에서 별도로 정합니다.

실제 적용 전에 화면 확인하기

첫 화면 제목·추천 질문을 편집 중이거나 선택 카드가 사용 안 함이면 선택 카드 보기는 비활성화됩니다. 음성 전용 응답은 미리보기에도 실제 카드를 띄우지 않습니다. 상단 미리보기의 카드 표시 시간이 끝나면 자동으로 카드 없이 보기 상태로 돌아갑니다.

카드 디자인 탭에는 개별 카드 미리보기가 별도로 있습니다. 이 미리보기는 편집하는 동안 계속 보이며 자동으로 사라지지 않습니다. 코드 편집창과 함께 세로 크기를 조절할 수 있습니다.

관리용 이름과 음성 스크립트 편집하기

카드 위의 관리용 이름은 설정 목록에서 항목을 구분하는 이름입니다. 화면의 제목·가격·설명·항목은 모두 카드 디자인의 HTML/CSS에서 수정하고 추가·삭제합니다. 요금표나 비교표에 한정된 고정 입력란은 없습니다.

음성 스크립트 탭은 기본적으로 현재 카드 내용으로 답변 상태입니다. 아바타가 말할 내용에 현재 HTML에서 가져온 실제 글을 표시하며, 디자인을 수정하면 함께 바뀝니다. 이 자동 연결 상태의 글은 읽기 전용입니다.

말할 내용을 따로 정하려면 이 내용으로 음성 스크립트 작성을 누릅니다. 현재 글 중 최대 2,000자를 편집창에 복사하므로 이를 짧은 답변으로 고치거나 새로 작성하세요. 선택한 언어별로 저장됩니다. 현재 카드 내용으로 다시 연결하면 별도 스크립트를 비우고 최신 디자인의 글을 사용합니다.

음성 답변만 하게 만들기

1. 응답 방식을 음성 답변만으로 선택합니다.
2. 음성 스크립트 탭에서 이 내용으로 음성 스크립트 작성을 눌러 답할 정보를 씁니다.
3. 사용 언어와 호출 조건을 설정하고 저장합니다.
4. 실제 대화에서 관련 질문을 합니다. 답변 자료는 사용하되 카드는 화면에 띄우지 않습니다.

도서관은 화요일부터 일요일까지 오전 9시부터 오후 6시까지 운영합니다. 월요일은 휴관입니다. 마지막 입장은 오후 5시 30분입니다. 이용 시간 질문에는 운영 시간과 휴관일을 먼저 짧게 안내하세요.

음성 참고 내용을 비워 두면 현재 HTML의 텍스트를 참고하며, 이전 템플릿의 가격·설명·항목을 별도 답변 자료로 섞지 않습니다. 디자인이나 주제를 바꾸면 음성 참고 내용과 호출 조건도 확인하세요. 사실을 정확히 전달하려면 가격·날짜·수량 등은 명확히 적으세요. 답변은 지시문을 바탕으로 생성되므로 참고 내용 전체를 그대로 낭독하는 방식은 아닙니다.

카드 전체를 HTML/CSS로 디자인하기

카드 디자인 탭에는 개별 미리보기와 큰 HTML/CSS 편집창이 있습니다. 기본 카드의 코드가 먼저 들어 있으므로 이를 수정하거나 전체 코드를 교체할 수 있습니다.

• 글자, 색상, 간격, 배경, 이미지, 테두리, 배치 등 카드 전체 디자인을 바꿀 수 있습니다.
• <style> 안에 CSS를 넣고 HTML 본문을 함께 작성합니다. HTML은 카드별 최대 100,000자입니다.
• 제목·가격·설명·표·이미지 등 모든 내용을 코드에 직접 작성합니다. 기존 설정의 자리표시자는 편집기를 열 때 실제 텍스트로 풀어 표시합니다. {{request}}만 현재 사용자 질문을 넣는 용도로 사용할 수 있습니다.
• JavaScript, 폼 제출, 중첩 iframe은 실행하지 않습니다. 영상·음악 재생은 워크플로우 결과의 채팅 임베드를 사용하세요.
• 카드 편집창의 되돌리기 기능으로 코드 수정을 되돌릴 수 있습니다. 기본 카드 코드로 되돌리기를 누르고 확인하면 해당 기본 카드의 코드로 돌아갑니다. 새 카드는 기본 안내 코드로 돌아갑니다. 음성 답변과 호출 조건은 별도로 유지됩니다.

<style>
  * { box-sizing: border-box; }
  body { margin: 0; font-family: system-ui, sans-serif; }
  .guide { width: 100%; padding: 24px; border-radius: 18px;
    color: #123e4d; background: #fff; border: 1px solid #d6e6ed; }
  h1 { font-size: clamp(22px, 5vw, 34px); margin: 0 0 16px; }
  p { font-size: 18px; line-height: 1.6; }
</style>
<article class="guide">
  <h1>도서관 이용 안내</h1>
  <p>운영 시간 09:00–18:00<br>매주 월요일 휴관</p>
</article>

AI로 작성하기

1. 워크플로우 연결 정보를 먼저 저장합니다.

   HTML을 생성할 수 있는 워크플로우가 필요합니다. 이 편집 작업은 사용자가 버튼으로 실행하므로 음성용 워크플로우 사용 토글을 켜거나 “보라”를 입력할 필요는 없습니다.

2. 코드 위의 AI로 작성하기를 누릅니다.

   팝업에 원하는 디자인과 내용을 구체적으로 적습니다. 최대 2,000자입니다.

3. 카드 만들기를 누릅니다.

   현재 HTML/CSS를 참고 자료로 함께 전달합니다. 사용자 요청과 코드 수정 조건은 구분해 보냅니다. 이 작업에는 음성 대화 기록과 대화 ID를 보내지 않습니다.

4. 생성된 초안을 확인합니다.

   성공하면 코드와 개별 미리보기가 바뀝니다. 내용을 검토·수정하고 저장하고 적용하세요. 실패하거나 취소하면 기존 코드를 유지합니다.

디자인 요청에는 용도, 꼭 들어갈 사실, 색상, 배치, 모바일 요구사항을 함께 적으면 좋습니다. 예: “운영 시간과 휴관일을 크게 보여 주고, 파란색 계열의 두 칸 카드로 만들어 주세요. 모바일에서는 한 칸으로 배치해 주세요.”

호출 조건을 연결하고 시험하기

질문·표시 조건은 어떤 질문이나 답변에서 해당 카드를 표시할지 정합니다. 워크플로우의 호출어와 독립적이므로 카드 표시에 “보라”는 필수가 아닙니다. 인식된 실제 대화 문장에 조건을 적용합니다.

기본 자동 조건에는 실제 인식에 사용하는 대표 문구가 보이고, 예시 질문·답변에도 테스트 문구가 미리 들어 있습니다. 이 문구를 복사해 직접 설정을 누르면 현재 언어의 문구가 편집 목록에 채워지고 입력한 표현만 방식으로 바뀝니다. 이때 기본 자동 판단은 꺼지므로 표현을 추가·삭제하고 대상 발화를 확인하세요. 다른 언어의 기존 문구는 유지됩니다.

도서관 이용 시간 카드를 연결하는 예

1. 호출 조건을 입력한 표현만, 대상 발화를 사용자, 일치 방식을 하나라도 포함으로 선택합니다.
2. 한국어 표현에 운영 시간, 몇 시, 휴관을 각각 추가합니다.
3. 예시 질문·답변에 도서관은 몇 시까지 열어요?를 입력하고 입력 문장으로 확인을 누릅니다.
4. 조건에 맞은 카드 이름·이유와 연결된 음성 답변 자료를 확인합니다. 직접 작성한 스크립트가 없으면 현재 HTML의 내용을 보여줍니다. 화면 표시를 켠 카드라면 상단 미리보기에도 표시됩니다.
5. 저장하고 적용한 뒤 실제 대화에서 같은 내용을 물어봅니다.

입력 문장 확인은 현재 초안의 표현·언어·발화 조건을 검사합니다. 음성 인식 정확도나 실제 대화의 반복 대기 시간까지 재현하지는 않습니다. 실제로 카드가 안 뜨면 대화 기록에 질문이 어떤 문장으로 인식됐는지 먼저 확인하세요.

아바타 축소·위치·표시 시간 설정

선택 카드의 표시 위치 탭에서 배치를 조정합니다. 먼저 상단 미리보기의 PC를 선택하면 데스크톱 배치 항목이 표시됩니다.

카드는 언제 사라지나요?

음성 답변이 끝나는 시점과 자동으로 맞추지 않습니다. 카드 표시 시간을 따릅니다. 0초이면 기본 요금표는 18초, 모드 비교는 24초, 문의형은 직접 닫을 때까지 표시합니다. ×로 먼저 닫아도 음성 대화는 계속됩니다.

모바일에서는 전체 영역에 겹쳐 표시합니다.

아바타 영역 너비가 640px 이하이면 작은 화면에서 카드를 읽을 수 있도록 아바타 화면 전체에 겹칩니다. 음성은 계속 들립니다. PC에서 저장한 축소 위치·크기는 보관되며 넓은 화면에서 다시 사용합니다. 긴 카드는 카드 안을 스크롤해 확인하세요.

두 줄 제목과 추천 질문 편집하기

카드 목록 맨 위의 첫 화면 제목·추천 질문을 누릅니다. 여기서 바꾸는 제목은 아바타 영상 위에 겹쳐 보이는 문구입니다. 웹페이지 맨 위의 서비스 이름이나 브라우저 탭 제목을 바꾸는 메뉴는 아닙니다.

두 제목은 상단 모서리 아이콘 사이에 배치하며 화면 크기에 맞춰 글자 크기를 조절합니다. 카메라 영상·추천 질문·채팅창과 겹치면 빈 공간으로 이동하거나 잠시 숨깁니다. 추천 질문을 위쪽에 두면 제목은 그 아래에 배치합니다. 카드 닫기 버튼은 카드 테두리 안쪽의 작은 원으로 표시됩니다.

첫째 줄·둘째 줄·안내 문구

기본 첫째 줄은 “VORA AVATAR”, 둘째 줄은 “무엇이든 물어보세요”, 추천 질문 위 안내는 “이런 내용을 물어보세요”입니다. 세 문구를 각각 독립적으로 편집할 수 있습니다.

추천 질문의 개수와 표시 위치

• 전체 표시: 등록한 추천 질문을 보여 줍니다. 연결된 카드가 사용 안 함이거나 현재 언어 대상이 아니면 제외됩니다.
• 선택한 항목만: 각 추천 질문의 표시 체크박스로 필요한 것만 고릅니다.
• 숨기기: 추천 질문과 그 위의 안내 영역을 숨깁니다. 첫째·둘째 제목은 별도 보이기 설정을 따릅니다.
• 카드가 보일 때 제목·추천 질문 숨기기: 응답 카드가 열리는 동안 첫 화면 제목과 추천 질문을 함께 숨겨 겹침을 줄입니다.
• 추천 질문 위치: 위쪽 가로, 아래쪽 가로, 왼쪽 세로, 오른쪽 세로 중에서 선택합니다.

각 추천 질문의 아이콘·문구·연결 카드

연결할 응답 카드를 고르고 추천 질문 문구를 짧게 적습니다. 예: 카드 “도서관 운영 안내”에 문구 “운영 시간”과 시계 모양 아이콘을 사용합니다. ↑/↓로 순서를 바꾸고 필요 없는 항목은 삭제합니다. 연결 없이 문구만 표시할 수도 있습니다.

추천 질문 수를 줄이면 남길 항목을 선택하는 창이 열립니다. 모바일의 가로 목록은 긴 문구를 여러 줄로 늘리기보다 한 줄로 유지하고 좌우로 넘겨 보게 됩니다. 짧고 구체적인 문구를 사용하고 모바일 미리보기에서 확인하세요.

언어별 카드·제목·호출 표현 작성하기

카드 설정의 편집·미리보기 언어는 57개 아바타 언어를 지원합니다. 이 선택은 지금 편집할 작성본을 바꾸며, 아바타의 실제 대화 언어를 바꾸지는 않습니다. 실제 대화 언어는 아바타 설정에서 선택합니다.

1. 편집·미리보기 언어를 선택합니다.

   예: English를 선택하고 같은 카드를 엽니다.

2. 작성본이 없으면 이 언어용 작성본 만들기를 누릅니다.

   또는 가져올 언어를 선택하고 내용·디자인 가져오기로 다른 작성본을 복사합니다. 이 기능은 번역이 아니라 복사입니다.

3. HTML의 문구와 음성 참고 내용을 해당 언어로 편집합니다.

   질문·표시 조건 탭의 표현과 제외 표현도 해당 언어로 작성합니다. 예: “opening hours”, “closed”.

4. 이 카드를 사용할 언어를 확인합니다.

   모든 언어 또는 필요한 언어만 선택합니다. 새 카드는 만들 당시 편집 언어 전용이므로 다른 언어에서도 쓰려면 사용 언어를 추가해야 합니다.

5. 첫 화면 제목·추천 질문의 언어별 문구도 작성하고 저장합니다.

   같은 언어의 가상 화면에서 제목·추천 질문·카드가 함께 어울리는지 확인합니다.

기본 카드에는 다국어 작성본이 포함되어 있습니다. 사용자가 새로 쓴 문장은 다른 언어로 자동 번역되지 않습니다. 아직 작성하지 않은 언어는 영어 작성본 또는 기본 내용을 사용합니다. 번역이 필요한 경우 직접 편집하거나 AI로 작성할 때 원하는 언어를 명시하세요.

언어별로 달라지는 것은 문구·내용·HTML·음성 참고 자료·호출 표현입니다. 카드 사용 여부·응답 방식·배치, 첫 화면의 글꼴·색상·크기·위치 같은 공통 설정은 여러 언어에 함께 적용됩니다. 목록의 선택 언어의 카드 / 모든 카드는 편집 목록을 좁혀 보는 필터입니다.

카드 설정 파일 보관하기

카드 JSON에는 카드·호출 조건·배치·언어별 작성본·첫 화면 제목·추천 질문이 포함됩니다. 아바타 목소리·캐릭터·배경·역할 개인 목록·워크플로우 인증 정보까지 백업하는 파일은 아닙니다. 다른 PC에서 카드를 편집하려면 이 파일을 불러오고 해당 PC의 나머지 설정도 별도로 준비하세요.

카드 수에는 별도 개수 제한이 없지만 설정 전체는 4MB, 카드 HTML은 각각 100,000자 이내입니다. 큰 이미지 자체를 코드에 붙여 넣기보다 HTTPS 이미지 주소를 사용하면 설정 파일을 작게 유지할 수 있습니다.

설정 없이 대화 화면만 공유하기

1. 공유할 설정을 모두 저장하고 적용합니다.

   화면·아바타·워크플로우·카드 각각의 저장 상태를 확인합니다. 저장 전 미리보기 초안은 공유에 반영되지 않습니다.

2. 대화 제어의 공개용 URL 복사를 누릅니다.

   기본 화면에서 대화 종료 앞에 있습니다. 전체 화면이라면 영상 오른쪽 위 버튼으로 먼저 돌아오세요. 링크 생성과 복사가 끝나면 완료 메시지가 표시됩니다.

3. 복사한 주소를 전달합니다.

   방문자에게는 아바타·대화 기록과 대화 제어가 표시되고, 가로줄 아래의 설정 편집기는 보이지 않습니다. 전체 화면으로 시작 또는 채팅창 숨김을 저장했다면 그 상태도 반영됩니다.

4. 변경 후에는 새 링크를 만듭니다.

   기존 링크는 복사 당시 설정을 유지합니다. 나중에 내 설정을 고쳐도 예전 링크의 내용은 자동으로 바뀌지 않습니다.

• 링크만 열어서는 음성 세션이 시작되지 않습니다. 방문자가 대화 시작과 마이크 허용을 진행합니다.
• 각 방문자는 별도의 대화를 시작합니다. 만든 사람의 대화 기록을 함께 공유하지 않습니다.
• 적용한 목소리·언어·캐릭터·배경·역할·워크플로우·카드·전체 화면 시작·채팅창 설정이 보관됩니다. 역할 개인 목록 전체를 공개하지는 않습니다.
• 워크플로우 인증 토큰은 공개 URL이나 방문자용 설정 응답에 포함하지 않습니다.
• 기본 유효기간은 24시간입니다. 운영자가 환경 변수로 바꿀 수 있으므로 만료되면 새 링크를 요청하세요.

공개 화면에서도 영상 오른쪽 위의 전체 화면 전환을 사용할 수 있습니다. 채팅 보기는 기본 화면과 PC 전체 화면에서 사용할 수 있으며, 모바일 전체 화면에서는 채팅창과 버튼을 항상 숨깁니다. 테마 변경은 기본 화면 상단에서 가능합니다. 임시로 바꾼 보기 상태는 원본 공유 설정을 바꾸지 않으며 새로고침하면 공유 당시 기본 화면 모드로 돌아갑니다. 방문자 자신의 로컬 화면 설정보다 공유 설정을 우선합니다.

휴대폰에서 편하게 사용하기

모바일 기본 아바타 영역과 모바일 카드 미리보기는 세로 9:16 비율입니다. 전체 화면 모드에서는 실제 브라우저의 가용 높이를 사용하며 영상 비율은 유지합니다. 가로 추천 질문이 많으면 글자를 작게 줄이거나 개행하지 않고 한 줄을 유지합니다. 손가락을 추천 질문 위에 놓고 좌우로 밀어 나머지 항목을 확인하세요. 가장자리의 옅은 표시가 더 볼 내용이 있음을 알려 줍니다. 응답 카드는 아바타의 조작 영역 사이를 채우며, 그동안에도 아바타 음성은 들립니다.

왼쪽·오른쪽 세로 정렬로 설정한 추천 질문은 세로 목록을 유지합니다. 추천 질문은 최대 5개이며, 넘겨 보는 동작으로 질문이 전송되지는 않습니다.

현재 마이크 확인·다른 마이크로 변경

1. 영상 아래의 마이크 아이콘·파형을 누릅니다.

   전체 화면에서는 영상 위 하단 중앙에 있습니다. 현재 사용 중인 마이크에서 연결된 장치 이름과 음소거 상태를 확인합니다.

2. 사용할 마이크에서 원하는 장치를 선택합니다.

   대화 중에는 선택 즉시 입력을 바꿉니다. 아바타 연결과 대화 기록은 유지되며, 변경 실패 시 기존 마이크를 계속 사용합니다. 연결이 끊긴 장치는 안내를 확인하고 다른 장치를 선택하세요.

3. 마이크 끄기/켜기로 목소리 전송을 바꿉니다.

   누르는 동안만 말하기 모드에서는 이 버튼 대신 안내가 표시됩니다. 창을 닫고 기존 말하기 버튼을 누르세요. 장치를 바꿔도 누르고 말하기와 음소거 상태는 유지됩니다.

대화 시작 전에도 마이크를 선택할 수 있습니다. 이름이 보이지 않으면 마이크 허용하고 목록 보기를 누르세요. 권한 확인만으로 아바타 대화가 시작되지는 않습니다. 선택은 이 브라우저에만 저장되며 공유 링크를 받는 방문자는 자신의 마이크를 사용합니다.

장치를 연결한 뒤 목록이 바뀌지 않으면 마이크 목록 새로고침을 누르세요. 브라우저가 제공하는 장치만 선택할 수 있으며, 모바일에서 이어폰 등 특정 장치가 보이지 않으면 기기의 사운드 설정을 이용합니다. 파형은 입력 상태 표시이며 감도 조절 슬라이더가 아닙니다.

마이크 권한이 차단된 경우

권한을 바꾼 뒤 마이크 확인 후 대화 시작으로 다시 시도합니다. 브라우저의 보안 기능 전체를 끄는 작업은 필요하지 않습니다.

설정대로 동작하지 않을 때

공개하기 전 최종 확인

• 각 설정 메뉴에서 저장하고 적용을 완료했습니다.
• PC·모바일 미리보기에서 제목·추천 질문·카드를 확인했습니다.
• 카드 조건을 예시 문장으로 확인하고 실제 음성 질문도 해 봤습니다.
• 지원할 언어의 카드·호출 표현·음성 자료를 작성했습니다.
• 이미지·음악·동영상 결과는 채팅창에서 확인할 수 있습니다.
• 배포된 HTTPS 주소에서 공개 링크를 복사했습니다.
• 검증을 마친 대화는 대화 종료로 닫았습니다.

배포와 매뉴얼 경로

일반 사용자는 이 절의 서버 설정을 입력할 필요가 없습니다. 운영자는 저장소의 README와 render.yaml을 기준으로 배포합니다. 다음은 이 배포본에 준비된 값입니다.

아바타 영상 전달에는 외부 서비스를 이용하므로 이 프로젝트용 LiveKit 서버를 별도로 띄우지 않습니다. 자동 확장에서는 공유 설정을 인스턴스의 로컬 디스크에 두지 않습니다. 아바타 썸네일과 이 매뉴얼은 배포 정적 파일에 포함됩니다.

기본 접속 보호 한도는 인스턴스당 활성·시작 중 20개, 동시 생성 중 4개, 전체 100개입니다. 이는 보장 처리량이 아닙니다. 실제 배포에서 지연·오류·자원과 외부 서비스 한도를 관찰해 조정하세요. 재배포나 축소로 종료되는 서버의 진행 중 대화는 자동으로 다른 서버로 옮겨지지 않으며 사용자가 다시 시작해야 합니다.

매뉴얼 수정·배포 방법

원본 위치는 web/public/docs/입니다. index.html은 본문, manual.css는 스타일, manual.js는 목차·이미지 확대, images/는 실제 화면 캡처입니다. 수정 후 웹 빌드를 실행하면 web/dist/docs/에 포함됩니다. 서버가 /docs를 이 문서로 연결하므로 별도 문서 서버는 필요하지 않습니다.

배포 후 /docs를 직접 열어 목차·이미지·모바일 표시를 확인하세요. 서비스 화면은 다국어를 지원하지만 이 매뉴얼은 한국어 문서입니다.