Настройка пользовательского автозаполнения

Статья
02/12/2019

Предупреждение

30 октября 2020 г. API-интерфейсы Поиск Bing перемещены из служб ИИ Azure в службы Поиск Bing. Эта документация приводится только для справки. Обновленную информацию см. в документации по API Поиска Bing. Инструкции по созданию ресурсов Azure для Поиска Bing см. в статье Создание ресурса для Поиска Bing с помощью Azure Marketplace.

Функция пользовательского автозаполнения возвращает список предлагаемых строк поисковых запросов, которые могут быть связаны с операцией поиска. Предлагаемые строки запросов основаны на частичной строке запроса пользователя, введенной в поле поиска. Список будет содержать не более 10 предложений.

Вы можете указать, возвращать ли только пользовательские предложения или также включать предложения Bing. Если включить предложения Bing, то пользовательские предложения будут предшествовать предложениям Bing. Если предоставить достаточно предложений, возможно, возвращаемый список предложений не будет содержать предложения Bing. Предложения Bing всегда ограничены контекстом экземпляра службы Пользовательского поиска.

Чтобы настроить предлагаемые поисковые запросы для экземпляра, щелкните вкладку Автозаполнение.

Примечание

Чтобы использовать эту функцию, необходимо подписаться на службу пользовательского поиска на соответствующем уровне (ознакомьтесь с ценами).

Для отображения предложений в конечной точке обслуживания (API или размещенном пользовательском интерфейсе) может потребоваться до 24 часов.

Включение предложений Bing

Чтобы включить предложения Bing, переключите ползунок Автоматические предложения Bing во включенное положение. Ползунок станет синим.

Добавление собственных предложений

Чтобы добавить собственные предлагаемые строки запросов, добавьте их в список в разделе User-defined suggestions (Пользовательские предложения). После добавления предложения в список нажмите клавишу ВВОД или щелкните значок + . Можно указать предложение на любом языке. Вы можете добавить до 5000 предлагаемых строк запросов.

Отправка предложений

Можно передать список предложений из файла. Этот файл должен содержать по одной строке поискового запроса в строке. Чтобы передать файл, щелкните значок передачи и выберите файл. Служба извлечет предложения из этого файла и добавит их в список.

Удаление предложений

Чтобы удалить предлагаемую строку запроса, щелкните значок удаления рядом с предложением, которое требуется удалить.

Блокирование предложений

Если вы включили предложения Bing, то можете добавить список строк поисковых запросов, которые служба Bing не должна вам возвращать. Чтобы добавить заблокированные строки запросов, щелкните Show blocked suggestions (Показать заблокированные предложения). Добавьте строку запроса в список и нажмите клавишу ВВОД или щелкните значок + . Вы можете добавить до 50 заблокированных предложений строк запросов.

Публикация или отмена

Изменения, которые вы вносите в экземпляр службы пользовательского поиска, выполняются на вкладке Конфигурация, поэтому вы можете проверить свои изменения. Когда вы уже внесли изменения и готовы к публикации, нажмите кнопку Опубликовать. Изменения не отражаются на рабочих конечных точках, пока не выполнена публикация.

Перед публикацией, если вы не хотите сохранять внесенные изменения, нажмите кнопку Отменить изменения. В случае отмены изменений активная конфигурация не меняется, а изменения на вкладке Конфигурация отменяются, чтобы значения соответствовали активному состоянию.

Примечание

Вступление в силу изменений конфигурации пользовательского автозаполнения может занять до 24 часов.

Включение автозаполнения в размещенном пользовательском интерфейсе

Чтобы включить предлагаемые строки запросов для размещенного пользовательского интерфейса, щелкните Hosted UI (Размещенный пользовательский интерфейс). Прокрутите вниз до раздела Additional Configuration (Дополнительная конфигурация). В разделе Веб-поиск выберите Вкл. для параметра Enable autosuggest (Включение автозаполнения). Чтобы включить автозаполнение, необходимо выбрать макет, который содержит поле поиска.

Вызов API автозаполнения

Чтобы получить предлагаемые строки запросов с помощью API пользовательского поиска Bing, отправьте запрос GET на приведенную ниже конечную точку.

GET https://api.cognitive.microsoft.com/bingcustomsearch/v7.0/Suggestions

Ответ будет содержать список объектов SearchAction с предлагаемыми строками запросов.

        {  
            "displayText" : "sailing lessons seattle",  
            "query" : "sailing lessons seattle",  
            "searchKind" : "CustomSearch"  
        },

Каждое из предложений содержит поля displayText и query. Поле displayText содержит предлагаемые строки запросов, которые вы можете поместить в раскрывающийся список для поля поиска.

Если пользователь выберет предложенную строку запроса из раскрывающегося списка, то при вызове API пользовательского поиска Bing будет использована строка запроса из поля query.

Дальнейшие действия

Get custom suggestion (Получение пользовательских предложений)
Search your custom instance (Поиск в пользовательском экземпляре)
Configure and consume custom hosted U (Настройка и использование размещаемого пользовательского интерфейса)

Поделиться через