챗봇 문서 관리(업로드 + 라이브러리)

빠른 설정

PDF를 업로드하고 라이브러리를 관리하는 데 약 5분이면 충분합니다. 업로드가 끝날 때까지 페이지를 열어 두세요.

이 가이드는 PDF 업로드, 웹사이트 소스 가져오기, 문서 라이브러리 관리 방법을 설명합니다. AVA는 먼저 파일을 검사한 뒤 브라우저가 파일을 S3로 직접 보냅니다. 또한 답변 엔진이 **Agent (Pi)**일 때 Agent Wiki 충돌을 검토하고 실패한 업데이트를 다시 시도하는 방법도 설명합니다. 답변 엔진이 **Agent (Pi)**이면 Agent Wiki 상태 열과 Conflicts 탭도 표시됩니다. 문서, 수집 또는 충돌 업데이트가 처리되는 동안 AVA가 목록을 자동으로 새로고침합니다. 터미널 업데이트가 완료되면 최종 상태가 표시될 때까지 AVA가 문서 행을 계속 새로고침합니다.

RAG에서는 Agent Wiki 컨트롤이 숨겨짐

챗봇 답변 엔진이 RAG이면 문서 라이브러리만 표시됩니다. Agent Wiki 열, Conflicts 탭, 경고 배너, 해결 작업 공간은 숨겨진 상태로 유지됩니다. 위키 업데이트를 검토하려면 **Agent (Pi)**로 전환하세요.

이동: Chatbot → Documents

---

빠른 참고

작업	클릭 위치	결과
업로드 시작	Upload Document	업로드 흐름이 열립니다
파일 선택	파일 선택기	Streamliner가 PDF를 먼저 확인합니다
파일 전송	브라우저 업로드 단계	PDF가 S3로 직접 전송됩니다
목적 추가(선택 사항)	Purpose 단계	직원이 문서가 왜 필요한지 볼 수 있습니다
업로드 완료	Finish	문서가 생성되고 대기열에 들어갑니다
페이지 유지	같은 브라우저 탭	업로드와 최종 처리가 중단되지 않습니다
처리 대기	목록의 자동 새로고침	수동 새로고침 없이 상태가 업데이트됩니다
위키 업데이트 추적	상단 진행 패널	Agent (Pi) 모드에서만 표시됩니다
Agent Wiki 동기화 검토	Agent Wiki 열	Agent (Pi) 모드에서만 표시됩니다
충돌 검토	Conflicts 탭 또는 경고 배너	Agent (Pi) 모드에서만 표시됩니다
충돌 해결 적용	준비된 충돌 작업	Agent (Pi) 모드에서만 표시됩니다
실패한 업데이트 재시도	Retry ingestion 또는 Retry wiki update	Agent (Pi) 모드에서만 표시됩니다
수집 오류 검토	상태 배지 또는 행 메시지	문서가 끝까지 처리되지 않은 이유를 확인합니다
문서 검색	Search 바 + Enter	목록이 키워드로 필터링됩니다
상태로 필터링	Status 드롭다운	Active 또는 Inactive만 표시됩니다
활성화 또는 비활성화	Enable / Disable 작업	AVA가 수집 작업을 완료한 뒤 상태가 업데이트됩니다
문서 삭제	Delete 또는 Delete (n)	확인 후 파일이 삭제됩니다

문서 지식 재생성

Agent Wiki는 처음에 기존 속성에 하나의 공유 지식 레이아웃을 사용합니다. 재생성하면 활성 소스가 별도의 문서 번들로 변경됩니다.

재생성하기 전에

재생성이 성공적으로 완료될 때까지 현재 지식은 계속 활성 상태입니다. AVA가 소스를 처리하는 동안 페이지를 열어 두세요.

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

2. Sources 탭에서 Regenerate knowledge를 클릭합니다.

   ✓ AVA에 Agent Wiki 진행 패널이 표시됩니다.

3. 패널에 Agent Wiki is up to date가 표시될 때까지 기다립니다.

   ✓ 재생성이 성공하면 AI Usage 탭이 표시됩니다.

재생성되지 않은 속성은 기존의 공유 소스 동작을 유지합니다. 마이그레이션 후 일반 업로드와 소스 업데이트에는 별도 번들 레이아웃이 유지됩니다.

재생성이 아직 실행 중임

