Knowledge Base

AI 에이전트의 Knowledge Base를 만들고 관리하세요. 콘텐츠 추가, 정보 구조화, 정확한 AI 응답을 위한 최적화 방법을 알아보세요.

Knowledge Base는 Quickchat AI 에이전트의 핵심 구성 요소입니다. 에이전트가 기업, 제품, 서비스를 이해하는 토대이며, 체계적이고 충분한 지식 베이스는 사용자 질문을 효과적으로 처리하고 정확하게 답하는 데 도움이 됩니다.

이 가이드는 Knowledge Base의 개요, 효과적으로 구축하는 방법, 성능을 개선하는 팁을 설명합니다.

자주 변경되는 가격 및 도움말 페이지에는 URL 기반 문서와 유료 플랜의 일일 Auto-refresh를 사용하세요. 중요한 변경은 다음 일일 점검을 기다리지 말고 수동으로 새로고침하세요. Quickchat 계정 연결을 통해 ChatGPT 또는 Claude에 설정을 요청할 수 있습니다.

데이터 소스

Knowledge Base 페이지 상단의 도구 모음에서 다음 소스의 지식을 추가할 수 있습니다.

Add Article

제목과 서식 있는 본문으로 구성된 직접 작성 문서입니다. FAQ, 내부 정책, 제품 사양, 다른 문서에서 붙여 넣을 내용처럼 정확한 표현을 직접 관리할 때 사용하세요.

각 문서는 한 가지 주제에 집중하세요. 여러 주제를 다루는 긴 문서는 정보 검색을 어렵게 합니다. 문서를 나누면 AI가 더 명확한 답변을 제공할 수 있습니다.

Add Paragraph

전체 문서가 필요하지 않은 짧고 독립적인 사실입니다. 단락은 ‘Single Paragraphs’ 같은 폴더에 묶여 작은 지식 단위로 처리됩니다. “배송은 영업일 기준 3–5일이 걸립니다”, _“30일 이내 반품이 가능합니다”_와 같은 한 줄 정보에 적합합니다.

Add Website

URL에서 콘텐츠를 가져옵니다. 네 가지 가져오기 모드가 있습니다.

Single Page: 웹페이지 하나를 가져옵니다. 나머지 영역이 메뉴, 광고, 바닥글이라면 Advanced options → HTML selector를 사용하여 main, #article-body, .docs-content 같은 특정 영역만 가져오세요.
Multiple Pages: URL 목록을 붙여 넣으면 각각 별도의 문서가 됩니다.
Sitemap: sitemap.xml을 지정하면 사이트맵의 각 페이지를 별도 문서로 가져옵니다. 문서 사이트나 체계적인 블로그에 적합합니다.
All Pages: 도메인에서 접근할 수 있는 모든 URL을 사이트 전체에 걸쳐 수집합니다. 전체 문서나 기업 블로그를 가져올 때 사용하세요.

URL은 원본 소스와 연결된 상태로 유지되므로 자동 또는 필요할 때 업데이트할 수 있습니다. URL 문서를 최신 상태로 유지하기를 참고하세요.

공개 추출 검사(샘플 페이지 두 개)

계정을 만들거나 문서를 가져오기 전에 Quickchat의 추출 서비스가 어떤 내용을 반환하는지 보고 싶으신가요? 공개 추출 검사를 여세요. 이 실험적 검사는 가격 페이지와 영문 Knowledge Base 가이드라는 두 개의 샘플 페이지만 지원합니다. 질문에 이 정확한 URL 중 하나와 확인할 내용을 포함하세요. 로그인이나 계정 연결이 필요하지 않습니다.

결과에는 새로 추출한 텍스트, 확인 시각, 설정, 추출 실패 정보가 포함됩니다. 사용자 지정 선택자나 일반 가져오기 재시도 없이 기본 본문 필터로 한 번 추출합니다. 텍스트가 줄어들 수 있으므로 일부 발췌문에 내용이 없다고 해서 전체 추출에도 없었다고 판단할 수는 없습니다.

이 검사는 계정을 만들거나 문서를 가져오지 않으며, 가져오기 성공 여부나 향후 AI 응답을 검증하지 않습니다.

자동 새로고침

