Semantic Search 시맨틱 검색 결과 화면
경로: Console → Semantic Search → 검색 실행 후
검색을 실행하면 상단 Search Interface 는 그대로 유지되고, 그 아래 Search Results 영역이 렌더됩니다. 파라미터를 바꿔 재검색하려면 상단 폼에서 바로 수정·Search 를 다시 누르면 됩니다.
결과 영역 구성
| 요소 | 설명 |
|---|
| Search Results (N) | 결과 개수 뱃지 |
Results for “{query}” | 실행한 질의어 표시 |
| Higher score = More relevant | 점수 해석 안내 (i 아이콘) |
| Copy All Results JSON | 전체 결과를 JSON 으로 클립보드 복사 (우측 상단 버튼) |
| File Type Tabs | All + 파일 확장자별 자동 그룹 탭 (예: YAML 4, YML 1) |
| Result Cards | 개별 결과 카드 목록 |
점수(Score) 해석: 값이 클수록 질의와 더 관련 높은 결과입니다. UI 에 Higher score = More relevant 안내가 함께 표시됩니다.
File Type Tabs (파일 타입 필터)
결과에 포함된 파일 확장자별로 자동 그룹핑 된 탭이 생성됩니다.
All N — 전체 결과 (기본 선택)YAML N / YML N / PDF N / DOCX N … — 해당 확장자 결과만 필터- 각 탭에 카운트 뱃지 가 붙어 몇 개인지 바로 확인
Result Card (개별 결과 카드)
각 결과 카드는 아래 요소로 구성됩니다.
| 요소 | 위치 | 설명 |
|---|
| 순위 뱃지 | 좌측 상단 | 1, 2, 3 … 관련도 순 |
| 파일 아이콘 + 파일명 | 상단 | 확장자 기반 아이콘 (예: simple, manifest) |
| Score | 우측 상단 | 0.0164 — 값이 클수록 관련성 높음 |
| 본문 미리보기 | 중앙 | YAML 키: 값, 메타데이터 필드 bullet 리스트 |
| 페이지 표시 | 좌측 하단 | p.0/1 형식 (현재 페이지 / 총 페이지) |
| +N 칩 | 좌측 하단 | 표시되지 않은 추가 메타데이터 개수 (예: +13) |
| Copy | 우측 하단 | 해당 카드 결과만 JSON 으로 복사 |
| Show more / Show less | 우측 하단 | 본문 전체 펼치기 / 접기 |
본문 확장/축소
- 기본: 앞부분만 표시
- Show more 클릭 → 전체 본문 (모든 메타데이터 키·값) 표시
- Show less 클릭 → 다시 축약
카드 URL · 링크
본문에 URL 이 포함된 필드(예: source_url: https://file-examples.com/)는 클릭 가능한 링크 로 렌더되고, 외부 링크 아이콘이 함께 표시됩니다.
결과 복사
| 버튼 | 범위 | 용도 |
|---|
| Copy All Results JSON (상단) | 전체 결과 | 외부 도구·스크립트로 활용 |
| Copy (카드 하단) | 단일 카드 | 특정 문서 메타만 복사 |
빈 결과 · 에러 · 로딩
- 결과 없음 —
No results found 표시. 질의어를 바꾸거나 Top K 를 늘려 보세요.
- 로딩 중 — 스켈레톤 카드 3 개 표시
- 에러 — 네트워크/엔드포인트 문제 시 에러 메시지
파일 타입 아이콘
| 확장자 | 아이콘 색상 |
|---|
pdf | 빨강 |
doc, docx | 파랑 |
xlsx, xls, csv | 녹색 |
png, jpg, gif, svg, webp | 녹색 |
txt | 회색 |
js, py, java, c, cpp, html, css, json, yaml, yml | 보라 |
mp4, avi, mov, wmv | 빨강 |
mp3, wav, ogg | 파랑 |
| 기타 | 회색 |
검색 히스토리
- 검색 성공 시 질의어가 로컬 스토리지에 저장 (최대 10 개)
- 중복 질의어는 맨 앞으로 이동
- 파일 타입 탭으로 특정 형식만 빠르게 필터 — 예:
PDF 탭만 클릭해 PDF 결과만 확인
- 관련도가 낮아 보이면 Top K 증가 또는 Dense / Sparse 모드 전환 으로 재검색
- 결과를 외부 분석·LLM 프롬프트에 넣으려면 Copy All Results JSON 활용
메타데이터는 JSON 문자열로 저장되므로 파싱 에러 시 기본 필드만 표시될 수 있습니다.
