🔍 레슨

실무 패턴 — 사내 문서봇의 구조

"우리 회사 위키에서 답하는 봇"은 실제로 어떻게 생겼나. 부품과 조립도.

① 마지막 미션

"가게의 모든 걸 아는 직원"

반찬가게가 커지면서 알바·단골·납품처가 늘었어요. 영업시간, 환불 규칙, 반찬별 알레르기 정보, 배달 가능 동네… 이런 게 위키 문서 여기저기 흩어져 있어요. 누가 물을 때마다 사장님이 찾아 답하긴 벅차죠.

오늘의 미션 — "우리 가게 위키에서 답을 찾아주는 봇"을 만드는 구조를 조립합니다. 이번 코스에서 배운 부품이 모두 여기 모여요. 이 코스, 그리고 전체 커리큘럼의 마지막 레슨이에요.

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

~/my-shop

$ _

📚 「실무 패턴 — 사내 문서봇의 구조」 레슨 내용 전체 텍스트로 훑어보기

"가게의 모든 걸 아는 직원"

가장 단순한 생각 — 질문할 때마다 위키 문서 '전부'를 Claude에게 붙여서 물어보면 안 될까요?

맞아요. 문서가 수십·수백 장이 되면 매 질문마다 전부 붙이는 건 책상이 넘치고 느리고 비싸요. 그래서 질문과 관련된 조각만 골라서 붙이는 구조가 필요해요 — 이게 문서봇의 핵심이에요.

"질문과 관련된 조각만 골라 붙인다." 이걸 실제로 하려면 부품 몇 개가 순서대로 맞물려야 해요.

7개의 부품

① 문서 수집 — 위키 글들을 한곳에 모은다
② 청킹(chunking) — 긴 문서를 토막(문단 크기)으로 자른다
③ 임베딩 — 각 토막을 '의미 좌표(숫자 묶음)'로 바꾼다
④ 저장(벡터DB) — 그 좌표들을 검색 가능하게 보관한다
⑤ 질문 검색 — 손님 질문도 좌표로 바꿔, 가까운 토막을 찾는다
⑥ AI 답변 — 찾은 토막을 Claude에게 붙여 답하게 한다
⑦ 출처 표시 — "이 답은 환불규정 문서에서 왔어요"라고 밝힌다

이름이 어려워 보여도, 사실 이번 코스에서 하나씩 다 만져본 것들이에요. 순서부터 맞춰볼게요.

손님이 "환불 며칠까지 돼요?"라고 묻기 전에 미리 준비해두는 단계와, 물은 뒤에 답하는 단계가 있어요. 위에서 아래로 흐르는 순서대로 놓아보세요.

정확해요. 앞 4개(수집→청킹→임베딩→저장)는 손님이 오기 전에 미리 해두는 준비, 뒤 3개(검색→답변→출처)는 질문이 들어올 때마다 도는 실시간 흐름이에요.

여기가 오늘의 진짜 핵심이에요. 무서워 보이던 부품들이 사실 전부 배운 것이라는 확인.

이미 손으로 해본 것들

· 청킹 = 긴 글을 토막으로 — '청킹 — 문서를 어떻게 자르나' 레슨의 그 감각
· 임베딩 = 의미 좌표 = '의미로 찾기' 레슨에서 본 그것
· 벡터DB 검색 = '가까운 의미를 찾는다' = 그 좌표 위 거리 계산
· AI 답변 = 찾은 조각을 붙여 묻기 = '컨텍스트에 올린 것만 안다'는 토큰 레슨
· 웹검색 대신 우리 위키 = 직전 '웹검색·리서치' 레슨의 '찾아 읽게'를 사내 문서로

즉 문서봇은 새 마법이 아니라, 배운 부품의 조립이에요. 그래서 여러분은 이미 만들 줄 압니다.

손님이 '환불 며칠까지?'라고 물었을 때, 벡터DB에서 토막을 찾는 방법은?

맞아요. 질문을 같은 방식으로 임베딩(좌표화)해서, 그 좌표와 가까운 토막을 골라요. 그래서 '환불'이라는 단어가 안 들어가도 '며칠 안에 돌려받나요' 같은 표현까지 의미로 잡혀요. 글자 일치가 아니라 의미 일치예요.

