🔍 레슨

내 문서 연결하기

① 오늘의 미션

문서가 사방에 흩어져 있어요

'우리동네 반찬가게'의 상품 설명, FAQ, 환불 규정이 폴더 여기저기, 구글드라이브, PDF로 흩어져 있어요. RAG로 답하게 하려면 먼저 이걸 AI가 찾을 수 있게 연결해야 해요.

오늘은 흩어진 문서를 모으고 → 색인하고 → 물어보는 3단계를 손으로 해봐요.

설명을 따라 진행하면, 여기서 직접 쳐보게 돼요 👇

~/my-shop

$ _

📚 「내 문서 연결하기」 레슨 내용 전체 텍스트로 훑어보기

문서가 사방에 흩어져 있어요

오늘은 흩어진 문서를 모으고 → 색인하고 → 물어보는 3단계를 손으로 해봐요.

우리 가게 상품 설명·FAQ·환불 규정 문서 50개를 Claude가 RAG로 답하게 하려면, 가장 먼저 해야 할 일은?

맞아요. RAG를 쓰려면 먼저 우리 가게 문서를 모아 '검색 가능한 형태'로 등록해야 해요. 창고에 상품을 들여놓고 정리 라벨을 붙이는 것과 같아요. 👇

어렵지 않아요. 흐름만 알면 돼요 — 실제 작업은 Claude나 도구가 대신 해줘요.

1️⃣ 모으기

흩어진 문서(상품 설명·FAQ·환불 규정 PDF·구글드라이브)를 한 곳에 모아요.

2️⃣ 잘게 나눠 색인

긴 문서를 문단 단위로 쪼개 '뜻'으로 찾을 수 있게 등록해요. (이걸 '임베딩·인덱싱'이라 부르지만, 외울 필요 없어요.)

3️⃣ 물어보기

이제 "환불 규정 알려줘" 하면, 관련 문단을 찾아와 그걸 근거로 답해요.

가게 폴더로 들어가, 흩어진 문서를 docs/ 한 곳으로 모아요. 셸 명령으로 직접 옮겨봐요.

cd my-shop — 가게 폴더로 들어가요

mkdir docs && mv products.md faq.md refund-policy.md docs/ — 문서 폴더를 만들고 흩어진 파일을 모아요

흩어져 있던 문서가 한 폴더에 모였어요. 1단계 '모으기' 끝!

Claude에게 docs 폴더 문서를 색인해서 검색되게 해줘 라고 하면 무슨 일이 일어날까요?

맞아요. 색인(인덱싱)은 문서를 잘게 쪼개 '뜻'으로 찾을 수 있게 정리하는 거예요. 한 번 해두면 계속 써요. 시켜볼까요? 👇

Claude에게 색인을 맡겨요. 임베딩·인덱싱 같은 복잡한 건 Claude가 알아서 해요.

docs 폴더 문서를 색인해서 검색되게 해줘 — 문서를 검색 가능하게 등록해달라고 해요

2단계 '색인' 끝! 이제 우리 가게 문서가 검색 가능한 창고가 됐어요.

긴 문서를 색인할 때 가장 먼저 하는 일을 한 단어로 채워보세요.

맞아요. 잘게 쪼개야 질문에 딱 맞는 문단만 찾아올 수 있어요. 통째로 두면 엉뚱한 부분까지 딸려와요.

연결이 끝났으니 3단계 '물어보기'예요. 이제 우리 가게 문서에 직접 질문해요.

환불 규정 요약해서 알려줘 — 색인한 문서에 물어봐요

한 번 연결해두니 매장 직원에게 묻듯 우리 가게 자료에 바로 물어볼 수 있어요.

내 문서를 RAG로 연결하는 순서를 맞춰보세요. (↑↓로 정렬)

정확해요! 모으기 → 쪼개 색인 → 물어보기 → 답. 한 번 연결하면 그 뒤론 묻기만 하면 돼요.

고객 주문 내역 같은 민감한 문서를 연결할 때 꼭 챙길 것은?

맞아요. 앞에서 배운 권한·RLS를 떠올리세요. 고객 개인정보가 아무에게나 검색되면 안 돼요. 접근 범위를 먼저 정하고 연결하세요.

파일 옮기기도 귀찮다면

구글드라이브·노션 같은 곳은 커넥터로 바로 이을 수도 있어요 — 파일을 일일이 옮기지 않고 원본을 그 자리에서 색인해요. 흐름(모으기→색인→물어보기)은 똑같아요.

한 줄로

우리 가게 문서 연결 = 모으기 → 쪼개 색인 → 물어보기. 한 번 등록해두면, 그 뒤론 매장 직원에게 묻듯 내 상품·정책 자료에 물어볼 수 있어요.

다음 레슨에서

문서봇이 연결됐다고 끝이 아니에요 — RAG도 엉뚱한 조각을 찾아올 때가 있거든요. 다음 '검색이 실패할 때 — RAG의 한계와 검증'에서, 어떤 질문에 약한지 알고 결과를 거르는 법을 배워요. 🌱