---
tags: [workflow, rag, companyx, search, grounding]
type: workflow
last_updated: 2026-03-22
---

# RAG 검색·Grounding 요청

## 목적
- 질문을 `skill-rag-file` 검색으로 보내고, 결과를 로빙의 근거 답변 경로에 전달한다.
- Company X 내부 문서 질문은 일반 대화가 아니라 근거 검색 경로로 먼저 처리한다.

## 상위 원칙
- [RAG Workflow Index](./README.md)
- [writing-principles.md](../../../../0_VALUE/02_Governance/writing-principles.md)
- [companyx_rag_답변합성_시나리오동시종결_리서치.md](../../journey/research/260315_companyx_rag_답변합성_시나리오동시종결_리서치.md)

## 입력
- 사용자 질문
- 사용자 식별자
- 검색 제한값
- Company X 대상 여부
- `search_mode`: `vector` | `keyword` | `hybrid` (기본 `hybrid`)
- `threshold`: 검색 모드별 최소 점수 (vector 0.35, keyword 0.001, hybrid RRF 정규화)

## 출력
- 검색 결과 목록 (각 항목에 `vector_score`, `keyword_score`, `rrf_score`, `graph_score` 포함)
- 검색 결과 수
- 근거 문서 후보
- 0건 또는 오류 시 실패 상태

## 처리 순서
1. 질문과 사용자 정보를 받는다.
2. Company X 대상이면 Company X 팀 컬렉션(team_id)으로 검색한다.
3. `search_mode=hybrid`이면 벡터+키워드 RRF 합산 검색을 수행한다.
4. 검색 결과를 답변 프롬프트에 넣을 수 있는 형태로 정리한다.
5. 근거 문서 후보를 로빙 답변 경로에 전달한다.

## 실패 분기
- 검색 결과가 0건이면 `문서 없음` 또는 `미확인`으로 넘길 수 있어야 한다.
- 검색 API 오류를 성공 응답처럼 포장하지 않는다.
- 질문 적합도가 낮은 청크는 그대로 노출하지 않는다.

## 현재 기준
- 이 흐름은 `skill-rag-file` 검색을 호출하는 얇은 브리지다.
- 실제 답변 합성은 `rb8001`이 맡는다.
- 검색과 답변 합성의 책임을 섞지 않는다.

## 검증 기준
- 대표 질문이 검색 API로 정상 전달되는지 확인한다.
- 검색 결과 0건과 정상 적중이 구분되는지 확인한다.
- 근거 후보가 없는 경우에도 실패 경로가 유지되는지 확인한다.

## 관련 문서
- [RAG 업로드·인덱싱 파이프라인](./rag_upload_indexing_pipeline.md)
- [Company X Grounding 파이프라인](./companyx_grounding_pipeline.md)