URL 기반 문서는 하루에 한 번 스스로 원본을 다시 가져올 수 있습니다. 별도로 작업하지 않아도 Knowledge Base가 소스 페이지를 따라갑니다.

사용하기 전에 다음 세 가지를 알아 두세요.

계정 전체가 아닌 문서별 설정입니다. 동기화할 문서마다 켜세요.
유료 플랜에서만 사용할 수 있습니다. Free에서는 위의 수동 새로고침을 사용하세요.
문서 내용을 직접 수정하면 해당 문서의 자동 새로고침이 꺼집니다. 다음 날 원본을 다시 가져오면서 수정 사항이 덮어써지는 것을 막기 위한 동작입니다. 직접 수정한 페이지는 다시 켤 때까지 원본을 따라가지 않습니다.

하루 간격을 변경할 수는 없습니다.

Upload File

PDF, Word, PowerPoint, Excel/CSV 등의 문서를 업로드하세요. 스캔한 이미지는 OCR로 처리합니다. 텍스트는 자동 추출되어 색인에 추가됩니다. 최대 파일 크기는 32 MB이며, txt, md, csv, json 같은 텍스트 파일은 1 MB입니다. 더 큰 텍스트 파일은 작은 부분으로 나누어 각각 업로드하세요.

Shopify MCP

Shopify 스토어를 연결하여 AI가 현재 제품 카탈로그, 제품 정보, 스토어 정책을 바탕으로 답하도록 하세요. 스토어 URL을 붙여 넣으면 연결을 설정할 수 있습니다. 내부적으로 Shopify MCP Custom Action이 구성되며, Actions & MCPs에서도 관리할 수 있습니다. Custom Actions와 주문 상태에 별도 액션이 필요한 이유를 참고하세요.

Intercom Articles

연결된 Intercom Help Center의 모든 문서를 일괄 가져옵니다. 먼저 External Apps → Intercom에서 Intercom을 연결해야 합니다. 가져오기를 다시 실행하면 새 문서와 변경된 문서가 동기화됩니다.

YouTube

YouTube URL을 붙여 넣으면 영상의 자막을 문서로 가져옵니다. 직접 다시 작성하고 싶지 않은 튜토리얼이나 제품 안내 영상에 유용합니다.

URL 문서를 최신 상태로 유지하기

URL 문서는 원본 페이지와 연결되어 있으므로 직접 다시 가져오지 않고 최신 상태로 유지할 수 있습니다. 매일 자동으로 실행되는 Auto-refresh와 필요할 때 직접 실행하는 수동 새로고침 두 가지 방법이 있습니다. 둘 다 문서 내용을 현재 웹페이지의 최신 버전으로 교체한 뒤 AI 에이전트를 자동 업데이트합니다.

소스 링크가 포함된 집중적인 참고 자료는 웹사이트 업데이트: 일일 새로고침, 새 페이지, 긴급 가격 변경을 확인하세요.

지식을 최신 상태로 유지하는 방법을 정하는 데 도움이 필요하신가요? Quickchat에 설정에 관해 질문하면 공개 문서 링크가 포함된 AI 답변을 받을 수 있습니다. 로그인이나 계정 연결은 필요하지 않습니다.

ChatGPT 또는 Claude로 업데이트 관리하기

소수의 변경되는 페이지에는 일일 새로고침을 켜고 중요한 변경이 공개될 때 수동으로 새로고침하는 방식이 가장 간단합니다. AI로 관리하기를 통해 계정을 연결하고 에이전트 이름과 소스 URL을 알려 주세요. 예를 들면 다음과 같습니다.

웹사이트 에이전트의 가격 및 도움말 페이지를 최신 상태로 유지하도록 도와주세요. 이 URL 중 어떤 것이 이미 Knowledge Base에 있는지 확인하고, 없는 페이지를 추가한 뒤 제 플랜이 지원하면 일일 자동 새로고침을 켜 주세요. 적용하기 전에 변경 제안을 보여 주세요.

연결을 통해 페이지 추가, 기존 URL 문서 새로고침, 자동 새로고침 관리를 할 수 있습니다. Quickchat 로그인을 사용하므로 개발자 API 키나 별도의 동기화 스크립트가 필요하지 않습니다. 자동 새로고침에는 유료 플랜이 필요합니다. 수동 URL 새로고침은 Free에서도 사용할 수 있습니다.

