Insights / 기술 해설
Cloudflare Vectorize와 RAG 입문: 검색과 AI 답변의 차이 이해하기
Cloudflare Vectorize가 방문자의 자연스러운 질문으로 이미 공개한 정보를 더 쉽게 찾게 하는 방법을, 도입 가치, 일반 검색과의 역할 분담, RAG, 단계적 시작 방법으로 설명합니다.

목차
먼저 결론: Vectorize는 질문과 페이지 사이의 거리를 줄입니다
사이트에 좋은 가이드와 FAQ가 있어도 방문자가 그 페이지에 닿지 못할 수 있습니다. 페이지 제목의 단어와 방문자가 질문하는 단어가 다르기 때문입니다.
예를 들어 페이지에는 계정 설정이라고 쓰여 있어도 방문자는 로그인 후 무엇을 해야 하나요 또는 초기 설정을 모르겠어요라고 묻습니다. Vectorize는 완전히 같은 단어만이 아니라 의미가 가까운 공개 정보를 찾아 이 간격을 줄입니다.
새로운 사실을 만들거나 오래된 정보를 자동으로 고치지는 않습니다. 이미 공개하고 신뢰하는 정보에 더 자연스러운 입구를 만드는 것이 가치입니다. Cloudflare는 Vectorize를 의미 검색, 추천, 분류 등에 활용할 수 있다고 안내합니다. Cloudflare Vectorize 공식 문서
먼저 RAG란?
RAG는 Retrieval Augmented Generation의 약자입니다. 쉽게 말하면 관련 정보를 먼저 검색하고, AI가 그 정보를 사용해 답변을 만드는 방식입니다.
Vectorize는 의미가 가까운 자료를 찾는 사서의 목록처럼 생각할 수 있습니다. RAG는 그 목록에서 자료를 찾고, 선택한 원문을 읽고, 출처를 보여 주며 답하는 사서의 전체 업무입니다.
질문을 바로 AI 모델에 보내는 대신, 먼저 자신의 공개 정보에서 관련 자료를 가져와 맥락으로 더합니다. Cloudflare는 벡터 검색 맥락을 LLM에 보내는 prompt에 더하는 방식을 RAG로 설명합니다. Cloudflare 공식 설명
Vectorize와 RAG의 역할은 다릅니다
| 구성 요소 | 역할 | 단독으로 할 수 있는 일 |
|---|---|---|
| Pagefind | 페이지의 단어 찾기 | 제품명, 고유명사, 오류 코드를 빠르게 찾기 |
| Vectorize | 의미가 가까운 정보 찾기 | 바꿔 말한 표현과 관련 페이지 후보 돌려주기 |
| RAG | 검색한 근거로 AI 답변 만들기 | 답변과 원본 페이지 링크 함께 돌려주기 |
Vectorize는 답변을 생성하지 않습니다. RAG는 검색만도 아닙니다. 검색, 근거 선별, 답변 생성, 출처 표시를 하나의 계약으로 설계해야 독자가 답변을 확인할 수 있습니다.

그림: 일반 검색은 정확한 단어에, 의미 검색은 바꿔 말한 질문과 관련 정보에 알맞습니다. 하나를 다른 하나로 대체하지 않고 역할을 나눕니다.
효과가 잘 드러나는 경우
같은 내용을 사람마다 다른 표현으로 묻고, 공개 가이드와 FAQ가 여러 페이지에 나뉘어 있으며, 원문 링크로 다음 행동을 안내하고 싶은 사이트에서 특히 평가하기 쉽습니다. 반대로 공개 정보와 초안이 섞여 있거나 최신 근거를 구분할 수 없다면 검색을 넓히기 전에 정보의 경계를 정해야 합니다.
3단계로 시작하기
처음부터 챗봇을 만들 필요는 없습니다.
- 일반 검색을 남깁니다. Pagefind로 제품명과 오류 코드를 계속 찾을 수 있게 합니다.
- 관련 페이지 검색을 더합니다. Vectorize가 질문과 가까운 공개 페이지를 보여 주고, 대표 질문으로 품질을 확인합니다.
- 근거 있는 답변으로 확장합니다. 사용할 페이지, 출처 링크, 답변을 보류할 조건을 정할 수 있을 때만 RAG를 더합니다.

