Google Cloud Search 자동 완성 기능은 사용자가 검색어를 입력할 때 단어를 추천하여 사용자를 지원합니다. 예를 들어 문서 제목의 단어, 검색 연산자 또는 Google Workspace 조직의 이름이 추천될 수 있습니다.
자동 완성 기능은 색인이 생성된 문서 제목에서 구문을 추출하고
N-그램 모델을 사용하여 추천을 결정합니다.
Suggest API를 통해 기본적으로 자동 완성 기능은 문서 제목의 구문을 표시합니다. 텍스트 및 enum 스키마 속성을 is_suggestable로 표시하여 속성 이름과 값을 자동 완성할 수도 있습니다.
Suggest API는 영어 또는 스페인어와 같은 언어 힌트가 포함된 검색어를 검사하고 결과의 우선순위를 지정합니다. 요청의
languageCode
필드는 언어별 추천을 개선하기도 합니다.
예시 시나리오
영화 데이터가 포함된 데이터 소스를 예로 들어보겠습니다.
- 데이터 소스에는 두 개의 문서가 포함되어 있습니다.
- 각 문서에는 제목(
ItemMetadata.title)과 두 가지 속성(genre및characters)이 있습니다. - 문서 1 제목: 'Avengers Infinity War',
genre=science fiction,characters=Iron Man, Hulk - 문서 2 제목: 'Harry Potter',
genre=Adventure, Fantasy,characters=Hermione, Harry Potter
그림 1은 자동 완성 기능이 추천을 추출하는 방법을 보여줍니다.
문서 1에서 모델은 'Avengers', 'Infinity', 'War', 'Avengers Infinity', 'Infinity War', 'Avengers Infinity War'와 같은 N-그램 (트라이그램까지)을 추출합니다. 문서 2에서는 'Harry', 'Potter', 'Harry Potter'를 생성합니다.
사용자가 이 데이터 소스를 쿼리할 때 'h'를 입력하면 다음과 같은 추천이 표시될 수 있습니다.
- 해리
- Hermione
- Hulk
- 해리 포터
사용자가 'Hermione'을 선택한 후 'a'를 입력하면 자동 완성 기능에서 다음을 표시할 수 있습니다.
- Hermione Adventure
- Hermione Action
- Hermione Avengers
자동 완성 기능은 입력된 마지막 단어 또는 N-그램을 완성하려고 시도합니다. 이 예에서는 색인이 생성된 텍스트가 'hermione a'로 시작되지 않으므로 'a'를 'adventure', 'action', 'avengers'로 확장합니다. 이것은 꼬리 추천입니다.
Cloud Search 자동 완성 기능은 문서 콘텐츠에서 최대 5개의 추천과 2개의 사람 추천을 반환합니다.
기본적으로 자동 완성 기능은 문서 제목의 구문을 표시합니다. Suggest API가 속성 이름과 값을 자동 완성하려면 스키마 속성을 명시적으로 is_suggestable로 표시해야 합니다.
Suggest API와 통합
기본 검색 애플리케이션 또는 내장 가능한 검색 위젯을 사용하는 경우 Cloud Search는 자동 완성을 기본적으로 지원합니다. 자동 완성을 사용하려면 스키마 속성을 is_suggestable로 표시해야 합니다.
커스텀 검색 애플리케이션을 빌드하는 경우 /query/suggest API 엔드포인트를 사용하여 자동 완성을 사용할 수 있습니다.
제한사항
자동 완성에는 다음과 같은 제한사항이 있습니다.
FilterOptions를 사용하여 자동 완성 구문을 제한하는 것은objecttype및mimetype과 같은 기본 제공 필터를 제외하고 지원되지 않습니다.- 사용자의 쿼리 기록을 기반으로 한 추천은 지원되지 않습니다.
- 최대 20개의 속성을
is_suggestable로 표시할 수 있습니다. 이 한도를 늘리려면 Cloud Search 지원팀에 문의하세요. exact_match_with_operator가 있는 속성에는 검색 연산자 자동 완성을 사용할 수 없습니다.- 자동 완성 기능은 최대 5개의 문서 콘텐츠 추천과 2개의 사람 추천을 반환합니다.
- 자동 완성 기능은 사용자가 액세스할 수 있는 문서에서만 구문을 추천합니다.