Внедрить автозаполнение

Функция автозаполнения Cloud Search помогает пользователю, предлагая слова при вводе поискового запроса. Например, это могут быть слова из названий документов, операторов поиска, значений операторов поиска или имён и адресов электронной почты из организации Google Workspace.

Функция автодополнения извлекает фразы из заголовков индексированных документов и, используя модель n-грамм , определяет варианты для отображения с помощью Suggest API. По умолчанию фразы из заголовков документов отображаются в функции автодополнения. Вы также можете пометить свойства схемы text и enum как is_suggestable , чтобы автоматически дополнять соответствующие имена и значения свойств.

Suggest API проверяет поисковый запрос на наличие подсказок о языке запроса, например, английском или испанском, и соответствующим образом расставляет приоритеты в результатах. Поле languageCode запроса также используется для улучшения подсказок, специфичных для конкретного языка.

Пример сценария

Например, предположим, у вас есть следующий источник данных, содержащий данные о фильмах:

  • Источник данных содержит 2 документа.
  • Каждый документ имеет заголовок ( ItemMetadata.title ) и два свойства: genre и characters .
  • Первый документ называется «Мстители: Война бесконечности» genre=science fiction , characters=Iron Man, Hulk
  • Второй документ называется «Гарри Поттер» genre=Adventure, Fantasy and персонажи — «Гермиона», «Гарри Поттер».

На рисунке 1 показано, как предложения автозаполнения извлекаются из заголовков документов, свойств и значений свойств.

Два документа и полученная ngram
Рисунок 1. Два документа и полученная n-грамма, используемая для автозаполнения

Из документа 1 извлекаем n-граммы (вплоть до триграмм) «Мстители», «Бесконечность», «Война», «Мстители Бесконечность», «Война Бесконечности», «Мстители Война Бесконечности». Аналогично из документа 2 генерируем «Гарри», «Поттер», «Гарри Поттер».

Предположим, при запросе к этому источнику данных пользователь начинает с ввода «h». Пользователю будут показаны следующие варианты:

  • Гарри
  • Гермиона
  • Халк
  • Гарри Поттер

Предположим, пользователь выбирает вариант автодополнения «Гермиона», и следующим нажатием клавиши пользователем будет символ «а». Варианты автодополнения, показанные пользователю, будут следующими:

  • Приключения Гермионы
  • Гермиона Экшн
  • Гермиона Мстители

Функция автодополнения пытается дополнить последнее набранное слово (или н-грамму). В предыдущем примере она просто расширяет «a» до «adventure», «action» и «avengers», поскольку текст, начинающийся с «hermione a», отсутствует. Такая подсказка называется «tail suggestion» (подсказка по хвосту); автодополнение выполняется только для последнего набранного слова/н-граммы.

Функция автозаполнения Cloud Search возвращает максимум 5 предложений из содержимого документа и 2 предложения по людям.

По умолчанию фразы из заголовков документов отображаются в автодополнении. Свойства схемы должны быть явно помечены как is_suggestable , чтобы API Suggest мог автоматически дополнить соответствующие имена и значения свойств.

Интеграция с API автозаполнения

Если вы используете поисковое приложение по умолчанию или встроенный поисковый виджет, функция автодополнения Cloud Search поддерживается изначально без дополнительных действий. Помните, что по умолчанию фразы из заголовков документов отображаются в автодополнении. Свойства схемы должны быть явно помечены как is_suggestable , чтобы API Suggest автоматически дополнял соответствующие имена и значения свойств.

Если вы создаете пользовательское поисковое приложение, функция автозаполнения доступна путем запроса конечных точек API /query/suggest .

Ограничения

Автозаполнение имеет следующие ограничения:

  • Ограничение фраз автозаполнения Cloud Search с помощью FilterOptions , определенных в схеме, не поддерживается, за исключением следующих встроенных фильтров: objectype , mimetype и type .

  • Предложения на основе истории запросов (поиски, выполненные пользователем ранее в поисковом приложении) не поддерживаются.

  • Максимальное количество объектов, отмеченных как is_suggestable , составляет 20. Этот лимит можно увеличить, обратившись в службу поддержки Cloud Search.

  • Автозаполнение оператора поиска недоступно для свойств с exact_match_with_operator .

  • Функция автозаполнения Cloud Search возвращает максимум 5 предложений из содержимого документа и 2 предложения по людям.

  • Функция автозаполнения Cloud Search предлагает фразы только из тех документов, к которым у пользователя есть доступ.