Joomla 검색 시스템을 키워드 매칭에서 RAG 아키텍처 기반 의미 검색으로 전환하는 구현 가이드

Context

키워드 기반 검색은 문자열 매칭만 수행한다. "how do I reset my account"와 "recover your login credentials"는 의미가 유사해도 매칭되지 않는다. 이 한계는 Joomla가 아닌 키워드 검색 자체의 구조적 문제이다.

Technical Solution

• PostgreSQL pgvector → 벡터 임베딩 저장을 위한 확장 기능 설치
• 콘텐츠 → OpenAI 임베딩 API로 벡터 변환 후 pgvector 테이블에 저장
• 사용자 검색어 → 동일하게 벡터 변환하여 코사인 유사도로 유사 문서 검색
• 검색된 유사 문서를 LLM 입력으로 전달하여 직접 답변 생성
• Joomla 4/5 커스텀 컴포넌트로 전체 RAG 파이프라인 통합

Impact

키워드 검색에서는 발견할 수 없던 관련 콘텐츠를 의미 기반으로 검색 가능

Key Takeaway

RAG 아키텍처는 검색 방식 자체를 문자열 매칭에서 의미 이해로 전환한다. 이 구조는 특정 CMS에 국한되지 않는다.