Documents - Autocomplete Post

Ссылка

Служба:: Search Service

Версия API:: 2024-07-01

Автозаполнение неполных терминов запросов на основе входного текста и соответствующих терминов в индексе.

POST {endpoint}/indexes('{indexName}')/docs/search.post.autocomplete?api-version=2024-07-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
endpoint	path	True	string	URL-адрес конечной точки службы поиска.
indexName	path	True	string	Имя индекса.
api-version	query	True	string	Версия клиентского API.

Заголовок запроса

Имя	Обязательно	Тип	Описание
x-ms-client-request-id		string uuid	Идентификатор отслеживания, отправляемый запросом на отладку.

Текст запроса

Имя	Обязательно	Тип	Описание
search	True	string	Текст поиска, на котором будут основываться результаты автозаполнения.
suggesterName	True	string	Имя средства предложения, указанное в коллекции предлагаемых элементов, которые входят в определение индекса.
autocompleteMode		AutocompleteMode	Задает режим автозаполнения. Значение по умолчанию — oneTerm. Используйте "twoTerms", чтобы получить мешки и oneTermWithContext, чтобы использовать текущий контекст при создании автоматически завершенных терминов.
filter		string	Выражение OData, которое фильтрует документы, используемые для создания завершенных терминов для результата автозаполнения.
fuzzy		boolean	Значение, указывающее, следует ли использовать нечеткое сопоставление для запроса автозаполнения. Значение по умолчанию — false. Если задано значение true, запрос автоматически завернет термины, даже если в тексте поиска есть замещающий или отсутствующий символ. Хотя это обеспечивает более высокую производительность в некоторых сценариях, это приводит к снижению производительности, так как нечеткие запросы автозаполнения медленнее и потребляют больше ресурсов.
highlightPostTag		string	Тег строки, добавляемый для выделения попаданий. Необходимо задать с выделенным значениемPreTag. Если опущено, выделение попаданий отключено.
highlightPreTag		string	Тег строки, который предопределен для выделения попаданий. Необходимо задать с помощью highlightPostTag. Если опущено, выделение попаданий отключено.
minimumCoverage		number	Число от 0 до 100, указывающее процент индекса, который должен охватываться запросом автозаполнения, чтобы запрос сообщалось как успешно. Этот параметр может быть полезен для обеспечения доступности поиска даже для служб с одной репликой. Значение по умолчанию — 80.
searchFields		string	Разделенный запятыми список имен полей, которые следует учитывать при запросе автоматически завершенных терминов. Целевые поля должны быть включены в указанный средство предложения.
top		integer	Количество полученных автоматически завершенных терминов. Это должно быть значение от 1 до 100. Значение по умолчанию — 5.

Ответы

Имя	Тип	Описание
200 OK	AutocompleteResult	Ответ, содержащий предлагаемые термины запроса, которые завершают частичные входные данные.
Other Status Codes	ErrorResponse	Ответ на ошибку.

Примеры

SearchIndexAutocompleteDocumentsPost

Образец запроса

HTTP

POST https://myservice.search.windows.net/indexes('myindex')/docs/search.post.autocomplete?api-version=2024-07-01

{
  "autocompleteMode": "oneTerm",
  "search": "washington medic",
  "suggesterName": "sg",
  "filter": "search.in(docId,'101,102,105')",
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "minimumCoverage": 80,
  "searchFields": "title,description",
  "top": 10
}

Пример ответа

Код состояния:: 200

[
  {
    "text": "medicaid",
    "queryPlusText": "washington medicaid"
  },
  {
    "text": "medicare",
    "queryPlusText": "washington medicare"
  },
  {
    "text": "medicine",
    "queryPlusText": "washington medicine"
  }
]

Определения

Имя	Описание
AutocompleteItem	Результат запросов автозавершения.
AutocompleteMode	Задает режим автозаполнения. Значение по умолчанию — oneTerm. Используйте "twoTerms", чтобы получить мешки и oneTermWithContext, чтобы использовать текущий контекст при создании терминов автозаполнения.
AutocompleteRequest	Параметры для нечеткого сопоставления и других поведения запросов автозаполнения.
AutocompleteResult	Результат запроса автозаполнения.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку

