> ## Documentation Index
> Fetch the complete documentation index at: https://manual.seahorse.dnotitia.ai/llms.txt
> Use this file to discover all available pages before exploring further.

> Semantic Search 결과 화면 — 파일 타입 탭, 결과 카드(순위·점수·메타데이터), JSON 복사

# After search

# Semantic Search 시맨틱 검색 결과 화면

**경로**: Console → **Semantic Search** → 검색 실행 후

검색을 실행하면 상단 **Search Interface** 는 그대로 유지되고, 그 아래 **Search Results** 영역이 렌더됩니다. 파라미터를 바꿔 재검색하려면 상단 폼에서 바로 수정·Search 를 다시 누르면 됩니다.

## 결과 영역 구성

<img src="https://mintcdn.com/dnotitia-328335e7/nH6QAwwQZ-jsIFdi/.gitbook/assets/admin__SemanticSearch01.png?fit=max&auto=format&n=nH6QAwwQZ-jsIFdi&q=85&s=dafd022127f710ee224f3d578f18d178" alt="결과 영역" width="982" height="804" data-path=".gitbook/assets/admin__SemanticSearch01.png" />

| 요소                               | 설명                                             |
| -------------------------------- | ---------------------------------------------- |
| **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**                 | 개별 결과 카드 목록                                    |

<Info>
  **점수(Score) 해석**: 값이 **클수록** 질의와 더 관련 높은 결과입니다. UI 에 `Higher score = More relevant` 안내가 함께 표시됩니다.
</Info>

## File Type Tabs (파일 타입 필터)

결과에 포함된 **파일 확장자별로 자동 그룹핑** 된 탭이 생성됩니다.

* `All N` — 전체 결과 (기본 선택)
* `YAML N` / `YML N` / `PDF N` / `DOCX N` … — 해당 확장자 결과만 필터
* 각 탭에 **카운트 뱃지** 가 붙어 몇 개인지 바로 확인

## Result Card (개별 결과 카드)

<img src="https://mintcdn.com/dnotitia-328335e7/nH6QAwwQZ-jsIFdi/.gitbook/assets/admin__SemanticSearch002.png?fit=max&auto=format&n=nH6QAwwQZ-jsIFdi&q=85&s=1e4e4f87d16e3e5f4c13c28dda8e51b2" alt="Result Card" width="982" height="804" data-path=".gitbook/assets/admin__SemanticSearch002.png" />

각 결과 카드는 아래 요소로 구성됩니다.

| 요소                        | 위치    | 설명                                   |
| ------------------------- | ----- | ------------------------------------ |
| **순위 뱃지**                 | 좌측 상단 | `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 개)
* 중복 질의어는 맨 앞으로 이동

<Info>
  - 파일 타입 탭으로 **특정 형식만 빠르게 필터** — 예: `PDF` 탭만 클릭해 PDF 결과만 확인
  - 관련도가 낮아 보이면 **Top K 증가** 또는 **Dense / Sparse 모드 전환** 으로 재검색
  - 결과를 외부 분석·LLM 프롬프트에 넣으려면 **Copy All Results JSON** 활용
</Info>

<Warning>
  메타데이터는 JSON 문자열로 저장되므로 파싱 에러 시 기본 필드만 표시될 수 있습니다.
</Warning>