> ## Documentation Index
> Fetch the complete documentation index at: https://craft-support.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Smart Search

> AI를 활용한 자연어 쿼리와 의미론적 이해로 스페이스를 검색하세요.

Smart Search는 워크스페이스 전체에서 정보를 찾는 데 AI의 힘을 활용합니다. 정확한 키워드 일치에만 의존하는 대신, Smart Search는 쿼리 뒤의 **의미**를 이해하여 문서에 정확한 단어가 없어도 관련 콘텐츠를 찾아줍니다.

## Smart Search란?

Smart Search는 자연어를 사용하여 전체 스페이스에서 정보를 찾도록 도와주는 AI 기반 의미론적 검색 기능입니다. 컨텍스트, 관계, 의도를 이해하여 기존 키워드 매칭을 넘어섭니다.

**일반 검색과의 주요 차이점:**

* **의미론적 이해** – 정확한 단어가 아닌 의미를 기반으로 콘텐츠를 찾습니다.
* **자연어 쿼리** – 자연스럽게 생각하는 방식으로 질문하세요.
* **문서 간 연결** – 서로 다른 문서 간의 관계를 이해합니다.
* **맥락적 관련성** – 키워드 빈도가 아닌 개념적 유사성을 기반으로 결과를 정렬합니다.

## Smart Search 사용 방법

Smart Search는 Craft Assistant 인터페이스를 통해 작동합니다.

<Steps>
  <Step>
    워크스페이스의 어느 뷰에서든 Craft Assistant를 여세요.
  </Step>

  <Step>
    자연어로 쿼리를 입력하세요. 질문하거나 찾고 있는 것을 설명하세요.
  </Step>

  <Step>
    Assistant가 AI를 사용하여 의도를 이해하고 관련 콘텐츠를 찾기 위해 스페이스를 검색합니다.
  </Step>

  <Step>
    문서 간의 컨텍스트와 연결이 포함된 결과를 검토하세요.
  </Step>
</Steps>

Assistant에서 스페이스 수준 쿼리를 사용하면 Smart Search가 자동으로 활성화됩니다. 별도의 토글이나 활성화 단계가 없습니다.

## 예시 쿼리

Smart Search는 키워드 매칭이 아닌 검색 뒤의 **의도**를 이해하는 데 탁월합니다.

### 개념 기반 검색

정확한 용어 대신 개념으로 검색할 수 있습니다.

* *"분기별 계획에 관한 문서 찾기"* – "분기별 계획"이 명시적으로 언급되지 않아도 계획, 목표, Q1/Q2/Q3/Q4와 관련된 콘텐츠를 찾습니다.
* *"마케팅 캠페인과 관련된 모든 것 보여주기"* – "프로모션", "아웃리치", "런칭"과 같은 동의어를 이해합니다.
* *"작년에 채용에 대해 무엇을 작성했나요?"* – 시간적 이해와 주제적 이해를 결합합니다.

### 작업 및 프로젝트 쿼리

업무 상태와 다음 단계를 물어보세요.

* *"프로젝트 Y에서 아직 열려 있는 작업은 무엇인가요?"*
* *"새 기능에 대해 우리가 내린 모든 결정을 보여주세요"*
* *"디자인 팀과의 미팅 메모 찾기"*

### 탐색적 검색

잊었을 수 있는 연결을 발견하세요.

* *"원격 근무에 대해 무엇을 작성했나요?"*
* *"예산 논의에 대한 모든 참조 찾기"*
* *"신규 팀원 온보딩과 관련된 콘텐츠 보여주기"*

## Smart Search가 다르게 작동하는 방식

### 기존 키워드 검색

**쿼리:** "프로젝트 계획"

**찾는 것:** "프로젝트"와 "계획" 단어가 정확히 포함된 문서

**놓치는 것:** "로드맵", "전략 세션", "분기별 목표"에 관한 콘텐츠 (다른 단어를 사용하는 관련 개념)

### Smart Search

**쿼리:** *"프로젝트 계획에 관한 문서 찾기"*

**찾는 것:**

* "프로젝트 계획"이 포함된 문서
* "로드맵" 및 "마일스톤"에 관한 문서
* "Q4 전략"에 관한 미팅 메모
* "계획 단계" 항목이 있는 작업 목록

**이유:** AI가 다른 용어를 사용하더라도 이들이 의미론적으로 관련된 개념임을 이해합니다.

## 사용량 및 모델

Smart Search는 고급 언어 모델을 사용하여 쿼리를 이해하고 콘텐츠를 분석하기 때문에 AI 할당량을 사용합니다.

**사용 모델:** Smart Search는 스페이스 수준 의미론적 쿼리에 속도와 이해 사이의 균형을 맞추기 위해 일반적으로 **Fast** 모델(Claude Haiku 4.5)을 사용합니다.

