지식 관리 화면은 에이전트가 답변에 쓰는 지식을 등록하고 관리하는 곳입니다. 사이트 주소를 등록하면 페이지를 읽어 지식으로 쌓고, 방문자 질문이 오면 그 지식에서 답을 찾습니다. 지식이 답변에 어떻게 쓰이는지는 지식과 답변에서 다룹니다.
사이드바 "지식 관리"(/knowledge) 메뉴를 열면 이 화면이 표시됩니다. 멤버십이 있고 뷰어 이상 역할이면 열 수 있고, 등록·수정·삭제는 편집자 이상 계정에서 할 수 있습니다.
화면 구성
화면 위에 탭 세 개가 있고, "지식 목록" 탭에는 요약 카드와 소스 표가 표시됩니다.
- "지식 목록"(
/knowledge): 등록한 소스와 상태 - "검색 확인"(
/knowledge/search): 질문을 넣어 지식이 검색되는지 확인 - "상품"(
/knowledge/products): 수집 중 정리된 상품 정보 - 요약 카드: "등록 소스" 수와 "적재 지식"("지식 조각 {count}개")
- "새 지식 추가" 버튼: 편집자 이상 계정에만 표시
지식 목록
소스 표의 컬럼은 "소스", "종류", "상태", "적재량", "최근 수집"입니다. 종류는 "URL"과 "사이트" 두 가지입니다. 등록된 지식이 없으면 "아직 등록된 지식이 없습니다"와 "사이트 진단으로 시작" 버튼이 표시됩니다.
| 상태 배지 | 설명 |
|---|---|
| "대기" | 등록만 되고 아직 수집하지 않은 상태 |
| "수집 중" | 페이지를 읽는 중. 가장 최근에 시작한 작업 한 건에만 진행률 막대가 표시됩니다 |
| "준비됨" | 수집이 끝나 답변에 쓰이는 상태 |
| "실패" | 수집이 끝까지 가지 못했고 쌓인 지식도 없는 상태 |
| "최신화 실패 · 이전 수집분으로 답변 중" | 다시 수집하다 실패했지만 이전에 쌓아 둔 지식은 그대로 답변에 쓰이는 상태 |
마지막 배지가 붙은 소스는 삭제하지 않습니다. 툴팁대로 "기존에 수집된 지식은 유지되어 상담에 계속 사용됩니다. 최신 내용 반영만 실패했습니다."
목록이 200건을 넘으면 "최근 {shown}건만 표시합니다 (전체 {total}건)"이 표시됩니다.
지식 등록
"새 지식 추가"를 누르면 두 단계로 진행됩니다.
1단계: 사이트 SEO 진단
"내 사이트 주소"에 https 주소를 넣고 "진단 실행"을 누르면 SEO 점수와 지적 항목이 표시됩니다. 진단은 참고 정보이며, 이 결과와 무관하게 수집을 시도할 수 있습니다.
| 결과 | 1차 버튼 | 함께 표시되는 것 |
|---|---|---|
| 사이트를 읽었고 점수가 50점 초과 | "이 사이트로 계속" | 없음 |
| 사이트를 읽었고 점수가 50점 이하 | "이 사이트로 계속" | "SEO·GEO 개선 문의" 보조 버튼 |
| 사이트를 읽지 못함 | "SEO·GEO 개선 문의" | "그래도 등록해 보기" |
진단을 건너뛰려면 아래의 "건너뛰고 직접 등록"을 누릅니다.
2단계: 지식 추가 방식 선택
| 방식 | 용도 | 한도 |
|---|---|---|
| "🌐 사이트 전체 수집" | 사이트를 통째로 읽힐 때 | "최대 1,000페이지 · 최대 15분 (한도에 먼저 닿는 쪽에서 종료)" |
| "🔗 URL 단건" | 페이지 하나만 즉시 읽힐 때 | "페이지당 400KiB까지 수집됩니다" |
| "✏️ 텍스트 직접 입력" | 정책·안내문을 직접 붙여넣을 때 | 최대 400KB |
사이트와 URL 방식에서는 "등록 후 바로 수집"이 기본으로 켜져 있습니다. 끄면 버튼이 "등록만 하기"로 바뀌고 소스는 "대기" 상태로 목록에 남습니다. 두 방식 모두 "오늘 수집 횟수가 차감되며 실패해도 차감됩니다."
같은 주소는 두 번 등록할 수 없습니다. 이미 등록된 주소를 넣으면 "이미 등록된 주소입니다. 목록에서 해당 소스를 재수집해 주세요"가 표시됩니다. 같은 내용을 두 번 쌓으면 검색 결과를 그 소스가 독차지하기 때문입니다.
텍스트로 직접 입력한 지식은 목록에 표시되지 않고, 등록한 뒤 수정하거나 삭제할 수 없습니다. 등록하려면 "등록 후 수정·삭제가 불가능함을 확인했습니다" 체크박스를 켜야 합니다. 바뀔 수 있는 내용은 사이트 수집으로 등록합니다.
소스 관리
목록에서 행을 누르면 소스 상세(/knowledge/{소스})가 열립니다. 위에 제목·종류·상태 배지, 주소, "지식 조각 {count}개"와 "최근 수집 {date}"가 표시됩니다.
수집 진행
수집 중이면 "수집 진행" 카드가 진행률과 "{done} / {total} 페이지", "예상 잔여 약 {eta}"를 표시합니다. 단계는 "페이지 수집", "저장", "상품 정리" 순으로 진행됩니다. 앞선 작업이 있으면 "수집 대기 중"으로 표시되고, 안내대로 "동시에 1건씩 처리됩니다".
다른 기기에서 시작한 수집은 진행률이 표시되지 않고 "수집이 진행 중입니다. 이 기기에서 시작한 작업이 아니라 상세 진행률은 표시할 수 없습니다"만 표시됩니다. 완료 여부는 상태 배지로 확인합니다. 실패한 소스에는 "실패 원인"이 함께 표시됩니다.
관리 버튼
편집자 이상 계정에만 "관리" 영역이 표시됩니다.
| 버튼 | 표시 조건 | 확인 문구 |
|---|---|---|
| "URL 수정" | 수집 중이 아닐 때 | 없음. 저장하면 소스가 "대기"로 돌아갑니다 |
| "수집 실행" | 상태가 "대기"나 "실패"일 때 | 없음 |
| "수집 취소" | 수집 중일 때 | "수집을 취소할까요?" "진행 중인 수집이 중단됩니다." 이전에 쌓인 지식이 있으면 "기존에 수집된 지식은 유지됩니다."가 덧붙습니다 |
| "재수집" | 상태가 "준비됨"일 때 | "다시 수집할까요?" "사이트를 처음부터 다시 수집하고, 완료되면 기존 지식이 새 수집분으로 교체됩니다. 오늘 수집 횟수가 차감됩니다 (실패해도 차감)." |
| "소스 삭제" | 수집 중이 아닐 때 | "소스를 삭제할까요?" "이 소스와 적재된 지식 조각 {count}개가 모두 삭제됩니다. 복구할 수 없습니다." |
재수집이 끝나기 전까지는 이전 지식으로 계속 답합니다. 완료되는 순간 한꺼번에 교체되므로 수집 중에 답변이 비는 구간은 없습니다.
오늘 수집 횟수를 다 쓰면 "오늘 수집 가능 횟수를 모두 사용했습니다. 내일 다시 시도해 주세요"가 표시됩니다.
검색 확인
"검색 확인" 탭에 방문자가 물을 법한 질문을 넣고 "검색"을 누르면 지식에서 찾은 내용이 최대 5건 표시됩니다.
수집 직후 답변이 기대와 다를 때 이 탭에서 먼저 확인합니다. 결과가 비면 "관련 지식을 찾지 못했습니다. 지식을 더 등록해 보세요"가 표시되고, 그 내용이 사이트에 없거나 아직 수집되지 않았다는 뜻입니다.
상품
"상품" 탭에는 사이트 수집 중 정리된 상품이 카드로 표시됩니다. 한 페이지에 24건이고 위에 "전체 {count}건"이 표시됩니다. 카드에는 상품명, 브랜드, 가격이 있고 "원본 보기"로 사이트의 상품 페이지가 새 탭에서 열립니다.
상품이 없는 업종이라면 비어 있는 것이 정상입니다. 빈 화면의 문구도 그렇게 안내합니다.