보이는 현상: 진행 패널에 단계 또는 백분율이 표시됩니다.

해결:

1. Chatbot → Documents 페이지를 열어 둡니다.
2. 패널이 완료 상태에 도달할 때까지 기다립니다.
3. 재생성이 실행 중일 때 다른 재생성을 시작하지 마세요.

재생성 복구가 필요함

보이는 현상: 페이지에 Document knowledge needs recovery가 표시됩니다.

해결:

1. 진행 패널과 소스 오류가 있는지 검토합니다.
2. Retry knowledge generation을 클릭합니다.
3. 패널이 완료될 때까지 기다립니다.
4. AI Usage를 사용할 수 있게 되면 엽니다.

웹사이트 소스 가져오기

공개 웹사이트 사이트맵 하나를 Agent Wiki 소스로 추가할 수 있습니다. https://example.com/sitemap_index.xml처럼 .xml로 끝나는 HTTPS 사이트맵 URL을 사용하세요.

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

2. Upload Document를 클릭합니다.

3. Import website sitemap for Agent Wiki를 선택합니다.

4. 공개 사이트맵 URL을 입력합니다.

5. Continue를 클릭합니다.

6. 목적을 선택적으로 추가한 다음 Continue를 클릭합니다.

7. 사이트맵을 검토하고 Finish를 클릭합니다.

   ✓ 웹사이트 소스가 Sources에 표시되고 처리 대기 상태가 됩니다.

AVA는 웹사이트 항목에 Website sitemap source라는 라벨을 지정합니다. 행에서 Refresh Website Content를 사용해 기존 웹사이트 소스를 새로고침할 수 있습니다.

AI 기능 액세스 설정

AI Usage에서 각 활성 소스를 사용할 수 있는 AI 기능을 선택합니다. 각 소스는 자체 선택 항목을 유지합니다.

기능	소스를 사용하는 용도
AI Chatbot	게스트 채팅 답변
AI Phone	전화 대화
AI Video	영상 통화 지원
Staff Assist	팀 지원
Email Autodraft	답변 초안

1. AI Usage 탭을 엽니다.

2. PDF 또는 웹사이트 소스를 찾습니다.

3. 허용할 AI 기능을 선택하거나 선택 해제합니다.

4. 하나 이상의 기능은 선택된 상태로 둡니다.

5. Save changes를 클릭합니다.

   ✓ 행에 All changes saved가 표시됩니다.

Sources에서 소스를 비활성화하면 모든 AI 기능에서 해당 소스에 대한 액세스가 제거됩니다. 기능 액세스를 다시 할당하기 전에 소스를 다시 활성화하세요. 변경 사항을 저장한 후 답변을 테스트하기 전에 지식 처리가 완료될 때까지 기다립니다.

요금제 액세스

• 챗봇 문서 도구를 사용하려면 유료 플랜이 필요합니다.
• 무료 요금제 계정에는 문서 라이브러리 대신 업그레이드 안내가 표시됩니다.

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

시작 전 확인

다음 요구사항을 확인하세요.

• 챗봇 문서를 관리할 권한이 있습니다
• 파일이 1KB~6MB 사이의 PDF입니다
• Streamliner에 로그인되어 있습니다
• 업로드와 최종 처리가 끝날 때까지 탭을 열어 둡니다

문서 업로드

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

2. Upload Document를 클릭합니다.

   ✓ 업로드 흐름이 열립니다.

3. PDF를 선택합니다.

   ✓ Streamliner가 파일을 검사하고 업로드를 준비합니다.

4. 브라우저 업로드 단계를 완료합니다.

   ✓ PDF가 S3로 직접 업로드됩니다.

5. (선택 사항) 짧은 목적을 추가한 뒤 Continue를 클릭합니다.

   ✓ 목적이 문서와 함께 저장됩니다.

6. 요약을 검토한 뒤 Finish를 클릭합니다.

   ✓ 문서 라이브러리로 돌아갑니다.

탭을 열어 두세요

업로드 또는 최종 처리가 실행되는 동안 탭을 닫거나 새로고침하거나 다른 페이지로 이동하지 마세요. 탭이 닫히면 Chatbot → Documents에서 새 업로드를 시작하세요.

다음 단계

문서는 처리 상태로 들어갑니다. 파일 인덱싱이 완료될 때까지 목록이 계속 업데이트를 확인합니다.