관리 절차는 간단하게 유지하세요.

먼저 원본 웹사이트를 업데이트하세요. 여러 문서에 가격이나 정책의 서로 다른 사본을 두지 마세요.
중요한 변경 후 연결된 AI 앱에 해당 URL 새로고침을 요청하고, 문서가 Ready인지 확인한 뒤 답변을 테스트하세요.
새로고침 실패와 답하지 못한 고객 질문을 정기적으로 검토하세요. 연결된 AI 앱에 최근 대화 검토를 요청한 뒤 어떤 지식을 개선할지 정할 수 있습니다.
새로 공개된 URL을 추가하고 폐기된 페이지는 따로 검토하세요. 일일 새로고침은 선택한 문서만 따라가며 사이트맵의 새 페이지를 자동 발견하지 않습니다. 문서를 직접 수정하면 자동 새로고침이 꺼집니다.

별도의 동기화 프로세스가 필요하다면 먼저 REST API 플랜 요구 사항을 확인하세요. 일일 새로고침은 실시간 조회가 아닙니다. 답변 시 실시간 시스템을 조회해야 한다면 Action을 사용하세요.

Auto-refresh

URL 문서의 Auto-refresh를 켜면 Quickchat이 하루에 한 번 원본을 확인하고 변경되었을 때 자동 업데이트합니다. 별도 작업 없이 URL 기반 지식을 동기화할 수 있습니다.

자동 URL 새로고침은 유료 플랜에서 사용할 수 있습니다.

켜는 방법

문서 하나: 문서를 열고 오른쪽 메타데이터 패널의 Auto-refresh를 켜거나, 목록의 문서 행에서 Auto-refresh URL을 사용하세요.
행 메뉴: URL 문서 행의 ’…’ 메뉴에서 Auto-refresh URL을 선택하세요.
일괄 적용: 확인란으로 여러 URL 문서를 선택한 뒤 선택 도구 모음의 Auto-refresh URLs (N)을 클릭하세요.

Auto-refresh가 켜져 있으면 문서는 원본과 동기화되고 내용은 읽기 전용이 됩니다. _“This article is in sync with its source. Turn off auto-refresh to edit.”_라는 안내가 표시됩니다. 직접 수정하려면 Turn off & edit를 클릭하거나 Auto-refresh를 끄세요. URL 문서를 수정하면 자동 새로고침이 꺼지므로 이후 업데이트가 수정 사항을 덮어쓰지 않습니다.

메타데이터 패널의 Last Refreshed에는 마지막으로 원본에서 업데이트한 시각이 표시됩니다.

새로고침에 실패하면 마지막으로 저장한 버전이 유지되고 에이전트가 계속 사용합니다. 상태, 원인, 재시도 방식은 URL 새로고침이 실패한 경우를 참고하세요.

수동 새로고침

일일 점검을 기다리지 않고 최신 내용을 즉시 가져오려면 다음과 같이 하세요.

문서 하나: 문서를 열고 메타데이터 패널의 Refresh URL Manually를 클릭하거나 행의 ’…’ 메뉴에서 Manually refresh URL을 선택하세요.
일괄 적용: URL 문서를 선택하고 Manually refresh URLs (N)을 클릭하세요. 오른쪽 위의 Refresh all URLs로 모든 URL 기반 문서를 한 번에 가져올 수도 있습니다.

수동 새로고침은 직접 수정한 내용을 현재 웹페이지로 교체합니다. 따라서 수정한 문서를 덮어쓰기 전에 Quickchat이 확인을 요청합니다. 일괄 새로고침은 한 번에 최대 1,000개 URL 문서를 처리합니다.

효과적인 Knowledge Base 구축 팁

업로드한 각 텍스트 문서, URL, PDF는 다른 자료 없이도 이해할 수 있고 주제를 충분히 다루어야 합니다. 잘 구성된 Knowledge Base는 에이전트가 효과적으로 답하는 데 필요한 맥락을 제공합니다.

다음 팁을 활용해 에이전트를 준비하세요.

Knowledge Base 구축 및 개선 단계

목적을 명확히 하세요
AI 에이전트의 역할과 답할 질문 유형을 정의하세요. 사용자 요구와 흐름에 따라 지식을 분류하세요.

