RAG 검색결과 설명 설계안

이 문서는 말씀선집 RAG 검색 결과를 사용자에게 어떻게 보여 줄지 설명하기 위해 만든 2026년 7월 30일자 장표 산출물을 정리한다.

목적

사용자 질문은 다음과 같다.

하나님은 인류를 어떻게 구원하시는가?

이 질문에 대해 RAG가 찾은 원문 결과를 단순히 나열하는 데서 끝나지 않고, 다음 두 가지를 분리해서 보여 주는 방식을 설명한다.

검색결과 본문을 리스트화할 때는 우선순위형과 서사형 중 하나만 선택하는 방식보다, 두 층을 분리하는 것이 안정적이다.

구분	기준	장점	주의점
우선순위형 리스트	`keyword_score`, `rerank_score`, `matched_terms`	RAG가 왜 이 결과를 먼저 보여 주는지 투명하다. 사용자가 원문을 직접 검토하기 좋다.	점수 1등이 항상 설명 순서 1번은 아니다.
서사형 묶음	답변 논리에 맞춘 대상, 정의, 진행 경로, 결론 순서	발표자료나 교육용 설명에서 이해하기 쉽다.	원래 검색 순서와 재배열 이유를 함께 보여 주어야 신뢰가 생긴다.

검색 화면에서는 RAG가 찾은 결과를 점수 우선순위로 먼저 공개한다.

그 다음 답변 화면에서는 같은 근거를 다음과 같이 서사형으로 다시 묶는다.

질문: 하나님은 인류를 어떻게 구원하시는가?

실제 API에서 추출된 검색어:

순위	출처	본문 요지	검색 근거	점수
1	말씀선집 133권 274쪽	하나님의 목적은 특정 민족·인종·종교단체가 아니라 전인류를 구원하는 데 있다.	구원하시, 하나님, 인류	keyword 156 / rerank 195
2	말씀선집 87권 163-164쪽	하나님은 배반한 인류를 버리지 않고 죄악과 도탄에서 구원하고자 하신다.	구원하시, 하나님, 인류	keyword 151 / rerank 190
3	말씀선집 52권 38-39쪽	하나님은 우리를 통하여 온 인류를 영육 양면으로 구원하실 수 있다.	하나님, 인류	keyword 151 / rerank 185
4	말씀선집 52권 36쪽	사탄세계로부터 분립된 기반 위에서 하나님이 인간 구원의 역사를 진행하신다.	하나님, 인류	keyword 149 / rerank 183
5	말씀선집 52권 39-40쪽	사탄분립, 하나님 사랑, 타락한 형제들을 위한 희생이 구원의 공식으로 제시된다.	하나님, 인류	keyword 144 / rerank 178
6	말씀선집 100권 234-235쪽	구원은 타락세계를 본연세계로 환원시키는 것, 곧 복귀이다.	구원하시, 하나님, 인류	keyword 133 / rerank 172
7	말씀선집 42권 278쪽	메시아와 참감람나무의 비유를 통해 인류가 구원받는 길을 설명한다.	구원하시, 하나님, 인류	keyword 132 / rerank 171

로컬 작업 파일은 다음 위치에 보존되어 있다.

/home/ruyjin/.openclaw/workspace/outputs/graphrag_rag_result_design_v2.html
/home/ruyjin/.openclaw/workspace/outputs/graphrag_rag_result_design_v2_landscape.pdf
/home/ruyjin/.openclaw/workspace/outputs/graphrag_rag_result_design_v2/