문서 상태 배지 이해하기

상태	의미
Processing	문서가 인덱싱 중이며 아직 준비되지 않았습니다
Failed	백그라운드 처리 작업을 시작하거나 완료하지 못했습니다
Deleting	문서가 삭제 대기열에 있습니다
Active	범위가 허용하는 경우 챗봇이 이 문서를 참조할 수 있습니다
Inactive	문서는 라이브러리에 남아 있지만 사용되지 않습니다

상태 업데이트 안내

새로 업로드한 문서는 잠시 Processing 상태로 남아 있을 수 있습니다. 상태가 바뀔 때까지 페이지가 목록을 자동으로 업데이트합니다. 처리가 실패하면 새 업로드로 재시도할 때까지 최신 오류가 계속 표시됩니다.

Agent Wiki 상태 이해하기

상태	의미
Queued	AVA가 문서를 Agent Wiki로 보냈고 시작을 기다리고 있습니다
Processing	Agent Wiki가 지금 문서를 인덱싱하고 있습니다
Ready	소비자 범위가 허용하는 경우 Agent Wiki가 이 문서를 사용할 수 있습니다
Failed	수집이 완료되지 않았습니다
Deactivating	Agent Wiki가 이 문서를 비활성화하는 중입니다
Inactive	Agent Wiki가 이 문서를 사용하지 않습니다
Not synced	Agent Wiki 수집이 아직 시작되지 않았습니다

Agent Wiki 상태 안내

답변 엔진이 **Agent (Pi)**일 때만 이 열이 표시됩니다. 문서를 비활성화하면 Inactive 전에 Deactivating이 표시될 수 있습니다. 상태가 Queued, Processing, Deactivating인 동안에는 페이지가 계속 새로고침됩니다. 실행이 터미널 상태에 도달하면 AVA가 최종 상태가 표시될 때까지 문서 행을 새로고침합니다. 업데이트가 실패하고 Retry ingestion이 표시되면 이를 사용해 작업을 다시 시작하세요. Inactive는 AVA가 Agent Wiki 업데이트를 완료한 뒤에만 표시됩니다. 재시도 횟수가 모두 소진되면 행에 Failed가 표시될 수 있습니다.

AI 문서 범위 이해하기

일부 속성은 AI 문서 범위를 사용해 각 AI 기능이 사용할 수 있는 문서를 제어합니다. 범위는 Chatbot Agent, Phone AI, Video Call, Staff Assist, Email Autodraft에 사용할 문서를 제한할 수 있습니다.

Active 또는 Ready 상태는 문서 처리가 완료되었음을 나타냅니다. 모든 AI 기능에 대한 액세스가 확인된 것은 아닙니다.

범위를 재생성하지 않은 속성은 이전의 범위가 지정되지 않은 동작을 유지합니다. 허용 문서를 변경한 후 소스를 저장하고 답변을 테스트하기 전에 처리가 완료될 때까지 기다립니다.

Agent Wiki 충돌 검토

페이지에 충돌 수가 표시되거나 Conflicts 탭이 나타날 때 사용하세요. Agent Wiki가 작업하는 동안 대기열은 실시간으로 유지됩니다.

1. Conflicts를 엽니다.

   ✓ 지식 검토 대기열이 열립니다.

   Sources에 경고 배너가 표시되면 대신 해당 배너를 클릭해도 됩니다.

2. 목록에서 충돌을 선택합니다.

3. Current wiki information과 New document information을 비교합니다.

4. 다음 해결 방법 중 하나를 선택합니다.

   • Keep current wiki information
   • Use information from the new document
   • Provide authoritative information
   • Ignore this conflict

5. Provide authoritative information을 선택했다면 정확한 대체 텍스트를 입력합니다.

6. 필요한 경우 충돌을 더 준비합니다.

7. Apply를 클릭합니다.

   ✓ AVA가 하단에 일괄 요약을 표시합니다. ✓ 무시한 충돌은 위키를 변경하지 않습니다.

8. Confirm and update wiki를 클릭합니다.

   ✓ AVA가 전체 일괄 항목에 대해 위키 업데이트 하나를 시작합니다. ✓ 탭 위에 진행 패널이 표시됩니다.

