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'를 입력하면 다음과 같은 추천이 표시될 수 있습니다.
- CANNOT TRANSLATE
- 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개 반환합니다.
- 자동 완성 기능은 사용자가 액세스할 수 있는 문서에서만 구문을 추천합니다.