전자상거래 AI 에이전트 예시:
- 탐색 및 쇼핑: 제품 정보, 비교, FAQ.
- 구매: 결제 수단, 할인 코드, 세금.
- 배송: 발송, 주문 변경, 배송 추적.
학자금 대출 AI 에이전트 예시:
- 신청 전: 자격 요건과 대출 조건.
- 신청 중: 안내, 약관, 단계별 설명.
- 졸업 후: 상환 일정과 유예.
데이터 품질을 확보하세요
AI 응답의 품질은 업로드한 데이터에 달려 있습니다. 다음을 확인하세요.
- 가독성: 관련 없는 정보, 표, 불필요한 제목을 제거하세요.
- 관련성: 자주 묻는 질문에 답하고 사용자의 기대에 맞는 내용인지 확인하세요.
- 일관성: 서로 모순되거나 오래된 정보를 피하고 날짜, 가격 등의 형식을 통일하세요.
- 텍스트 중심: 이미지를 지원하지 않으므로 중요한 정보를 텍스트로 전달하세요.
명확성을 우선하세요
각 문서를 명확하고 간결하며 따라가기 쉽게 작성하세요. 논리적인 단락 구조를 사용하고 관련 세부 사항에 집중하세요.
충분히 설명하세요
복잡한 질문도 처리할 수 있도록 가능한 한 상세한 지식을 제공하세요.
질문과 답변 쌍보다 충분한 정보를 제공하세요
특정 질문과 답변만 나열하기보다 포괄적인 정보를 제공하세요. 에이전트가 필요에 따라 관련 내용을 찾아낼 수 있습니다.
본문에 URL을 포함하세요
참고할 URL을 항상 본문에 넣으세요. URL 가져오기를 사용하더라도 본문에 제품이나 양식 링크를 포함하면 더 유용합니다.

예시:
전자상거래 에이전트에는 주문 취소와 같은 양식 링크를 포함하세요.
”주문을 취소하려면 여기에서 요청하세요: https://example.com/cancel-order.”
충분히 테스트하세요
테스트는 Knowledge Base 개선에 필수입니다. 사용자 상호작용을 시뮬레이션하여 누락이나 불일치를 찾고 내용을 조정하세요.

자주 발생하는 문제

에이전트가 링크를 건너뛰거나 답변에 URL을 포함하지 않음 각 문서 본문에 관련 링크가 들어 있는지 확인하세요.
반복되거나 불필요한 정보 여러 문서에 같은 콘텐츠를 중복 업로드하지 마세요.
답변에 중요한 세부 정보가 빠짐 조건이나 예외 사항처럼 구체적인 내용은 별도 문서로 만드는 것을 고려하세요.
잘못된 날짜나 가격 모든 문서를 확인하고 업데이트하여 정확성을 유지하세요.

효과적인 Knowledge Base 구축은 반복적인 개선 과정입니다. 명확한 목표로 시작하고 내용을 논리적으로 구성하며 충분한 테스트로 에이전트 성능을 다듬으세요.

Knowledge Base 설정이나 맞춤 연동에 도움이 필요하면 contact@quickchat.ai로 문의해 주세요.

검색

Search는 문서의 제목과 본문을 모두 검색하여 특정 문서를 빠르게 찾도록 합니다.

검색 사용 방법

지식 관리 화면 상단의 Search 입력란에 키워드나 문구를 입력하세요.
제목이나 본문에 입력한 텍스트가 있는 문서로 결과가 즉시 업데이트됩니다.

다중 선택 및 일괄 삭제

다중 선택과 일괄 삭제로 Knowledge Base의 여러 문서를 쉽게 관리할 수 있습니다.

다중 선택 방법

Knowledge Base 목록으로 이동하세요.
선택할 문서 옆의 ’…’를 클릭하고 ‘Select’를 선택하세요.
원하는 문서 왼쪽의 확인란을 선택하세요. 하나 또는 여러 문서를 동시에 선택할 수 있습니다.
선택된 문서는 후속 작업을 위해 강조 표시됩니다.

일괄 삭제 방법

다중 선택으로 문서를 고른 뒤 하단의 Delete를 클릭하세요.
작업을 확인하면 선택한 문서가 모두 영구 삭제됩니다.