9. 진행 패널이 완료될 때까지 기다립니다.

   ✓ 해결된 충돌이 Resolved, Ignored 또는 Superseded로 이동합니다.

일괄 처리가 중요한 이유

한 번 제출하여 여러 충돌을 처리할 수 있습니다. AVA는 해당 일괄 항목에 대해 위키 업데이트 하나만 시작합니다.

문서 검색 및 필터링

1. Search 바에 키워드를 입력합니다.

2. Enter를 눌러 검색을 적용합니다.

3. Status 드롭다운에서 Active 또는 Inactive를 선택합니다.

4. 검색 바의 X를 클릭해 검색을 지웁니다.

   ✓ 전체 목록이 다시 표시됩니다.

문서 활성화 또는 비활성화

1. 목록에서 문서를 찾습니다.

2. Enable 또는 Disable를 클릭합니다.

3. 작업을 확인합니다.

   ✓ 표의 상태가 업데이트됩니다. AVA가 수집 작업이 완료될 때까지 계속 확인합니다. 잠시 Deactivating이 표시된 뒤 Inactive가 나타날 수 있습니다.

행이 계속 처리 중일 수 있는 이유

AVA는 이제 문서 상태를 업데이트하기 전에 최종 수집 결과를 기다립니다. 백그라운드 작업을 시작할 수 없으면 AVA가 문서를 Failed로 표시합니다.

문서 삭제

문서 1개 삭제

1. 문서 행에서 Delete를 클릭합니다.

2. 작업을 확인합니다.

   ✓ 문서가 목록에서 제거됩니다.

여러 문서 삭제

1. 왼쪽 체크박스로 문서를 선택합니다.

2. 요약 바에서 **Delete (n)**을 클릭합니다.

3. 작업을 확인합니다.

   ✓ 삭제 작업이 완료되면 목록이 새로고침됩니다.

문제 해결

PDF 파일만 허용됨

보이는 현상: PDF 전용 오류로 업로드가 실패합니다.

해결:

1. 파일을 PDF로 변환합니다.
2. 업로드를 다시 시도합니다.

파일 크기는 6MB를 넘을 수 없음

보이는 현상: 업로드가 중단되고 크기 경고가 표시됩니다.

해결:

1. PDF를 압축하거나 더 작은 파일로 나눕니다.
2. 파일을 하나씩 업로드합니다.

Finish 버튼이 계속 비활성화됨

보이는 현상: 3단계를 완료할 수 없습니다.

해결:

1. 브라우저 업로드 단계가 끝날 때까지 기다립니다.
2. 파일 링크가 없으면 PDF를 다시 선택해 업로드합니다.
3. Finish를 다시 시도합니다.

탭이 업로드 중에 닫힘

보이는 현상: 페이지를 닫거나 새로고침한 뒤 업로드가 라이브러리에 나타나지 않습니다.

해결:

1. Chatbot → Documents로 돌아갑니다.
2. 새 업로드를 시작합니다.
3. Finish가 끝날 때까지 탭을 열어 둡니다.

검색 결과가 없음

보이는 현상: 검색 후 표가 비어 있습니다.

해결:

1. X로 검색을 지웁니다.
2. 더 짧은 키워드를 입력한 뒤 Enter를 누릅니다.
3. 모든 문서를 보려면 Status 필터를 제거합니다.

문서가 Processing 상태에 머무름

보이는 현상: 상태가 오랫동안 Processing으로 유지됩니다.

해결:

1. 자동 새로고침이 실행될 때까지 몇 분 기다립니다.
2. 페이지를 한 번 새로고침합니다.
3. 30분이 지나도 바뀌지 않으면 지원팀에 문의합니다.

문서에 수집 오류가 표시됨

보이는 현상: 행에 오류 메시지가 표시되거나 Agent Wiki에 Failed가 보입니다.

해결:

1. 문서 행에 표시된 오류 메시지를 읽습니다.
2. 파일이 여전히 유효한 PDF이고 6MB 미만인지 확인합니다.
3. 수정한 문서를 다시 업로드합니다.
4. 같은 오류가 다시 나오면 지원팀에 문의합니다.

충돌 업데이트가 실패함

보이는 현상: 선택한 충돌에 Failed가 표시되거나 일괄 업데이트가 중단됩니다.

해결:

