Cloudflare AI Search 한국어 검색: trigram 설정과 주의점

한국어 문서를 넣은 AI 검색에 질문했는데 정작 필요한 문서가 나오지 않는다면, 답변 모델을 바꾸기 전에 검색 설정부터 살펴볼 만합니다.

Cloudflare는 2026년 10월 16일 AI Search의 키워드 검색이 trigram 토크나이저를 사용할 때 한국어·중국어·일본어 질의를 처리하도록 개선됐다고 발표했습니다. 문장 형태의 질문도 대상입니다. 이번 소식에서 확인할 핵심은 지원 언어 목록보다 어떤 설정을 사용하고 있는지입니다. Cloudflare 공식 발표

무엇이 바뀌었나요?

공식 발표에 따르면 이전에는 공백이 없는 질의를 하나의 정확한 구문으로 취급해 키워드 결과를 찾지 못하는 경우가 많았습니다. 이번 변경은 trigram을 쓰는 AI Search의 키워드 검색에 적용됩니다.

토크나이저는 검색을 위해 문장을 작은 단위로 나누는 방식입니다. Cloudflare 문서상 기본값인 porter는 공백과 구두점을 기준으로 텍스트를 나누며, 한국어처럼 단어에 조사가 붙는 언어에 잘 맞지 않습니다. 공식 문서는 한국어·중국어·일본어 콘텐츠에 trigram을 사용하도록 안내합니다. 키워드 검색 문서

예를 들어 사내 규정을 검색하는 서비스라면 단어 하나만 입력할 때와 “출장비 정산은 언제까지 해야 하나요?”처럼 질문할 때를 나눠 확인할 수 있습니다. 이 예시는 기능을 검토하기 위한 가상 질문이며, 직접 실행한 테스트 결과는 아닙니다.

한국어 검색에는 어떤 설정이 필요한가요?

확인할 설정은 indexing_options 안의 keyword_tokenizer입니다. 한국어 콘텐츠에는 값을 trigram으로 지정합니다. 키워드 검색 자체가 켜져 있는지도 index_method.keyword에서 확인해야 합니다.

trigram은 겹치는 세 글자 단위로 텍스트를 다룹니다. 따라서 세 글자보다 짧은 단어는 단독으로 일치시킬 수 없습니다. 짧은 부서명이나 약어를 자주 찾는 서비스라면 이 제약을 따로 확인해야 합니다.

또 하나 놓치기 쉬운 조건은 재색인입니다. keyword_tokenizer를 바꾸면 전체 콘텐츠가 다시 색인됩니다. 설정 한 항목만 바꾸는 것처럼 보여도 이미 등록한 문서 전체가 대상이므로, 운영 중인 검색에 적용할 시점과 재색인 상태를 함께 확인해야 합니다. 설정과 제약

모델을 바꾸기 전에 무엇을 테스트하면 좋을까요?

여기부터는 공식 기능 설명을 바탕으로 제안하는 운영 점검 순서입니다. Cloudflare가 보장한 성능이나 VECTORLOG의 실측 결과가 아닙니다.

실제 문서에서 답을 찾을 수 있는 한국어 질문을 고릅니다. 단어형 검색어와 자연스러운 질문형 검색어를 함께 준비합니다.
짧은 약어, 조사가 붙은 표현, 띄어쓰기가 달라진 표현을 따로 넣습니다. 세 글자 미만 단독 질의는 제약 확인용으로 구분합니다.
변경 전후에 같은 질문을 사용하고, 답변 문장보다 먼저 검색된 문서와 근거 구절을 비교합니다. 재색인 상태도 함께 기록합니다.
필요한 문서가 검색됐는데도 답이 틀리다면, 그때 생성 단계에 전달된 맥락과 답변을 살펴봅니다.

이 순서는 검색 문제와 답변 생성 문제를 구분하기 위한 제안입니다. 한국어를 지원한다는 발표만으로 우리 문서의 검색 정확도나 RAG 답변 품질이 얼마나 좋아지는지는 알 수 없습니다. 실제 데이터와 질문으로 확인해야 합니다.

자주 묻는 질문

기존 AI Search에도 자동으로 적용되나요?

이번 개선은 trigram 토크나이저를 사용하는 키워드 검색에 관한 것입니다. 기본값인 porter를 사용 중이라면 현재 설정부터 확인해야 합니다. 토크나이저를 변경하면 전체 재색인이 일어납니다.

한국어 질문을 지원하면 두 글자 단어도 찾을 수 있나요?

공식 문서상 trigram은 세 글자보다 짧은 단어를 단독으로 일치시키지 못합니다. 이런 검색어가 필요한 경우를 실제 테스트에 별도로 포함하는 편이 좋습니다.

전에 소개한 Cloudflare Web Search API와 같은 기능인가요?

이번 글은 AI Search에 색인한 콘텐츠의 키워드 검색을 다룹니다. 외부 검색 업체를 공통 API로 연결하는 Web Search API와는 살펴볼 지점이 다릅니다. 두 기능의 역할이 궁금하다면 Cloudflare Web Search API를 정리한 이전 글을 함께 읽어보실 수 있습니다.

2026년 10월 18일 기준 공식 요금 안내에는 AI Search 과금이 11월 1일 시작된다고 명시돼 있습니다. 도입 시점에는 무료 사용분과 초과 사용 조건도 최신 요금 문서에서 확인해야 합니다.

한국어 검색이 잘 안 된다는 이유로 곧바로 모델을 교체하기보다, 현재 토크나이저와 검색 결과부터 확인해 보세요. 이번 업데이트는 그 점검을 시작할 구체적인 설정 항목을 제공합니다.

Cloudflare AI Search 한국어 키워드 검색, trigram 설정부터 확인하세요