그림: 일반 검색을 기반으로 남겨 두면 의미 검색과 AI 답변을 작게 검증하고 필요할 때 안전하게 되돌릴 수 있습니다.
이 순서라면 AI 답변의 모양을 다듬기 전에 검색 대상 자체가 올바른지 확인할 수 있습니다.
RAG 답변은 근거 선택에서 시작됩니다
| 결정할 것 | 시작하기 쉬운 선택 | 이유 |
|---|---|---|
| 질문 범위 | 공개 사이트 정보만 | 초안이나 내부 정보를 답변에 잘못 쓰지 않음 |
| 근거 표시 | 답변마다 원본 페이지 링크 | 독자가 답변을 확인할 수 있음 |
| 근거 부족 시 | “확인할 수 없습니다”라고 알림 | 그럴듯한 추측을 피함 |
| 검색 분리 | 입력 중에는 Pagefind, 명시적 실행 뒤에는 Vectorize/RAG | 전송 범위, 비용, 대기 시간을 이해하기 쉬움 |
RAG가 오답을 불가능하게 하지는 않습니다. corpus 선택, 근거 확인, 답하지 않을 조건을 명확히 하는 일이 품질을 결정합니다.

그림: RAG는 검색 결과를 그대로 답변으로 삼지 않습니다. 원문을 확인하고 사용할 수 있는 근거만 답변과 출처로 연결합니다.
판단에서 구현으로 이어서 읽기
- Vectorize를 안전하게 구현하는 상세 가이드에서 공개 HTML corpus, content hash, 차등 동기화, Preview/Production 분리, rate limit을 확인합니다.
- 문의 AI 채팅을 위한 기술 설계에서 AI 입력, API 경계, URL 허용 목록을 확인합니다.
- Astro와 Cloudflare로 공식 사이트를 확장하는 전체 설계에서 정적 사이트 위에 검색과 AI 기능을 안전하게 더하는 역할을 확인합니다.
더 나은 검색이 필요한지, 출처를 보일 수 있는 AI 안내까지 필요한지를 나누어 판단하면 필요한 구현과 검증이 더 명확해집니다.
RAG의 기본
질문을 근거 있는 답변으로 연결하는 네 단계
검색 결과 자체는 답변이 아닙니다. 원래 공개 페이지를 가져온 뒤 답변의 맥락으로 사용합니다.
공개 정보를 준비한다
독자에게 보여도 되는 페이지만 검색 대상에 넣습니다.
질문을 의미로 검색한다
질문을 embedding으로 바꾸고 Vectorize에서 가까운 정보를 찾습니다.
근거를 고른다
원본 페이지, URL, 최신 상태를 확인하고 답변에 쓸 정보만 고릅니다.
답하거나 보류한다
근거가 충분할 때만 AI가 답하고, 부족하면 확인할 수 없다고 알립니다.
관련 페이지
- Vectorize를 안전하게 구현하는 상세 가이드공개 HTML corpus, 차등 동기화, Preview/Production 분리, API 경계를 구현할 때 읽는 글입니다.
- 문의 AI 채팅을 위한 기술 설계공개 정보로 방문자를 안내하는 AI 기능의 API 경계, 입력 제어, URL 허용 목록을 확인합니다.
- Astro와 Cloudflare로 공식 사이트를 확장하는 전체 설계정적 사이트를 기반으로 검색과 AI 기능을 안전하게 추가하는 역할 분담을 확인합니다.
- Cloudflare Vectorize 공식 문서Vectorize의 용도, embedding, 검색에 관한 공식 설명을 확인할 수 있습니다.
- Cloudflare의 RAG와 벡터 데이터베이스 해설벡터 검색으로 가져온 맥락을 LLM prompt에 더하는 RAG의 흐름을 확인할 수 있습니다.
- Cloudflare의 Vectorize index 생성 가이드embedding 차원과 거리 지표처럼 index 생성 전에 정해야 하는 항목을 확인합니다.