AutocompleteItem

Результат запросов автозавершения.

Имя	Тип	Описание
queryPlusText	string	Запрос вместе с завершенным термином.
text	string	Завершенный термин.

AutocompleteMode

Задает режим автозаполнения. Значение по умолчанию — oneTerm. Используйте "twoTerms", чтобы получить мешки и oneTermWithContext, чтобы использовать текущий контекст при создании терминов автозаполнения.

Имя	Тип	Описание
oneTerm	string	Предлагается только один термин. Если запрос имеет два термина, выполняется только последний термин. Например, если вход является "вашингтон-медик", предложенные термины могут включать "medicaid", "medicare" и "медицину".
oneTermWithContext	string	Завершает последний термин в запросе с двумя или более терминами, где последние два термина являются фразой, которая существует в индексе. Например, если вход является "вашингтон медиком", предложенные термины могут включать "вашингтон medicaid" и "вашингтон медицинский".
twoTerms	string	Будут предложены соответствующие двухсрочные фразы в индексе. Например, если входные данные являются "медиками", предложенные термины могут включать "покрытие medicare" и "медицинский помощник".

AutocompleteRequest

Параметры для нечеткого сопоставления и других поведения запросов автозаполнения.

Имя	Тип	Описание
autocompleteMode	AutocompleteMode	Задает режим автозаполнения. Значение по умолчанию — oneTerm. Используйте "twoTerms", чтобы получить мешки и oneTermWithContext, чтобы использовать текущий контекст при создании автоматически завершенных терминов.
filter	string	Выражение OData, которое фильтрует документы, используемые для создания завершенных терминов для результата автозаполнения.
fuzzy	boolean	Значение, указывающее, следует ли использовать нечеткое сопоставление для запроса автозаполнения. Значение по умолчанию — false. Если задано значение true, запрос автоматически завернет термины, даже если в тексте поиска есть замещающий или отсутствующий символ. Хотя это обеспечивает более высокую производительность в некоторых сценариях, это приводит к снижению производительности, так как нечеткие запросы автозаполнения медленнее и потребляют больше ресурсов.
highlightPostTag	string	Тег строки, добавляемый для выделения попаданий. Необходимо задать с выделенным значениемPreTag. Если опущено, выделение попаданий отключено.
highlightPreTag	string	Тег строки, который предопределен для выделения попаданий. Необходимо задать с помощью highlightPostTag. Если опущено, выделение попаданий отключено.
minimumCoverage	number	Число от 0 до 100, указывающее процент индекса, который должен охватываться запросом автозаполнения, чтобы запрос сообщалось как успешно. Этот параметр может быть полезен для обеспечения доступности поиска даже для служб с одной репликой. Значение по умолчанию — 80.
search	string	Текст поиска, на котором будут основываться результаты автозаполнения.
searchFields	string	Разделенный запятыми список имен полей, которые следует учитывать при запросе автоматически завершенных терминов. Целевые поля должны быть включены в указанный средство предложения.
suggesterName	string	Имя средства предложения, указанное в коллекции предлагаемых элементов, которые входят в определение индекса.
top	integer	Количество полученных автоматически завершенных терминов. Это должно быть значение от 1 до 100. Значение по умолчанию — 5.

AutocompleteResult

Результат запроса автозаполнения.

Имя	Тип	Описание
@search.coverage	number	Значение, указывающее процент индекса, который считался запросом автозаполнения, или значение NULL, если минимальное значениеCoverage не было указано в запросе.
value	AutocompleteItem[]	Список возвращаемых автоматически завершенных элементов.

ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.

Имя	Тип	Описание
info	object	Дополнительные сведения.
type	string	Дополнительный тип сведений.

ErrorDetail

Сведения об ошибке.

Имя	Тип	Описание
additionalInfo	ErrorAdditionalInfo[]	Дополнительные сведения об ошибке.
code	string	Код ошибки.
details	ErrorDetail[]	Сведения об ошибке.
message	string	Сообщение об ошибке.
target	string	Целевой объект ошибки.

ErrorResponse

Ответ на ошибку

Имя	Тип	Описание
error	ErrorDetail	Объект ошибки.

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