사용량은 쿼리 복잡도와 스페이스 크기에 따라 달라집니다. Assistant 메뉴의 **사용량 및 제한**에서 현재 사용량을 확인할 수 있습니다.

<Info title="사용량 최적화">
  정확한 용어를 알고 있는 단순 키워드 검색에는 Smart Search 대신 일반 검색(`Cmd+F` / `Ctrl+F`)을 사용하여 사용량을 아끼세요.
</Info>

## Smart Search vs. 일반 검색 사용 시기

**Smart Search를 사용하세요:**

* 문서에서 사용된 정확한 단어를 모를 때
* 개념적으로 관련된 콘텐츠를 찾고 싶을 때
* 여러 문서에 걸쳐 주제를 탐색할 때
* 서로 다른 콘텐츠 간의 연결을 이해해야 할 때

**일반 검색을 사용하세요:**

* 정확한 키워드나 구문을 알고 있을 때
* 특정 문서 제목을 찾을 때
* AI 할당량을 사용하지 않고 빠른 결과를 원할 때
* 날짜, 이름, ID와 같은 특정 데이터를 검색할 때

## 플랫폼 지원 현황

Smart Search는 Mac, iPad, iPhone, Windows 및 Web에서 Craft Assistant를 통해 **스페이스 수준**으로 사용할 수 있습니다. 모든 문서 유형, 컬렉션, 작업, 캘린더 뷰에서 작동합니다.

## 개인 정보 보호 및 데이터

Smart Search는 모든 Craft Assistant 기능과 동일한 개인 정보 보호 원칙을 따릅니다.

* 검색 쿼리는 Craft 서버에 **저장되지 않습니다**.
* 콘텐츠는 단일 요청 처리 기간 동안만 AI 모델 제공업체에 전송됩니다.
* 데이터는 AI 모델 학습에 **절대 사용되지 않습니다**.
* 사용량 추적을 위해 토큰 사용량과 비용만 기록됩니다.

검색 기록은 기기에 로컬로 유지되며 절대 동기화되거나 저장되지 않습니다.

## 현재 제한 사항

Smart Search는 의미론적 이해를 위해 설계되었지만 몇 가지 사항을 염두에 두어야 합니다.

* **스페이스 수준 전용** – Smart Search는 스페이스 수준에서 작동하며 단일 문서 내에서는 작동하지 않습니다 (그 경우 문서 검색 또는 찾기를 사용하세요).
* **AI 할당량 사용** – 일반 검색과 달리 Smart Search는 사용 한도에 포함됩니다.
* **처리 시간** – 특히 복잡한 쿼리의 경우 기존 키워드 검색보다 더 오래 걸릴 수 있습니다.

## 더 나은 결과를 위한 팁

### 필요한 것을 구체적으로 설명하세요

모호한 쿼리 대신 컨텍스트를 제공하세요.

* ❌ *"프로젝트에 관한 것 찾기"*
* ✅ *"웹사이트 리디자인 프로젝트와 관련된 모든 미팅 메모와 결정 사항 찾기"*

### 관련 있을 때 시간 참조를 사용하세요

AI는 시간적 컨텍스트를 이해할 수 있습니다.

* *"지난 분기에 예산에 대해 무엇을 작성했나요?"*
* *"새 기능에 관한 최근 메모 보여주기"*
* *"6월경 컨퍼런스에 관한 문서 찾기"*

### 여러 개념을 결합하세요

Smart Search는 복잡하고 다면적인 쿼리를 처리할 수 있습니다.

* *"모바일 팀을 위한 디자이너 채용과 관련된 작업과 메모 찾기"*
* *"마케팅 전략과 예산 제약을 모두 논의하는 문서 보여주기"*

### 쿼리를 다듬으세요

첫 번째 결과가 정확하지 않다면 다시 표현해 보세요.

* 더 많은 컨텍스트 추가: *"...특히 국제 시장에 대해"*
* 더 구체적으로: *"Q1 미팅 메모" → "1월과 2월의 주간 스탠드업 메모"*
* 다른 용어 사용: *"클라이언트 피드백" → "고객 불만 및 기능 요청"*

## 관련 문서

<CardGroup cols={2}>
  <Card title="검색 및 빠른 열기" href="/ko/organize-and-find/search">
    기존 키워드 검색 및 빠른 열기 탐색 알아보기
  </Card>

  <Card title="Craft Assistant 사용하기" href="/ko/ai-assistant/using">
    AI 기반 대화 및 쿼리 시작하기
  </Card>

  <Card title="AI 모델 선택하기" href="/ko/ai-assistant/models">
    다양한 작업에 사용할 모델 이해하기
  </Card>

  <Card title="사용량 및 제한" href="/ko/ai-assistant/usage">
    AI 사용량, 추가 구매, 할당량 모니터링 알아보기
  </Card>
</CardGroup>