> ## Documentation Index
> Fetch the complete documentation index at: https://docs.platform.nora.my/llms.txt
> Use this file to discover all available pages before exploring further.

# 리트리벌 프리셋

> 리트리벌 설정을 저장하고 Agent 간 재사용.

**리트리벌 프리셋** 은 이름 있는 리트리벌 설정 번들입니다. 모든 Agent 를 수동으로 튜닝하는 대신 한 번 튜닝하고 재사용합니다.

## 프리셋 구조

* **Name** — 참조할 방법.
* **Top K** — 쿼리당 반환할 청크 수. 기본 6.
* **Score cutoff** — 포함할 최소 융합 점수. 기본 0.15 (RRF 공간).
* **Vector weight** / **Keyword weight** — 하이브리드 균형.
* **Reranker** — 상위 20 후보에 대한 옵션 크로스 인코더 리랭크 패스. 품질 개선; \~200ms 지연 추가.
* **Query expansion** — 온/오프, 개수.
* **Filters** — 항상 적용되는 메타데이터 필터.
* **Grounding** — 인과 그래프 대조 검증, 온/오프.

## 프리셋 만들기

1. **Workspace → Retrieval presets → New**.
2. 노브 설정.
3. 실제 쿼리 몇 개로 테스트.
4. 저장.

Agent 블록 인스펙터의 **Retrieval preset** 필드에서 Agent 에 붙임.

## 시작하기 좋은 흔한 프리셋

Nora 는 복제·수정할 수 있는 세 내장 프리셋 제공:

* **Balanced (기본)** — 하이브리드, top 6, 리랭커 없음. 좋은 일반 시작점.
* **Precise** — 하이브리드 + 리랭커 + 높은 컷오프. 품질 > 지연인 고위험 답변에.
* **Fast** — 키워드 전용, top 4, 리랭커 없음. 서브초 응답이 중요한 라이브 채팅에.

## Agent 별 오버라이드

가끔 Agent 가 살짝 다른 변형이 필요. 전체 프리셋을 복제하지 않고 Agent 에서 개별 프리셋 필드를 오버라이드 가능 — 필드가 프리셋에서 벗어나면 인스펙터가 "오버라이드" 인디케이터 표시.

## 프리셋 버전

프리셋은 Flow 처럼 버전 관리됨. 하나를 바꿔도 그것을 쓰는 Agent 를 배포할 때까지 프로덕션 실행에 영향 없음. 즉 Draft 에서 프리셋을 안전하게 튜닝하고 차이를 A/B 테스트할 수 있음.

## 여러 프리셋 나란히 테스트

프리셋 에디터에서 **Compare** 누름. 2-3개 프리셋과 쿼리 선택. Nora 가 각각 쿼리 실행하고 점수 분해와 함께 랭크된 결과를 나란히 표시.

"빠르지만 잡음 있음" 과 "느리지만 타이트함" 사이에서 고를 때 좋음.