말씀선집 GraphRAG 연구/RAG 검색결과 설명 설계안

RAG 검색결과 설명 설계안

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

목적

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

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

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

1. RAG가 실제로 찾은 순서: 점수 기반 우선순위 리스트
2. 사람이 이해하기 좋은 설명 순서: 답변 논리에 맞춘 서사형 묶음

핵심 설계 판단

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

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

권장 구조

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

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

1. 대상과 범위: 하나님 구원의 목적은 특정 집단이 아니라 전인류를 향한다.
2. 정의: 구원은 본연세계로 돌아가는 것, 곧 복귀이다.
3. 진행 방식: 사탄세계와의 분립, 하나님의 사랑, 세계를 위한 희생이라는 길로 설명된다.
4. 결론: 하나님은 복귀역사를 통해 인류 구원을 진행하신다.

실제 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

장표 산출물

• 가로형 PDF: WordsRAG_result_design_v2_landscape_20260730.pdf

• 
  1. 검색결과를 답변 구조로 바꾸는 방법
• 
  2. 실제 검색 입력과 핵심어
• 
  3. 검색결과 본문 리스트화
• 
  4. 본문 리스트에 필요한 항목
• 
  5. 우선순위형과 서사형 판단
• 
  6. 원문 리스트와 서사형 답변 2단 구조
• 
  7. 서사 묶음 A: 대상과 범위
• 
  8. 서사 묶음 B: 정의와 방법
• 
  9. 최종 답변 구조

장별 설명

장	제목	설명
1	검색결과를 답변 구조로 바꾸는 방법	RAG 검색결과를 단순 나열하지 않고, 검색 투명성과 설명 전달력을 함께 확보하는 전체 문제의식을 제시한다.
2	실제 검색 입력과 핵심어	사용자 질문에서 구원하시, 하나님, 인류가 검색어로 추출되고, 이 검색어들이 원문 후보를 찾는 기준이 된다는 점을 설명한다.
3	검색결과 본문 리스트화	RAG가 찾은 Top 결과를 점수순으로 그대로 보여 준다. 이 장은 답변 논리를 만들기 전, 사용자가 원문 근거와 점수를 검토할 수 있게 하는 투명성 장이다.
4	본문 리스트에 필요한 항목	검색결과 리스트에는 출처, 본문 요지, 매칭어, 점수, 서사 묶음 태그가 함께 있어야 함을 설명한다. 특히 “왜 이 결과가 들어왔는가”가 보이는 것이 중요하다.
5	우선순위형과 서사형 판단	검색결과를 점수순으로 놓을지, 답변 논리에 맞게 재배열할지 결정해야 하는 지점을 설명한다. 결론은 둘 중 하나를 고르는 것이 아니라, “찾은 순서”와 “설명 순서”를 분리하는 것이다.
6	원문 리스트와 서사형 답변 2단 구조	화면 설계 관점에서 왼쪽에는 RAG가 찾은 순서를, 오른쪽에는 사람이 이해할 설명 순서를 배치하는 2단 구조를 제안한다.
7	서사 묶음 A: 대상과 범위	133권 274쪽과 87권 163-164쪽을 묶어, 하나님의 구원 목적이 특정 집단이 아니라 전인류를 향한다는 답변 축을 만든다.
8	서사 묶음 B: 정의와 방법	100권 234-235쪽과 52권 38-40쪽을 묶어, 구원은 복귀이며 그 길은 사탄분립, 하나님 사랑, 세계를 위한 희생으로 설명된다는 답변 축을 만든다.
9	최종 답변 구조	앞의 원문 근거들을 의미 경로로 연결하여 최종 답변 예시를 제시한다. 핵심은 검색결과 본문은 우선순위 리스트로 늘어놓고, 최종 설명은 서사형으로 묶는 것이다.

보고용 설명문

이 자료는 말씀선집 RAG 검색 결과를 사용자가 신뢰할 수 있게 보여 주기 위한 화면·설명 설계안이다. RAG 검색 결과는 점수와 매칭어에 따라 순위가 매겨지지만, 그 순위가 곧바로 사람이 이해하기 좋은 설명 순서가 되는 것은 아니다.

예를 들어 “하나님은 인류를 어떻게 구원하시는가?”라는 질문에서 RAG Top 1은 133권 274쪽이다. 이 근거는 구원의 범위가 전인류라는 점을 강하게 보여 준다. 그러나 구원의 정의를 설명할 때는 100권 234-235쪽의 “구원은 본연으로 돌아가는 것, 곧 복귀”라는 구절이 더 직접적이다. 따라서 검색 화면에서는 133권 274쪽을 Top 1로 보여 주되, 최종 설명을 만들 때는 100권 234-235쪽을 “구원의 정의” 위치로 재배열해야 한다.

결론적으로 위키와 서비스 화면에서는 두 구조를 함께 보존해야 한다. 첫째, RAG가 실제로 찾은 결과는 우선순위형 리스트로 공개한다. 둘째, 답변 본문은 대상, 정의, 진행 방식, 결론이라는 서사형 구조로 묶는다. 이렇게 하면 사용자는 원문 근거를 직접 검토할 수 있고, 동시에 최종 답변도 자연스럽게 이해할 수 있다.

원본 작업 파일

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

• /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/

관련 문서

• 말씀선집 GraphRAG 연구
• 말씀선집 GraphRAG 연구/DB 구조 설계와 테스트 결과
• 말씀선집 GraphRAG 연구/임베딩 공부 방향과 실습 계획
• AI 친화형 교리 FAQ