말씀선집 GraphRAG 연구/RAG 검색결과 설명 설계안 문서 원본 보기

= RAG 검색결과 설명 설계안 =

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

== 목적 ==

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

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

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

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

== 핵심 설계 판단 ==

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

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

== 권장 구조 ==

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

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

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

== 실제 RAG 검색 결과 요지 ==

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

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

* <code>구원하시</code>
* <code>하나님</code>
* <code>인류</code>

{| class="wikitable"
! 순위 !! 출처 !! 본문 요지 !! 검색 근거 !! 점수
|-
| 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: [[:File:WordsRAG_result_design_v2_landscape_20260730.pdf|WordsRAG_result_design_v2_landscape_20260730.pdf]]

<gallery mode="packed" heights="170">
File:WordsRAG_result_design_v2_slide_01_20260730.png|1. 검색결과를 답변 구조로 바꾸는 방법
File:WordsRAG_result_design_v2_slide_02_20260730.png|2. 실제 검색 입력과 핵심어
File:WordsRAG_result_design_v2_slide_03_20260730.png|3. 검색결과 본문 리스트화
File:WordsRAG_result_design_v2_slide_04_20260730.png|4. 본문 리스트에 필요한 항목
File:WordsRAG_result_design_v2_slide_05_20260730.png|5. 우선순위형과 서사형 판단
File:WordsRAG_result_design_v2_slide_06_20260730.png|6. 원문 리스트와 서사형 답변 2단 구조
File:WordsRAG_result_design_v2_slide_07_20260730.png|7. 서사 묶음 A: 대상과 범위
File:WordsRAG_result_design_v2_slide_08_20260730.png|8. 서사 묶음 B: 정의와 방법
File:WordsRAG_result_design_v2_slide_09_20260730.png|9. 최종 답변 구조
</gallery>

== 원본 작업 파일 ==

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

* <code>/home/ruyjin/.openclaw/workspace/outputs/graphrag_rag_result_design_v2.html</code>
* <code>/home/ruyjin/.openclaw/workspace/outputs/graphrag_rag_result_design_v2_landscape.pdf</code>
* <code>/home/ruyjin/.openclaw/workspace/outputs/graphrag_rag_result_design_v2/</code>

== 관련 문서 ==

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

[[분류:말씀선집GraphRAG]]
[[분류:RAG]]
[[분류:AI검색]]
[[분류:동우공부]]