문서 작성 가이드

잘 구조화된 문서는 챗봇의 답변 품질을 크게 높입니다. 이 가이드는 faq.guide에 최적화된 문서를 작성하는 방법을 설명합니다.

왜 문서 구조가 중요한가요?

업로드된 문서는 AI가 "청크"라는 작은 단위로 분리하여 처리합니다.

문서 품질 → 청크 품질 → 검색 정확도 → 답변 품질

잘 구조화된 문서는 높은 품질 점수를 받아 자동 승인되고, 사용자 질문과 더 정확하게 매칭됩니다.

Q&A 형식 활용 (권장)

Q&A 형식은 가장 높은 품질 점수를 받습니다. 시스템이 각 Q&A 쌍을 독립적인 청크로 추출합니다.

Q: 배송은 얼마나 걸리나요?
A: 주문 후 영업일 기준 2-3일 내에 배송됩니다.
   도서산간 지역은 1-2일 추가 소요될 수 있습니다.

Q: 교환/반품은 어떻게 하나요?
A: 수령 후 7일 이내 고객센터로 연락하시면 됩니다.
   고객 변심의 경우 반품 배송비는 고객 부담입니다.

Q:와 A:는 항상 쌍으로 작성하세요. Q만 있고 A가 없으면 품질 점수가 크게 감점됩니다.

헤더로 구조화하기

Markdown 헤더(#, ##, ###)를 사용하면 품질 가산점을 받습니다.

# 제품 소개

## 주요 기능

### 스마트 센서
실시간 공기질을 측정하여 자동으로 풍량을 조절합니다.

### 3단계 필터
프리필터, 헤파필터, 탈취필터로 공기를 정화합니다.

적정 길이 지키기

| 길이 | 권장 여부 | |------|----------| | 100자 미만 | 비권장 — 문맥이 부족합니다 | | 100~500자 | 권장 — 최적의 청크 크기 | | 500~800자 | 허용 | | 800자 초과 | 비권장 — 주제별로 나눠주세요 |

권장 파일 형식

| 형식 | 권장도 | 이유 | |------|--------|------| | Markdown (.md) | 최고 | 헤더 구조 완벽 인식 | | Text (.txt) | 높음 | 단순하고 안정적 | | PDF | 보통 | 레이아웃 손실 가능 | | DOCX | 보통 | 서식 변환 손실 가능 |

피해야 할 패턴

• 너무 짧은 단락: "배송 안내 / 빠른 배송" → 충분한 설명을 추가하세요
• 불완전한 문장: 마침표(., 다, 요, 죠)로 끝나지 않는 문장
• 이미지 의존: PDF 내 이미지로 된 텍스트는 추출되지 않습니다
• 숫자만 나열: 설명 없이 숫자나 코드만 있으면 감점됩니다

업로드 전 체크리스트

• 명확한 헤더로 섹션이 구분되어 있는가?
• 각 단락이 100~500자 범위인가?
• 모든 문장이 완전한 형태로 끝나는가?
• Q&A는 Q와 A가 쌍으로 작성되어 있는가?
• 중요한 정보가 이미지가 아닌 텍스트로 작성되어 있는가?