변경 사항이 적용되는 방식

별도의 재학습 단계나 누를 버튼은 없습니다. Knowledge Base의 모든 변경은 백그라운드에서 문서 하나씩 자동 처리됩니다. 실제로 변경한 문서만 다시 처리하므로 나머지 지식 베이스는 계속 질문에 답할 수 있습니다.

문서 추가, 수정, 삭제, 웹사이트나 파일 가져오기, 수동 URL 새로고침, 일일 자동 새로고침 등 모든 콘텐츠 변경에 적용됩니다.

문서 상태

Knowledge Base 목록의 각 행에는 Status 열이 있습니다.

상태	의미
Pending	대기열에서 처리를 기다립니다.
Processing	현재 처리 중입니다.
Ready	활성 상태입니다. 에이전트가 이 문서를 사용합니다.
Failed	처리가 완료되지 않았습니다. 문서 처리가 실패한 경우를 참고하세요.
Refresh failed	URL 업데이트가 실패했습니다. 에이전트는 마지막 저장 버전을 계속 사용합니다.

상태는 자동 업데이트되므로 페이지를 다시 불러올 필요가 없습니다.

처리 중인 문서가 있으면 앱 상단에 “N articles still processing”이 표시되며 모두 끝나면 사라집니다. 대부분의 문서는 몇 초 안에 Ready가 됩니다. 대량 가져오기는 문서를 묶음으로 처리하므로 더 오래 걸립니다.

문서가 활성화되는 시점

문서가 Ready가 되는 즉시 배포된 위젯, 모든 연결 채널, API, AI Preview에서 동시에 사용됩니다. 별도의 공개나 배포 단계는 없으며 사용자와 에이전트 사이에 대기하는 지식 베이스 초안도 없습니다.

별도의 준비 단계가 없으므로 편집 내용은 처리가 끝나는 즉시 운영 중인 에이전트에 반영됩니다. 실제 서비스 중이라면 저장 전에 내용을 검토하고 이후 시뮬레이션 데이터셋을 다시 실행하여 성능 저하가 없는지 확인하세요.

URL 새로고침이 실패한 경우

Refresh failed인 URL 문서는 Quickchat이 마지막으로 저장한 버전으로 계속 사용됩니다. 상태에 마우스를 올리면 페이지 접근 불가, 로그인 필요, 다른 사이트로의 리디렉션, 읽을 수 없는 콘텐츠 등 업데이트 실패 원인을 볼 수 있습니다.

Quickchat은 일시적인 실패를 계속 재시도합니다. 14일 동안의 새로고침 시도에서도 계속 실패하면 영구적으로 접근 불가능한 페이지를 반복 조회하지 않도록 자동 점검을 중단합니다. 원본을 수정한 뒤 Manually refresh URL을 선택하세요. 새로고침에 성공하면 오류가 해제되고 자동 점검이 재개됩니다. Auto-refresh URL을 다시 선택하여 재시도 기간을 다시 시작할 수도 있습니다.

문서 처리가 실패한 경우

Failed 문서는 에이전트가 사용하지 않습니다. 나머지 Knowledge Base에는 영향이 없으며 에이전트는 Ready인 모든 문서를 사용해 계속 답합니다.

대부분의 실패는 일시적이고 Quickchat이 자동으로 재시도하므로 보통 자연스럽게 해결됩니다. 기다리지 않으려면 앱 상단의 “N failed to process” 옆 Retry를 클릭하여 실패한 문서를 즉시 모두 재시도하세요.

계속 실패한다면 빈 페이지, 추출할 텍스트가 없는 파일, 더 이상 연결되지 않는 URL 같은 원본 문제가 일반적인 원인입니다. 문서를 열어 실제로 가져온 내용을 확인하거나 정상 소스에서 다시 가져오세요. 계속 실패하면 contact@quickchat.ai로 문의하세요.

나머지 설정은 즉시 적용됩니다

처리를 거치는 것은 Knowledge Base 콘텐츠뿐입니다. Identity, AI Personality, Languages, Actions, Inbox 답변, Insights, Conversation Rating 같은 설정은 저장하는 즉시 적용됩니다.

마지막 업데이트: 2026. 10. 29.