Smart Search는 워크스페이스 전체에서 정보를 찾는 데 AI의 힘을 활용합니다. 정확한 키워드 일치에만 의존하는 대신, Smart Search는 쿼리 뒤의 의미를 이해하여 문서에 정확한 단어가 없어도 관련 콘텐츠를 찾아줍니다.Documentation Index
Fetch the complete documentation index at: https://craft-support.mintlify.app/llms.txt
Use this file to discover all available pages before exploring further.
Smart Search란?
Smart Search는 자연어를 사용하여 전체 스페이스에서 정보를 찾도록 도와주는 AI 기반 의미론적 검색 기능입니다. 컨텍스트, 관계, 의도를 이해하여 기존 키워드 매칭을 넘어섭니다. 일반 검색과의 주요 차이점:- 의미론적 이해 – 정확한 단어가 아닌 의미를 기반으로 콘텐츠를 찾습니다.
- 자연어 쿼리 – 자연스럽게 생각하는 방식으로 질문하세요.
- 문서 간 연결 – 서로 다른 문서 간의 관계를 이해합니다.
- 맥락적 관련성 – 키워드 빈도가 아닌 개념적 유사성을 기반으로 결과를 정렬합니다.
Smart Search는 Craft v3.3.2에서 도입되었으며 AI 사용 할당량이 필요합니다.
Smart Search 사용 방법
Smart Search는 Craft Assistant 인터페이스를 통해 작동합니다.
Assistant에서 스페이스 수준 쿼리를 사용하면 Smart Search가 자동으로 활성화됩니다. 별도의 토글이나 활성화 단계가 없습니다.
예시 쿼리
Smart Search는 키워드 매칭이 아닌 검색 뒤의 의도를 이해하는 데 탁월합니다.개념 기반 검색
정확한 용어 대신 개념으로 검색할 수 있습니다.- “분기별 계획에 관한 문서 찾기” – “분기별 계획”이 명시적으로 언급되지 않아도 계획, 목표, Q1/Q2/Q3/Q4와 관련된 콘텐츠를 찾습니다.
- “마케팅 캠페인과 관련된 모든 것 보여주기” – “프로모션”, “아웃리치”, “런칭”과 같은 동의어를 이해합니다.
- “작년에 채용에 대해 무엇을 작성했나요?” – 시간적 이해와 주제적 이해를 결합합니다.
작업 및 프로젝트 쿼리
업무 상태와 다음 단계를 물어보세요.- “프로젝트 Y에서 아직 열려 있는 작업은 무엇인가요?”
- “새 기능에 대해 우리가 내린 모든 결정을 보여주세요”
- “디자인 팀과의 미팅 메모 찾기”
탐색적 검색
잊었을 수 있는 연결을 발견하세요.- “원격 근무에 대해 무엇을 작성했나요?”
- “예산 논의에 대한 모든 참조 찾기”
- “신규 팀원 온보딩과 관련된 콘텐츠 보여주기”
Smart Search가 다르게 작동하는 방식
기존 키워드 검색
쿼리: “프로젝트 계획” 찾는 것: “프로젝트”와 “계획” 단어가 정확히 포함된 문서 놓치는 것: “로드맵”, “전략 세션”, “분기별 목표”에 관한 콘텐츠 (다른 단어를 사용하는 관련 개념)Smart Search
쿼리: “프로젝트 계획에 관한 문서 찾기” 찾는 것:- “프로젝트 계획”이 포함된 문서
- “로드맵” 및 “마일스톤”에 관한 문서
- “Q4 전략”에 관한 미팅 메모
- “계획 단계” 항목이 있는 작업 목록
사용량 및 모델
Smart Search는 고급 언어 모델을 사용하여 쿼리를 이해하고 콘텐츠를 분석하기 때문에 AI 할당량을 사용합니다. 사용 모델: Smart Search는 스페이스 수준 의미론적 쿼리에 속도와 이해 사이의 균형을 맞추기 위해 일반적으로 Fast 모델(Claude Haiku 4.5)을 사용합니다. 사용량은 쿼리 복잡도와 스페이스 크기에 따라 달라집니다. Assistant 메뉴의 사용량 및 제한에서 현재 사용량을 확인할 수 있습니다.정확한 용어를 알고 있는 단순 키워드 검색에는 Smart Search 대신 일반 검색(
Cmd+F / Ctrl+F)을 사용하여 사용량을 아끼세요.Smart Search vs. 일반 검색 사용 시기
Smart Search를 사용하세요:- 문서에서 사용된 정확한 단어를 모를 때
- 개념적으로 관련된 콘텐츠를 찾고 싶을 때
- 여러 문서에 걸쳐 주제를 탐색할 때
- 서로 다른 콘텐츠 간의 연결을 이해해야 할 때
- 정확한 키워드나 구문을 알고 있을 때
- 특정 문서 제목을 찾을 때
- AI 할당량을 사용하지 않고 빠른 결과를 원할 때
- 날짜, 이름, ID와 같은 특정 데이터를 검색할 때
플랫폼 지원 현황
- macOS
- iOS
- Windows
- Web
Smart Search는 Craft Assistant를 통해 스페이스 수준에서 완전히 사용 가능합니다. 모든 문서 유형, 컬렉션, 작업, 캘린더 뷰에서 작동합니다.
개인 정보 보호 및 데이터
Smart Search는 모든 Craft Assistant 기능과 동일한 개인 정보 보호 원칙을 따릅니다.- 검색 쿼리는 Craft 서버에 저장되지 않습니다.
- 콘텐츠는 단일 요청 처리 기간 동안만 AI 모델 제공업체에 전송됩니다.
- 데이터는 AI 모델 학습에 절대 사용되지 않습니다.
- 사용량 추적을 위해 토큰 사용량과 비용만 기록됩니다.
현재 제한 사항
Smart Search는 의미론적 이해를 위해 설계되었지만 몇 가지 사항을 염두에 두어야 합니다.- 스페이스 수준 전용 – Smart Search는 스페이스 수준에서 작동하며 단일 문서 내에서는 작동하지 않습니다 (그 경우 문서 검색 또는 찾기를 사용하세요).
- AI 할당량 사용 – 일반 검색과 달리 Smart Search는 사용 한도에 포함됩니다.
- 플랫폼 지원 – 현재 Mac 및 iOS에서 사용 가능하며, Windows 및 Web에서는 곧 제공될 예정입니다.
- 처리 시간 – 특히 복잡한 쿼리의 경우 기존 키워드 검색보다 더 오래 걸릴 수 있습니다.
더 나은 결과를 위한 팁
필요한 것을 구체적으로 설명하세요
모호한 쿼리 대신 컨텍스트를 제공하세요.- ❌ “프로젝트에 관한 것 찾기”
- ✅ “웹사이트 리디자인 프로젝트와 관련된 모든 미팅 메모와 결정 사항 찾기”
관련 있을 때 시간 참조를 사용하세요
AI는 시간적 컨텍스트를 이해할 수 있습니다.- “지난 분기에 예산에 대해 무엇을 작성했나요?”
- “새 기능에 관한 최근 메모 보여주기”
- “6월경 컨퍼런스에 관한 문서 찾기”
여러 개념을 결합하세요
Smart Search는 복잡하고 다면적인 쿼리를 처리할 수 있습니다.- “모바일 팀을 위한 디자이너 채용과 관련된 작업과 메모 찾기”
- “마케팅 전략과 예산 제약을 모두 논의하는 문서 보여주기”
쿼리를 다듬으세요
첫 번째 결과가 정확하지 않다면 다시 표현해 보세요.- 더 많은 컨텍스트 추가: ”…특히 국제 시장에 대해”
- 더 구체적으로: “Q1 미팅 메모” → “1월과 2월의 주간 스탠드업 메모”
- 다른 용어 사용: “클라이언트 피드백” → “고객 불만 및 기능 요청”
관련 문서
검색 및 빠른 열기
기존 키워드 검색 및 빠른 열기 탐색 알아보기
Craft Assistant 사용하기
AI 기반 대화 및 쿼리 시작하기
AI 모델 선택하기
다양한 작업에 사용할 모델 이해하기
사용량 및 제한
AI 사용량, 추가 구매, 할당량 모니터링 알아보기