> ## 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.

> 현재 Workspace의 채팅 메시지를 **의미 기반(벡터 유사도)** 으로 검색합니다

# Search

# Search (검색)

**경로**: 좌측 사이드바 상단 **Search** 버튼 **경로**: 좌측 사이드바 상단 **Search** 버튼 → 팝업 창

<Frame>
  <img src="https://mintcdn.com/dnotitia-328335e7/3mgjFAVO5t1rKplH/images/image-27.png?fit=max&auto=format&n=3mgjFAVO5t1rKplH&q=85&s=4c446dfbaee37dae7a8b0145308caba2" alt="Image" width="1375" height="1231" data-path="images/image-27.png" />
</Frame>

현재 Workspace의 채팅 메시지를 **의미 기반(벡터 유사도)** 으로 검색합니다.

## UI 구성

* **검색어 입력창** — 자연어 질의
* **Role 드롭다운** — 검색 대상 메시지 작성자
* `User` — 사용자가 입력한 메시지
* `Assistant` — 에이전트 응답
* (확장) `System`
* **Search 버튼** — 실행

<Info>
  단순 키워드 매칭이 아니라 임베딩 기반 의미 검색이므로, 검색어가 실제 메시지에 없어도 관련 내용이면 결과에 나타납니다.
</Info>

## 결과 형식

각 결과 카드:

| 항목                     | 설명                                 |
| ---------------------- | ---------------------------------- |
| **Role 배지**            | `user` / `assistant`               |
| **Similarity: N%**     | 벡터 코사인 유사도 (0\~100%)               |
| **메시지 본문**             | 매칭된 메시지 텍스트                        |
| **Session: `{id...}`** | 해당 메시지가 속한 세션 ID (부분)              |
| **- N characters**     | 메시지 길이                             |
| **타임스탬프**              | 작성 일시 (예: `2026년 4월 17일 오전 08:03`) |

결과 카드를 클릭하면 해당 세션의 그 메시지로 이동합니다.

## 유사도 해석

| 점수     | 의미                |
| ------ | ----------------- |
| 80% 이상 | 거의 동일한 내용         |
| 60–80% | 직접적으로 관련          |
| 40–60% | 간접적 관련 / 유사 주제    |
| 40% 미만 | 약한 관련성 (noise 가능) |

## 제한 사항

* 검색 범위는 **현재 Workspace**. 여러 Workspace 전체 검색은 불가.
* 첨부 파일 내용은 별도 **Analytics 패널** 의 `search_documents` 도구로 검색.
* 필터(기간/세션별)는 현재 미제공 — 향후 추가 예정.