Skip to main content
필터는 랭킹 전에 실행됩니다. 기준에 매치되는 청크만 남기도록 후보 풀을 줄여서 랭킹이 집중된 세트에서 동작하게 합니다.

필터할 수 있는 것

강화된 모든 청크는 메타데이터를 가짐. 흔한 필터 가능 필드:
  • Tags — 자동 태그 강화기가 추가한 태그.
  • Source — 어느 문서·폴더·데이터베이스 로우.
  • Path — 헤딩 경로 또는 폴더 위치.
  • Language — 청크의 감지된 언어.
  • Entities — 추출된 사람·조직·제품.
  • Modified date — 소스 마지막 업데이트 시점.
  • Custom fields — 인라인 강화기가 쓴 것.
필드는 Enrich 스테이지 로 추가.

필터 표현식

필터는 JSON 유사 술어로 표현. 예:
연산자: $eq, $ne, $in, $nin, $gt, $gte, $lt, $lte, $contains, $startsWith, $exists, $and, $or, $not.

세 레벨의 필터

필터는 레벨 간 합성됨. 상위 레벨의 설정이 모든 하위 레벨에 적용.
  1. 데이터 소스 레벨 — 문서 컬렉션에 붙임. 그것에 대한 모든 쿼리에 적용.
  2. 프리셋 레벨 — 리트리벌 프리셋 안. 그 프리셋을 쓰는 모든 Agent 에 적용.
  3. 쿼리 레벨 — 호출별, 런타임에 설정. Agent 가 특별한 도구 인자로, 또는 여러분 코드로.
런타임 필터는 프리셋 필터에 병합됨 (둘 다 매치해야 함). 이렇게 하면 Agent 가 “고객 대상 문서만 검색 가능” 을 시스템 룰로 노출하지 않고 더 좁힐 수 있음.

변수로부터의 동적 필터

필터는 Flow 변수를 참조 가능:
흔한 패턴: 테넌트별 스코핑. 실행 시작 시 변수를 요청자의 테넌트 ID 로 설정, 모든 리트리벌이 자동 스코프.

테스트

프리셋 Test 패널에서 런타임 필터를 설정하고 결과가 어떻게 바뀌는지 볼 수 있음. 배포 전 접근 통제 검증에 좋음.

성능

인덱스된 필드 (태그, 소스, 날짜) 의 필터는 무료 — 인덱스 스캔 시점에 실행. 인덱스 안 된 커스텀 필드 필터는 fetch 후 스캔으로 저하되고 컬렉션 크기가 커질수록 느려짐. 컬렉션 설정에서 hot 필터 필드에 인덱스 추가.