1. Retry wiki update를 클릭합니다.
2. 진행 패널이 다시 시작될 때까지 기다립니다.
3. 충돌을 다시 열고 최종 텍스트를 확인합니다.
4. 같은 오류가 다시 나오면 지원팀에 문의합니다.

충돌 업데이트 후 문서 행이 오래된 상태로 보임

보이는 현상: 충돌은 해결되었지만 소스 행이 아직 대기 중으로 보입니다.

해결:

1. 진행 패널이 터미널 상태에 도달할 때까지 페이지를 열어 둡니다.
2. 목록이 새로고침될 때까지 기다립니다.
3. 행이 여전히 오래된 상태로 보이면 페이지를 한 번 새로고침합니다.
4. 30분이 지나도 안정되지 않으면 지원팀에 문의합니다.

Agent Wiki 컨트롤이 표시되지 않음

보이는 현상: Agent Wiki 열, Conflicts 탭 또는 검토 배너가 보이지 않습니다.

해결:

1. 챗봇의 Answer Engine을 확인합니다.
2. RAG라면 Agent Wiki UI가 의도적으로 숨겨진 것입니다.
3. 위키 업데이트를 관리하려면 **Agent (Pi)**로 전환합니다.
4. 이미 **Agent (Pi)**가 선택되어 있다면 페이지를 새로고침하고 다시 시도합니다.

AI 기능 하나에서 활성 문서를 찾을 수 없음

보이는 현상: 한 AI 기능이 Active 또는 Ready로 표시된 문서를 사용하지 않습니다.

해결:

1. 문서에 Active와 Ready가 표시되는지 확인합니다.
2. 해당 문서가 영향을 받는 AI 기능에 허용되어 있는지 확인합니다.
3. AI Usage에서 소스 변경 사항을 저장합니다.
4. 처리가 완료된 후 AI 기능을 다시 테스트합니다.
5. 문서를 계속 사용할 수 없으면 지원팀에 문의합니다.

AI Usage 탭이 표시되지 않음

보이는 현상: Sources 옆에서 AI Usage를 찾을 수 없습니다.

해결:

1. 챗봇이 **Agent (Pi)**를 사용하는지 확인합니다.
2. 속성이 마이그레이션되지 않았다면 Regenerate knowledge를 클릭합니다.
3. Agent Wiki is up to date가 표시될 때까지 기다립니다.
4. 재생성이 실패했다면 Retry knowledge generation을 클릭합니다.

모든 AI 기능을 선택 해제할 수 없음

보이는 현상: 마지막으로 선택된 기능의 선택을 해제할 수 없습니다.

해결:

1. 소스에 하나 이상의 기능을 선택된 상태로 둡니다.
2. Save changes를 클릭합니다.
3. 모든 곳에서 액세스를 제거하려면 Sources를 엽니다.
4. 해당 소스에서 Disable을 클릭합니다.

웹사이트 소스가 새로고침되지 않음

보이는 현상: Refresh Website Content 후에도 웹사이트 콘텐츠가 오래된 상태로 남아 있습니다.

해결:

1. 사이트맵 URL이 공개되어 있고 HTTPS를 사용하는지 확인합니다.
2. URL이 .xml로 끝나고 sitemap을 포함하는지 확인합니다.
3. Refresh Website Content를 다시 시작합니다.
4. 소스 및 Agent Wiki 상태가 완료될 때까지 기다립니다.
5. 소스에 계속 오류가 표시되면 지원팀에 문의합니다.

삭제가 실패하거나 아무 반응이 없음

보이는 현상: 삭제를 확인해도 문서가 남아 있습니다.

해결:

1. 페이지를 새로고침하고 상태 배지를 확인합니다.
2. 삭제를 다시 시도합니다.
3. 계속되면 지원팀에 문의합니다.

계속 해결되지 않나요?

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

• ❌ 여러 번 시도해도 업로드가 실패함
• ❌ 문서가 Processing에서 30분 이상 유지됨
• ❌ 다시 업로드해도 같은 수집 오류가 표시됨
• ❌ 새로고침 후에도 삭제가 완료되지 않음

함께 전달하면 좋은 정보:

• 파일 이름과 상태
• 문서 표 스크린샷
• 문제가 시작된 시각

관련 가이드

• 챗봇 설정
• 챗봇 위젯 스타일
• 게스트용 라이브 채팅 링크 만들기