구조가 헷갈리면 Claude에게 직접 물어 정리받을 수 있어요. 가게 폴더에서 Claude를 켜고 우리 맥락으로 물어봐요.

우리 반찬가게 위키 문서로 답하는 봇을 만들려고 해. 문서 수집부터 출처 표시까지 어떤 부품이 어떤 순서로 필요한지 한 줄씩 정리해줘

— 우리 가게 맥락으로 구조를 확인해요

구조가 막히면 이렇게 내 맥락(반찬가게)으로 물어 정리받는 습관 — 코스 내내 써온 그 방법이에요.

이 큰 봇을 어떻게 시작하면 좋을까요? 두 길을 나란히 봐요.

🏔️ 전부 한 번에: 위키 전체·모든 문서·완벽한 벡터DB를 처음부터. 부품이 많아 어디서 막혔는지 모르고, 손도 못 대고 지쳐요.

🌱 폴더 하나부터: 문서 한 폴더(예: 환불규정 3장)만 넣고 끝까지 돌려봐요. 작동하는 작은 봇을 먼저 갖고, 문서를 늘려가며 키워요.

처음 만드는 가게 문서봇 — 위키 전체 200장으로 시작하는 것과, 환불규정 폴더 3장으로 시작하는 것. 어느 쪽이 '오늘 안에 작동하는 봇'에 가까울까요?

3장이에요. 부품 7개가 처음으로 맞물려 돌아가는지 확인하는 게 먼저예요. 한 바퀴가 돌면 문서를 폴더째 더 넣는 건 같은 작업의 반복이라 쉬워요. '작게 시작'이 이번 코스, 아니 전체 커리큘럼의 일관된 태도였죠.

문서봇이 "환불은 7일 이내예요"라고만 답하면 손님은 못 믿어요. 답 끝에 "어느 문서에서 가져온 답인지"를 같이 보여줘야 신뢰가 생겨요. 이 마지막 부품의 이름은?

정답! 출처예요. 찾은 토막이 어느 문서에서 왔는지 알기 때문에 그대로 밝힐 수 있어요. 출처가 붙으면 봇은 '그럴듯한 말'이 아니라 '확인 가능한 답'이 돼요 — 사내 봇의 신뢰는 여기서 나와요.

말이 아니라 손으로 첫발을 떼봐요. 환불규정 문서를 담을 작은 폴더 하나를 가게 안에 만들고, 그 폴더로 봇을 시작해달라고 Claude에게 부탁해요.

mkdir wiki-bot && cd wiki-bot — 먼저 작은 시작 폴더를 만들어요 (셸 명령)

이 폴더에 환불규정 문서 몇 장만 넣고, 그걸로 질문에 답하고 출처까지 보여주는 작은 문서봇을 만들어줘. 작게 시작해서 나중에 문서를 늘릴 거야

— 그 다음, 폴더 하나로 시작하는 봇을 말로 부탁해요

봤죠? 거대한 시스템도 폴더 하나, 문서 몇 장에서 시작해요. 나머지는 같은 작업을 반복하며 키우는 것뿐이에요.

한 줄로

사내 문서봇은 새 마법이 아니라 배운 부품의 조립이에요 — 수집·청킹·임베딩·저장·검색·답변·출처. 시작은 언제나 폴더 하나, 문서 몇 장부터.

🎓 전체 커리큘럼 수료를 축하해요

텅 빈 폴더에서 '우리동네 반찬가게'를 한 조각씩 키워, 이제는 가게의 모든 지식이 답하는 봇의 구조까지 손으로 조립했어요. AI가 어떻게 말을 잇는지부터, 토큰·컨텍스트·검색·리서치, 그리고 오늘의 문서봇 조립도까지 — 여러분은 이제 '무서운 신기술'이 아니라 조립할 줄 아는 부품들'로 AI를 봅니다.

가게는 여기서 멈추지 않아요. 실습 탭에서 직접 손으로 더 키우고, 포럼에서 막힌 곳을 나눠요. 작게 시작해서, 계속 자라게. 🌱 고생 많으셨어요.