Documents - Search Post

Служба:: Search Service

Версия API:: 2024-09-01-preview

Ищет документы в индексе.

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

Параметры URI

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

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

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

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

Имя	Тип	Описание
answers	QueryAnswerType	Значение, указывающее, следует ли возвращать ответы как часть ответа поиска.
captions	QueryCaptionType	Значение, указывающее, должны ли возвращаться заголовки в ответе на поиск.
count	boolean	Значение, указывающее, следует ли получить общее количество результатов. Значение по умолчанию — false. Если задать значение true, это значение может повлиять на производительность. Обратите внимание, что возвращаемое число является приблизительный.
debug	QueryDebugMode	Включает средство отладки, которое можно использовать для дальнейшего изучения повторных результатов.
facets	string[]	Список выражений аспектов, применяемых к поисковому запросу. Каждое выражение аспектов содержит имя поля, за которым следует список пар name:value, разделенный запятыми.
filter	string	Выражение OData $filter, применяемое к поисковому запросу.
highlight	string	Список имен полей, разделенных запятыми, используемых для выделения попаданий. Для выделения попаданий можно использовать только поля, доступные для поиска.
highlightPostTag	string	Тег строки, добавляемый для выделения попаданий. Необходимо задать с выделенным значениемPreTag. Значение по умолчанию — </em>.
highlightPreTag	string	Тег строки, который предопределен для выделения попаданий. Необходимо задать с помощью highlightPostTag. По умолчанию используется <em>.
hybridSearch	HybridSearch	Параметры запроса для настройки поведения гибридного поиска.
minimumCoverage	number (double)	Число от 0 до 100, указывающее процент индекса, который должен охватываться поисковым запросом, чтобы запрос сообщалось успешно. Этот параметр может быть полезен для обеспечения доступности поиска даже для служб с одной репликой. Значение по умолчанию — 100.
orderby	string	Разделенный запятыми список выражений OData $orderby, по которым выполняется сортировка результатов. Каждое выражение может быть именем поля или вызовом функций geo.distance() или search.score(). За каждым выражением можно следовать какc, чтобы указать возрастание, или desc, чтобы указать убывание. Значение по умолчанию — по возрастанию. Связи будут нарушены с помощью показателей соответствия документов. Если $orderby не указано, порядок сортировки по умолчанию убывает по оценке соответствия документа. Существует не более 32 предложений $orderby.
queryLanguage	QueryLanguage	Значение, указывающее язык поискового запроса.
queryType	QueryType	Значение, указывающее синтаксис поискового запроса. Значение по умолчанию — simple. Используйте значение full, если запрос использует синтаксис запроса Lucene.
scoringParameters	string[]	Список значений параметров, используемых в функциях оценки (например, referencePointParameter) с использованием значений имени формата. Например, если профиль оценки определяет функцию с параметром с именем mylocation, строка параметра будет "mylocation--122.2,44.8" (без кавычки).
scoringProfile	string	Имя профиля оценки для оценки показателей для сопоставления документов для сортировки результатов.
scoringStatistics	ScoringStatistics	Значение, указывающее, требуется ли вычислить статистику оценки (например, частоту документов) глобально для более согласованной оценки или локальной задержки. Значение по умолчанию — local. Используйте "global" для агрегирования статистики оценки глобально перед оценкой. Использование глобальной статистики оценки может увеличить задержку поисковых запросов.
search	string	Выражение запроса полнотекстового поиска; Используйте "*" или опустить этот параметр для сопоставления всех документов.
searchFields	string	Список имен полей, разделенных запятыми, в которых выполняется полнотекстовый поиск. При использовании поля поиска (fieldName:searchExpression) в полном запросе Lucene имена полей каждого поля выражения поиска имеют приоритет над именами полей, перечисленными в этом параметре.
searchMode	SearchMode	Значение, указывающее, должны ли совпадать все или все условия поиска, чтобы подсчитать документ как совпадение.
select	string	Список извлекаемых полей с разделием запятыми. Если не указано, все поля, помеченные как извлекаемые в схеме, включаются.
semanticConfiguration	string	Имя семантической конфигурации, которая будет использоваться при обработке документов для запросов семантики типа.
semanticErrorHandling	SemanticErrorMode	Позволяет пользователю выбрать, должен ли семантический вызов завершиться сбоем (по умолчанию или текущему поведению) или возвращать частичные результаты.
semanticFields	string	Разделенный запятыми список имен полей, используемых для семантического ранжирования.
semanticMaxWaitInMilliseconds	integer (int32) minimum: 700	Позволяет пользователю задать верхнюю границу на время, которое требуется для завершения обработки семантического обогащения до сбоя запроса.
semanticQuery	string	Позволяет задать отдельный поисковый запрос, который будет использоваться исключительно для семантического повторения, семантических подписей и семантических ответов. Полезно для сценариев, когда требуется использовать различные запросы между базовым этапом извлечения и ранжирования, а также семантической фазой L2.
sessionId	string	Значение, используемое для создания липкого сеанса, которое может помочь получить более согласованные результаты. До тех пор, пока используется тот же идентификатор сеанса, будет предпринята попытка попытаться выбрать тот же набор реплик. Будьте осторожны, что повторное использование одних и того же значения sessionID многократно может повлиять на балансировку нагрузки запросов между репликами и негативно повлиять на производительность службы поиска. Значение, используемое в качестве sessionId, не может начинаться с символа "_".
skip	integer (int32)	Количество пропущенных результатов поиска. Это значение не может быть больше 100 000. Если вам нужно сканировать документы в последовательности, но не удается пропустить из-за этого ограничения, рекомендуется использовать orderby на полностью упорядоченном ключе и фильтровать с помощью запроса диапазона.
speller	QuerySpellerType	Значение, указывающее тип орфографии, используемый для исправления отдельных условий запроса поиска.
top	integer (int32)	Количество полученных результатов поиска. Это можно использовать в сочетании с $skip для реализации разбиения по страницам на стороне клиента результатов поиска. Если результаты усечены из-за разбиения на страницы на стороне сервера, ответ будет содержать маркер продолжения, который можно использовать для выдачи другого запроса поиска на следующую страницу результатов.
vectorFilterMode	VectorFilterMode	Определяет, применяются ли фильтры до или после выполнения векторного поиска. Значение по умолчанию — preFilter для новых индексов.
vectorQueries	VectorQuery[]: RawVectorQuery[] VectorizableTextQuery[] VectorizableImageUrlQuery[] VectorizableImageBinaryQuery[]	Параметры запроса для векторных и гибридных поисковых запросов.

Ответы

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

Примеры

SearchIndexSearchDocumentsPost

SearchIndexSearchDocumentsSemanticPost

SearchIndexSearchDocumentsPost

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

HTTP

POST https://previewexampleservice.search.windows.net/indexes('preview-test')/docs/search.post.search?api-version=2024-09-01-preview


{
  "count": true,
  "facets": [
    "ownerId"
  ],
  "filter": "category eq 'purple' or category eq 'pink'",
  "highlight": "category",
  "highlightPostTag": "</em>",
  "highlightPreTag": "</em>",
  "orderby": "id desc",
  "queryType": "simple",
  "scoringStatistics": "global",
  "sessionId": "mysessionid",
  "scoringParameters": [
    "categoryTag:desiredCategoryValue"
  ],
  "scoringProfile": "stringFieldBoost",
  "search": "purple",
  "searchFields": "id,name,description,category,ownerId",
  "searchMode": "any",
  "select": "id,name,description,category,ownerId",
  "skip": 0,
  "top": 10,
  "vectorQueries": [
    {
      "vector": [
        0,
        1,
        2,
        3,
        4,
        5,
        6,
        7,
        8,
        9
      ],
      "kind": "vector",
      "k": 50,
      "fields": "vector22, vector1b",
      "oversampling": 20,
      "weight": 1,
      "threshold": {
        "value": 0.984,
        "kind": "vectorSimilarity"
      },
      "filterOverride": "ownerId eq 'sam'"
    }
  ],
  "vectorFilterMode": "preFilter",
  "hybridSearch": {
    "maxTextRecallSize": 100,
    "countAndFacetMode": "countAllResults"
  }
}

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

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

{
  "@odata.count": 27,
  "@search.facets": {
    "ownerId": [
      {
        "count": 16,
        "value": "sam"
      },
      {
        "count": 8,
        "value": "ryan"
      },
      {
        "count": 3,
        "value": "benny"
      }
    ]
  },
  "value": [
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "no-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "empty-vectors",
      "name": "test",
      "description": "no vector",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "9",
      "name": "test",
      "description": "test9 hello",
      "category": "purple",
      "ownerId": "ryan"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "8",
      "name": "test",
      "description": "test8 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "7",
      "name": "test",
      "description": "test7 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "6",
      "name": "test",
      "description": "test6 hello",
      "category": "purple",
      "ownerId": "ryan"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "5",
      "name": "test",
      "description": "test5 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "4",
      "name": "test",
      "description": "test4 hello",
      "category": "purple",
      "ownerId": "sam"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "3",
      "name": "test",
      "description": "test3 hello",
      "category": "purple",
      "ownerId": "ryan"
    },
    {
      "@search.score": 1,
      "@search.highlights": {
        "category": [
          "</em>purple</em>"
        ]
      },
      "id": "24",
      "name": "test",
      "description": "test24 hello",
      "category": "purple",
      "ownerId": "ryan"
    }
  ]
}

SearchIndexSearchDocumentsSemanticPost

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

HTTP

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

{
  "count": true,
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "queryType": "semantic",
  "search": "how do clouds form",
  "semanticConfiguration": "my-semantic-config",
  "answers": "extractive|count-3",
  "captions": "extractive|highlight-true",
  "semanticErrorHandling": "partial",
  "semanticMaxWaitInMilliseconds": 780
}

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

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

{
  "@odata.count": 25,
  "@search.answers": [
    {
      "key": "4123",
      "text": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form where air is ascending (over land in this case),   but not where it is descending (over the river).",
      "highlights": "Sunlight heats the land all day, warming that moist air and causing it to rise high into the   atmosphere until it cools and condenses into water droplets. Clouds generally form<em> where air is ascending</em> (over land in this case),   but not where it is<em> descending</em> (over the river).",
      "score": 0.94639826
    }
  ],
  "@search.nextPageParameters": {
    "count": true,
    "highlightPostTag": "</em>",
    "highlightPreTag": "<em>",
    "queryType": "semantic",
    "search": "how do clouds form",
    "semanticConfiguration": "my-semantic-config",
    "answers": "extractive|count-3",
    "captions": "extractive|highlight-true",
    "semanticErrorHandling": "partial",
    "semanticMaxWaitInMilliseconds": 780,
    "skip": 2,
    "top": 8
  },
  "value": [
    {
      "@search.score": 0.5479723,
      "@search.rerankerScore": 1.0321671911515296,
      "@search.captions": [
        {
          "text": "Like all clouds, it forms when the air reaches its dew point—the temperature at which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley fog, which is common in the Pacific Northwest of North America.",
          "highlights": "Like all<em> clouds</em>, it<em> forms</em> when the air reaches its dew point—the temperature at    which an air mass is cool enough for its water vapor to condense into liquid droplets. This false-color image shows valley<em> fog</em>, which is common in the Pacific Northwest of North America."
        }
      ],
      "id": "4123",
      "title": "Earth Atmosphere",
      "content": "Fog is essentially a cloud lying on the ground. Like all clouds, it forms when the air reaches its dew point—the temperature at  \n\nwhich an air mass is cool enough for its water vapor to condense into liquid droplets.\n\nThis false-color image shows valley fog, which is common in the Pacific Northwest of North America. On clear winter nights, the \n\nground and overlying air cool off rapidly, especially at high elevations. Cold air is denser than warm air, and it sinks down into the \n\nvalleys. The moist air in the valleys gets chilled to its dew point, and fog forms. If undisturbed by winds, such fog may persist for \n\ndays. The Terra satellite captured this image of foggy valleys northeast of Vancouver in February 2010.\n\n\n",
      "locations": [
        "Pacific Northwest",
        "North America",
        "Vancouver"
      ]
    }
  ],
  "@odata.nextLink": "https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2024-09-01-preview"
}

Определения

Имя	Описание
AnswerResult	Ответ — это текст, извлеченный из содержимого наиболее релевантных документов, соответствующих запросу. Ответы извлекаются из лучших результатов поиска. Кандидаты на ответы оцениваются и выбираются лучшие ответы.
CaptionResult	Заголовки являются наиболее репрезентативными фрагментами документа относительно поискового запроса. Они часто используются в качестве сводки документов. Заголовки возвращаются только для запросов типа `semantic`.
DocumentDebugInfo	Содержит сведения об отладке, которые можно использовать для дальнейшего изучения результатов поиска.
ErrorAdditionalInfo	Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail	Сведения об ошибке.
ErrorResponse	Ответ на ошибку
HybridCountAndFacetMode	Определяет, должны ли счетчики и аспекты содержать все документы, соответствующие поисковому запросу, или только те документы, которые извлекаются в окне maxTextRecallSize. Значением по умолчанию является countAllResults.
HybridSearch	Параметры запроса для настройки поведения гибридного поиска.
QueryAnswerType	Значение, указывающее, следует ли возвращать ответы как часть ответа поиска.
QueryCaptionType	Значение, указывающее, должны ли возвращаться заголовки в ответе на поиск.
QueryDebugMode	Включает средство отладки, которое можно использовать для дальнейшего изучения результатов поиска.
QueryLanguage	Язык запроса.
QueryResultDocumentRerankerInput	Необработанные сцепленные строки, отправленные в процесс семантического обогащения.
QueryResultDocumentSemanticField	Описание полей, отправленных в процесс семантического обогащения, а также способ их использования
QueryResultDocumentSubscores	Разбивка подкордер между компонентами текстовых и векторных запросов для этого документа. Каждый векторный запрос отображается как отдельный объект в том же порядке, что и они были получены.
QuerySpellerType	Значение, указывающее тип орфографии, используемый для исправления отдельных условий запроса поиска.
QueryType	Указывает синтаксис поискового запроса. Значение по умолчанию — simple. Используйте значение full, если запрос использует синтаксис запроса Lucene и "семантику", если синтаксис запроса не нужен.
RawVectorQuery	Параметры запроса, используемые для поиска векторов при предоставлении необработанного векторного значения.
ScoringStatistics	Значение, указывающее, требуется ли вычислить статистику оценки (например, частоту документов) глобально для более согласованной оценки или локальной задержки. Значение по умолчанию — local. Используйте "global" для агрегирования статистики оценки глобально перед оценкой. Использование глобальной статистики оценки может увеличить задержку поисковых запросов.
SearchDocumentsResult	Ответ, содержащий результаты поиска из индекса.
SearchMode	Указывает, должны ли быть сопоставлены какие-либо или все условия поиска для подсчета документа в качестве совпадения.
SearchRequest	Параметры фильтрации, сортировки, фасетирования, разбиения по страницам и других поведении поисковых запросов.
SearchResult	Содержит документ, найденный поисковым запросом, а также связанные метаданные.
SearchScoreThreshold	Результаты векторного запроса будут фильтроваться по значению @search.score. Обратите внимание, что это @search.score, возвращенный в ответе на поиск. Направление порога будет выбрано для более высокого @search.score.
SemanticDebugInfo
SemanticErrorMode	Позволяет пользователю выбрать, должен ли семантический вызов завершиться сбоем (по умолчанию или текущему поведению) или возвращать частичные результаты.
SemanticErrorReason	Причина того, что частичный ответ был возвращен для семантического ранжирования запроса.
SemanticFieldState	Способ использования поля для процесса семантического обогащения (полностью используемый, частично используемый или неиспользуемый)
SemanticSearchResultsType	Тип частичного ответа, возвращаемого для семантического ранжирования запроса.
SingleVectorFieldResult	Результат одного векторного поля. Возвращаются как @search.score, так и значения сходства векторов. Сходство векторов связано с @search.score уравнением.
TextResult	Оценка BM25 или Классическая оценка для текстовой части запроса.
VectorFilterMode	Определяет, применяются ли фильтры до или после выполнения векторного поиска.
VectorizableImageBinaryQuery	Параметры запроса, используемые для векторного поиска, когда предоставляется векторный двоичный файл в кодировке base 64 изображения, который необходимо векторизировать.
VectorizableImageUrlQuery	Параметры запроса, используемые для векторного поиска, если указан URL-адрес, представляющий значение изображения, которое должно быть векторизировано.
VectorizableTextQuery	Параметры запроса, используемые для векторного поиска, если задано текстовое значение, которое необходимо векторизировать.
VectorQueryKind	Тип выполняемого векторного запроса.
VectorsDebugInfo
VectorSimilarityThreshold	Результаты векторного запроса будут отфильтрованы на основе метрики сходства векторов. Обратите внимание, что это каноническое определение метрик сходства, а не "расстояние" версии. Направление порога (больше или меньше) будет выбрано автоматически в соответствии с метрикой, используемой полем.
VectorThresholdKind	Тип выполняемого векторного запроса.

AnswerResult

Объект

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

Имя	Тип	Описание
highlights	string	Тот же текст, что и в свойстве Text с выделенными текстовыми фразами, наиболее релевантными для запроса.
key	string	Ключ документа, из который был извлечен ответ.
score	number (double)	Значение оценки представляет, насколько релевантн ответ на запрос относительно других ответов, возвращаемых для запроса.
text	string	Текст, извлеченный из содержимого документа в качестве ответа.

CaptionResult

Объект

Заголовки являются наиболее репрезентативными фрагментами документа относительно поискового запроса. Они часто используются в качестве сводки документов. Заголовки возвращаются только для запросов типа semantic.

Имя	Тип	Описание
highlights	string	Тот же текст, что и в свойстве Text с выделенными фразами, наиболее релевантными для запроса.
text	string	Репрезентативный текст, извлеченный из документа, наиболее релевантного к поисковому запросу.

DocumentDebugInfo

Объект

Содержит сведения об отладке, которые можно использовать для дальнейшего изучения результатов поиска.

Имя	Тип	Описание
semantic	SemanticDebugInfo	Содержит сведения об отладке, относящиеся к семантической ранжированию запросов.
vectors	VectorsDebugInfo	Содержит сведения об отладке, относящиеся к вектору и гибридному поиску.

ErrorAdditionalInfo

Объект

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

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

ErrorDetail

Объект

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

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

ErrorResponse

Объект

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

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

HybridCountAndFacetMode

Перечисление

Определяет, должны ли счетчики и аспекты содержать все документы, соответствующие поисковому запросу, или только те документы, которые извлекаются в окне maxTextRecallSize. Значением по умолчанию является countAllResults.

Значение	Описание
countRetrievableResults	Включают только документы, которые были сопоставлены в окне извлечения maxTextRecallSize при вычислении "count" и "аспекты".
countAllResults	Включите все документы, которые были сопоставлены поисковым запросом при вычислении счетчиков и аспектов, независимо от того, находятся ли эти документы в окне извлечения maxTextRecallSize.

HybridSearch

Объект

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

Имя	Тип	Описание
countAndFacetMode	HybridCountAndFacetMode	Определяет, должны ли счетчики и аспекты содержать все документы, соответствующие поисковому запросу, или только те документы, которые извлекаются в окне maxTextRecallSize.
maxTextRecallSize	integer (int32)	Определяет максимальное количество документов, извлекаемых частью текстового запроса гибридного поискового запроса. Эти документы будут объединены с документами, соответствующими векторным запросам, чтобы создать единый окончательный список результатов. При выборе большего значения maxTextRecallSize можно получить и разбиение по страницам с помощью дополнительных документов (используя верхние и пропускающие параметры), за счет повышения использования ресурсов и более высокой задержки. Значение должно быть от 1 до 10 000. Значение по умолчанию — 1000.

QueryAnswerType

Перечисление

Значение, указывающее, следует ли возвращать ответы как часть ответа поиска.

Значение	Описание
none	Не возвращайте ответы на запрос.
extractive	Извлекает кандидатов ответов из содержимого документов, возвращаемых в ответ на запрос, выраженный как вопрос на естественном языке.

QueryCaptionType

Перечисление

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

Значение	Описание
none	Не возвращайте подписи для запроса.
extractive	Извлекает заголовки из соответствующих документов, содержащих фрагменты, относящиеся к поисковому запросу.

QueryDebugMode

Перечисление

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

Значение	Описание
disabled	Сведения об отладке запросов не будут возвращены.
semantic	Позволяет пользователю более подробно изучить результаты повторного выполнения.

QueryLanguage

Перечисление

Язык запроса.

Значение	Описание
none	Язык запросов не указан.
en-us	Значение языка запросов для английского языка (США).
en-gb	Значение языка запросов для английского языка (Великобритания).
en-in	Значение языка запросов для английского языка (Индия).
en-ca	Значение языка запросов для английского языка (Канада).
en-au	Значение языка запросов для английского языка (Австралия).
fr-fr	Значение языка запросов для французского языка (Франция).
fr-ca	Значение языка запросов для французского языка (Канада).
de-de	Значение языка запросов для немецкого (Германия).
es-es	Значение языка запросов для испанского языка (Испания).
es-mx	Значение языка запросов для испанского языка (Мексика).
zh-cn	Значение языка запросов для китайского языка (Китай).
zh-tw	Значение языка запросов для китайского (Тайвань).
pt-br	Значение языка запросов для португальского языка (Бразилия).
pt-pt	Значение языка запросов для португальского языка (Португалия).
it-it	Значение языка запросов для итальянского языка (Италия).
ja-jp	Значение языка запросов для японского языка (Япония).
ko-kr	Значение языка запросов для корейского языка (Корея).
ru-ru	Значение языка запросов для российского языка (Россия).
cs-cz	Значение языка запросов для Чешской (Чехия).
nl-be	Значение языка запросов для голландского языка (Бельгия).
nl-nl	Значение языка запросов для голландского языка (Нидерланды).
hu-hu	Значение языка запроса для венгерского (Венгрия).
pl-pl	Значение языка запросов для польского языка (Польша).
sv-se	Значение языка запросов для шведского языка (Швеция).
tr-tr	Значение языка запросов для турецкого (Турция).
hi-in	Значение языка запросов для Хинди (Индия).
ar-sa	Значение языка запроса для арабского языка (Саудовская Аравия).
ar-eg	Значение языка запроса для арабского языка (Египет).
ar-ma	Значение языка запроса для арабского языка (Марокко).
ar-kw	Значение языка запроса для арабского языка (Кувейт).
ar-jo	Значение языка запросов для арабского языка (Иордания).
da-dk	Значение языка запросов для датского языка (Дания).
no-no	Значение языка запросов для норвежского языка (Норвегия).
bg-bg	Значение языка запросов для Болгарии (Болгария).
hr-hr	Значение языка запроса для хорватского языка (Хорватия).
hr-ba	Значение языка запроса для хорватского языка (Босния и Герцеговина).
ms-my	Значение языка запросов для Малай (Малайзия).
ms-bn	Значение языка запроса для Малая (Бруней Даруссалам).
sl-sl	Значение языка запросов для Словенского (Словения).
ta-in	Значение языка запросов для Тамила (Индия).
vi-vn	Значение языка запросов для вьетнамцев (Вьетнам).
el-gr	Значение языка запроса для греческого языка (Греция).
ro-ro	Значение языка запросов для румына (Румыния).
is-is	Значение языка запросов для Исландии (Исландия).
id-id	Значение языка запросов для индонезийского (Индонезия).
th-th	Значение языка запросов для тайского (Таиланда).
lt-lt	Значение языка запроса для Литвы (Литва).
uk-ua	Значение языка запросов для украинца (Украина).
lv-lv	Значение языка запроса для Латышского (Латвия).
et-ee	Значение языка запросов для Эстонии (Эстония).
ca-es	Значение языка запроса для каталонского языка.
fi-fi	Значение языка запросов для финляндии (Финляндия).
sr-ba	Значение языка запросов для сербских (Босния и Герцеговина).
sr-me	Значение языка запроса для сербских (Черногория).
sr-rs	Значение языка запросов для сербских (Сербия).
sk-sk	Значение языка запросов для словацкого языка (Словакия).
nb-no	Значение языка запросов для норвежского языка (Норвегия).
hy-am	Значение языка запросов для армян (Армения).
bn-in	Значение языка запроса для Бенгали (Индия).
eu-es	Значение языка запросов для Баска.
gl-es	Значение языка запроса для Галисияна.
gu-in	Значение языка запроса для Gujarati (Индия).
he-il	Значение языка запросов для иврита (Израиль).
ga-ie	Значение языка запросов для ирландского языка (Ирландия).
kn-in	Значение языка запросов для Kannada (Индия).
ml-in	Значение языка запросов для Малаялам (Индия).
mr-in	Значение языка запросов для Маратхи (Индия).
fa-ae	Значение языка запросов для персидского языка (U.A.E.).
pa-in	Значение языка запросов для Пенджаби (Индия).
te-in	Значение языка запросов для Telugu (Индия).
ur-pk	Значение языка запросов для Urdu (Пакистан).

QueryResultDocumentRerankerInput

Объект

Необработанные сцепленные строки, отправленные в процесс семантического обогащения.

Имя	Тип	Описание
content	string	Необработанные сцепленные строки для полей содержимого, которые использовались для семантического обогащения.
keywords	string	Необработанные сцепленные строки для полей ключевых слов, которые использовались для семантического обогащения.
title	string	Необработанная строка для поля заголовка, используемого для семантического обогащения.

QueryResultDocumentSemanticField

Объект

Описание полей, отправленных в процесс семантического обогащения, а также способ их использования

Имя	Тип	Описание
name	string	Имя поля, отправленного в процесс семантического обогащения
state	SemanticFieldState	Способ использования поля для процесса семантического обогащения (полностью используемый, частично используемый или неиспользуемый)

QueryResultDocumentSubscores

Объект

Разбивка подкордер между компонентами текстовых и векторных запросов для этого документа. Каждый векторный запрос отображается как отдельный объект в том же порядке, что и они были получены.

Имя	Тип	Описание
documentBoost	number (double)	Оценка BM25 или Классическая оценка для текстовой части запроса.
text	TextResult	Оценка BM25 или Классическая оценка для текстовой части запроса.
vectors	<string, SingleVectorFieldResult>	Сходство векторов и @search.score значения для каждого векторного запроса.

QuerySpellerType

Перечисление

Значение, указывающее тип орфографии, используемый для исправления отдельных условий запроса поиска.

Значение	Описание
none	Орфограф не включен.
lexicon	Средство орфографии исправляет отдельные термины запроса с помощью статического лексикона для языка, заданного параметром queryLanguage.

QueryType

Перечисление

Указывает синтаксис поискового запроса. Значение по умолчанию — simple. Используйте значение full, если запрос использует синтаксис запроса Lucene и "семантику", если синтаксис запроса не нужен.

Значение	Описание
simple	Использует простой синтаксис запроса для поиска. Текст поиска интерпретируется с помощью простого языка запросов, который позволяет использовать такие символы, как +, * и ". Запросы оцениваются по умолчанию во всех полях, доступных для поиска, если не указан параметр searchFields.
full	Использует полный синтаксис запроса Lucene для поиска. Текст поиска интерпретируется с помощью языка запросов Lucene, который позволяет выполнять поиск по полю и весовые значения, а также другие расширенные функции.
semantic	Лучше всего подходит для запросов, выраженных на естественном языке, в отличие от ключевых слов. Повышает точность результатов поиска путем повторного ранжирования лучших результатов поиска с помощью модели ранжирования, обученной в веб-корпусе.

RawVectorQuery

Объект

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

Имя	Тип	Описание
exhaustive	boolean	Если значение true, активирует исчерпывающий поиск ближайших к соседей по всем векторам в индексе векторов. Полезно для сценариев, когда точные совпадения являются критически важными, например определение значений истины на земле.
fields	string	Векторные поля коллекции типов (Edm.Single), которые должны быть включены в векторный поиск.
filterOverride	string	Выражение фильтра OData, применяемое к этому конкретному вектору запроса. Если выражение фильтра не определено на уровне вектора, вместо этого используется выражение, определенное в параметре фильтра верхнего уровня.
k	integer (int32)	Число ближайших соседей, возвращаемых в качестве лучших хитов.
kind	string: vector	Тип выполняемого векторного запроса.
oversampling	number (double)	Превышение коэффициента. Минимальное значение равно 1. Он переопределяет параметр defaultOversampling, настроенный в определении индекса. Его можно задать только в том случае, если параметр rerankWithOriginalVectors имеет значение true. Этот параметр допускается только в том случае, если метод сжатия используется в базовом поле вектора.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Пороговое значение, используемое для векторных запросов. Обратите внимание, что это можно задать только в том случае, если все поля используют одну и ту же метрику сходства.
vector	number[] (float)	Векторное представление поискового запроса.
weight	number (float)	Относительный вес векторного запроса при сравнении с другими векторными запросами и/или текстовым запросом в том же запросе поиска. Это значение используется при объединении результатов нескольких списков ранжирования, созданных различными векторными запросами и (или) результатов, полученных с помощью текстового запроса. Чем выше вес, тем выше документы, соответствующие запросу, будут находиться в окончательном рейтинге. Значение по умолчанию равно 1.0, а значение должно быть положительным числом, превышающим нулю.

ScoringStatistics

Перечисление

Значение, указывающее, требуется ли вычислить статистику оценки (например, частоту документов) глобально для более согласованной оценки или локальной задержки. Значение по умолчанию — local. Используйте "global" для агрегирования статистики оценки глобально перед оценкой. Использование глобальной статистики оценки может увеличить задержку поисковых запросов.

Значение	Описание
local	Статистика оценки вычисляется локально для снижения задержки.
global	Статистика оценки будет вычисляться глобально для более согласованной оценки.

SearchDocumentsResult

Объект

Ответ, содержащий результаты поиска из индекса.

Имя	Тип	Описание
@odata.count	integer (int64)	Общее количество результатов, найденных операцией поиска, или значение NULL, если число не было запрошено. При наличии число результатов в этом ответе может быть больше числа результатов. Это может произойти, если вы используете параметры $top или $skip или если запрос не может возвращать все запрошенные документы в одном ответе.
@odata.nextLink	string	URL-адрес продолжения, возвращаемый, когда запрос не может возвращать все запрошенные результаты в одном ответе. Этот URL-адрес можно использовать для формирования другого запроса GET или POST Search, чтобы получить следующую часть ответа на поиск. Обязательно используйте ту же команду (GET или POST), что и запрос, создающий этот ответ.
@search.answers	AnswerResult[]	Результаты запроса ответов для операции поиска; Значение NULL, если параметр запроса ответов не указан или задан значение none.
@search.coverage	number (double)	Значение, указывающее процент индекса, который был включен в запрос, или значение NULL, если минимальное значениеCoverage не указано в запросе.
@search.facets	object	Результаты запроса аспектов для операции поиска, упорядоченные как коллекция контейнеров для каждого фасетного поля; Значение NULL, если запрос не включал никаких выражений аспектов.
@search.nextPageParameters	SearchRequest	Полезные данные JSON продолжения возвращаются, когда запрос не может возвращать все запрошенные результаты в одном ответе. Этот код JSON можно использовать вместе с @odata.nextLink, чтобы сформулировать другой запрос поиска POST, чтобы получить следующую часть ответа поиска.
@search.semanticPartialResponseReason	SemanticErrorReason	Причина того, что частичный ответ был возвращен для семантического ранжирования запроса.
@search.semanticPartialResponseType	SemanticSearchResultsType	Тип частичного ответа, возвращаемого для семантического ранжирования запроса.
value	SearchResult[]	Последовательность результатов, возвращаемая запросом.

SearchMode

Перечисление

Указывает, должны ли быть сопоставлены какие-либо или все условия поиска для подсчета документа в качестве совпадения.

Значение	Описание
any	Для подсчета документа в качестве соответствия необходимо сопоставить любой из условий поиска.
all	Все условия поиска должны быть сопоставлены для подсчета документа в качестве совпадения.

SearchRequest

Объект

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

Имя	Тип	Описание
answers	QueryAnswerType	Значение, указывающее, следует ли возвращать ответы как часть ответа поиска.
captions	QueryCaptionType	Значение, указывающее, должны ли возвращаться заголовки в ответе на поиск.
count	boolean	Значение, указывающее, следует ли получить общее количество результатов. Значение по умолчанию — false. Если задать значение true, это значение может повлиять на производительность. Обратите внимание, что возвращаемое число является приблизительный.
debug	QueryDebugMode	Включает средство отладки, которое можно использовать для дальнейшего изучения повторных результатов.
facets	string[]	Список выражений аспектов, применяемых к поисковому запросу. Каждое выражение аспектов содержит имя поля, за которым следует список пар name:value, разделенный запятыми.
filter	string	Выражение OData $filter, применяемое к поисковому запросу.
highlight	string	Список имен полей, разделенных запятыми, используемых для выделения попаданий. Для выделения попаданий можно использовать только поля, доступные для поиска.
highlightPostTag	string	Тег строки, добавляемый для выделения попаданий. Необходимо задать с выделенным значениемPreTag. Значение по умолчанию — </em>.
highlightPreTag	string	Тег строки, который предопределен для выделения попаданий. Необходимо задать с помощью highlightPostTag. По умолчанию используется <em>.
hybridSearch	HybridSearch	Параметры запроса для настройки поведения гибридного поиска.
minimumCoverage	number (double)	Число от 0 до 100, указывающее процент индекса, который должен охватываться поисковым запросом, чтобы запрос сообщалось успешно. Этот параметр может быть полезен для обеспечения доступности поиска даже для служб с одной репликой. Значение по умолчанию — 100.
orderby	string	Разделенный запятыми список выражений OData $orderby, по которым выполняется сортировка результатов. Каждое выражение может быть именем поля или вызовом функций geo.distance() или search.score(). За каждым выражением можно следовать какc, чтобы указать возрастание, или desc, чтобы указать убывание. Значение по умолчанию — по возрастанию. Связи будут нарушены с помощью показателей соответствия документов. Если $orderby не указано, порядок сортировки по умолчанию убывает по оценке соответствия документа. Существует не более 32 предложений $orderby.
queryLanguage	QueryLanguage	Значение, указывающее язык поискового запроса.
queryType	QueryType	Значение, указывающее синтаксис поискового запроса. Значение по умолчанию — simple. Используйте значение full, если запрос использует синтаксис запроса Lucene.
scoringParameters	string[]	Список значений параметров, используемых в функциях оценки (например, referencePointParameter) с использованием значений имени формата. Например, если профиль оценки определяет функцию с параметром с именем mylocation, строка параметра будет "mylocation--122.2,44.8" (без кавычки).
scoringProfile	string	Имя профиля оценки для оценки показателей для сопоставления документов для сортировки результатов.
scoringStatistics	ScoringStatistics	Значение, указывающее, требуется ли вычислить статистику оценки (например, частоту документов) глобально для более согласованной оценки или локальной задержки. Значение по умолчанию — local. Используйте "global" для агрегирования статистики оценки глобально перед оценкой. Использование глобальной статистики оценки может увеличить задержку поисковых запросов.
search	string	Выражение запроса полнотекстового поиска; Используйте "*" или опустить этот параметр для сопоставления всех документов.
searchFields	string	Список имен полей, разделенных запятыми, в которых выполняется полнотекстовый поиск. При использовании поля поиска (fieldName:searchExpression) в полном запросе Lucene имена полей каждого поля выражения поиска имеют приоритет над именами полей, перечисленными в этом параметре.
searchMode	SearchMode	Значение, указывающее, должны ли совпадать все или все условия поиска, чтобы подсчитать документ как совпадение.
select	string	Список извлекаемых полей с разделием запятыми. Если не указано, все поля, помеченные как извлекаемые в схеме, включаются.
semanticConfiguration	string	Имя семантической конфигурации, которая будет использоваться при обработке документов для запросов семантики типа.
semanticErrorHandling	SemanticErrorMode	Позволяет пользователю выбрать, должен ли семантический вызов завершиться сбоем (по умолчанию или текущему поведению) или возвращать частичные результаты.
semanticFields	string	Разделенный запятыми список имен полей, используемых для семантического ранжирования.
semanticMaxWaitInMilliseconds	integer (int32) minimum: 700	Позволяет пользователю задать верхнюю границу на время, которое требуется для завершения обработки семантического обогащения до сбоя запроса.
semanticQuery	string	Позволяет задать отдельный поисковый запрос, который будет использоваться исключительно для семантического повторения, семантических подписей и семантических ответов. Полезно для сценариев, когда требуется использовать различные запросы между базовым этапом извлечения и ранжирования, а также семантической фазой L2.
sessionId	string	Значение, используемое для создания липкого сеанса, которое может помочь получить более согласованные результаты. До тех пор, пока используется тот же идентификатор сеанса, будет предпринята попытка попытаться выбрать тот же набор реплик. Будьте осторожны, что повторное использование одних и того же значения sessionID многократно может повлиять на балансировку нагрузки запросов между репликами и негативно повлиять на производительность службы поиска. Значение, используемое в качестве sessionId, не может начинаться с символа "_".
skip	integer (int32)	Количество пропущенных результатов поиска. Это значение не может быть больше 100 000. Если вам нужно сканировать документы в последовательности, но не удается пропустить из-за этого ограничения, рекомендуется использовать orderby на полностью упорядоченном ключе и фильтровать с помощью запроса диапазона.
speller	QuerySpellerType	Значение, указывающее тип орфографии, используемый для исправления отдельных условий запроса поиска.
top	integer (int32)	Количество полученных результатов поиска. Это можно использовать в сочетании с $skip для реализации разбиения по страницам на стороне клиента результатов поиска. Если результаты усечены из-за разбиения на страницы на стороне сервера, ответ будет содержать маркер продолжения, который можно использовать для выдачи другого запроса поиска на следующую страницу результатов.
vectorFilterMode	VectorFilterMode	Определяет, применяются ли фильтры до или после выполнения векторного поиска. Значение по умолчанию — preFilter для новых индексов.
vectorQueries	VectorQuery[]: RawVectorQuery[] VectorizableImageBinaryQuery[] VectorizableImageUrlQuery[] VectorizableTextQuery[]	Параметры запроса для векторных и гибридных поисковых запросов.

SearchResult

Объект

Содержит документ, найденный поисковым запросом, а также связанные метаданные.

Имя	Тип	Описание
@search.captions	CaptionResult[]	Заголовки являются наиболее репрезентативными фрагментами документа относительно поискового запроса. Они часто используются в качестве сводки документов. Заголовки возвращаются только для запросов типа "семантика".
@search.documentDebugInfo	DocumentDebugInfo[]	Содержит сведения об отладке, которые можно использовать для дальнейшего изучения результатов поиска.
@search.highlights	object	Фрагменты текста документа, указывающие соответствующие условия поиска, упорядоченные по каждому применимому полю; Значение NULL, если выделение попаданий не было включено для запроса.
@search.rerankerScore	number (double)	Оценка релевантности, вычисляемая семантической рангером для лучших результатов поиска. Результаты поиска отсортированы по rerankerScore сначала, а затем по оценке. RerankerScore возвращается только для запросов типа "семантика".
@search.score	number (double)	Оценка релевантности документа по сравнению с другими документами, возвращаемыми запросом.

SearchScoreThreshold

Объект

Результаты векторного запроса будут фильтроваться по значению @search.score. Обратите внимание, что это @search.score, возвращенный в ответе на поиск. Направление порога будет выбрано для более высокого @search.score.

Имя	Тип	Описание
kind	string: searchScore	Тип порога, используемого для фильтрации векторных запросов
value	number (double)	Пороговое значение будет фильтроваться по значению @search.score. Обратите внимание, что это @search.score, возвращенный в ответе на поиск. Направление порога будет выбрано для более высокого @search.score.

SemanticDebugInfo

Объект

Имя	Тип	Описание
contentFields	QueryResultDocumentSemanticField[]	Поля содержимого, отправленные в процесс семантического обогащения, а также как они использовались
keywordFields	QueryResultDocumentSemanticField[]	Поля ключевых слов, отправленные в процесс семантического обогащения, а также как они использовались
rerankerInput	QueryResultDocumentRerankerInput	Необработанные сцепленные строки, отправленные в процесс семантического обогащения.
titleField	QueryResultDocumentSemanticField	Поле заголовка, отправленное в процесс семантического обогащения, а также как оно было использовано

SemanticErrorMode

Перечисление

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

Значение	Описание
partial	Если семантическая обработка завершается ошибкой, частичные результаты по-прежнему возвращаются. Определение частичных результатов зависит от того, какой семантический шаг завершился сбоем и что было причиной сбоя.
fail	Если во время семантического этапа обработки существует исключение, запрос завершится ошибкой и возвращает соответствующий HTTP-код в зависимости от ошибки.

SemanticErrorReason

Перечисление

Причина того, что частичный ответ был возвращен для семантического ранжирования запроса.

Значение	Описание
maxWaitExceeded	Если `semanticMaxWaitInMilliseconds` задано, а длительность семантической обработки превысила это значение. Возвращены только базовые результаты.
capacityOverloaded	Запрос был регулированием. Возвращены только базовые результаты.
transient	Не удалось выполнить хотя бы один шаг семантического процесса.

SemanticFieldState

Перечисление

Способ использования поля для процесса семантического обогащения (полностью используемый, частично используемый или неиспользуемый)

Значение	Описание
used	Поле было полностью использовано для семантического обогащения.
unused	Поле не использовалось для семантического обогащения.
partial	Поле было частично использовано для семантического обогащения.

SemanticSearchResultsType

Перечисление

Тип частичного ответа, возвращаемого для семантического ранжирования запроса.

Значение	Описание
baseResults	Результаты без семантического обогащения или повторного использования.
rerankedResults	Результаты были восстановлены с помощью модели повторного рангера и будут включать семантические субтитры. Они не будут включать какие-либо ответы, выделения ответов или заголовки.

SingleVectorFieldResult

Объект

Результат одного векторного поля. Возвращаются как @search.score, так и значения сходства векторов. Сходство векторов связано с @search.score уравнением.

Имя	Тип	Описание
searchScore	number (double)	Значение @search.score, вычисляемое из оценки сходства векторов. Это оценка, которая отображается в чистом одноуровневом запросе с одним вектором.
vectorSimilarity	number (double)	Оценка сходства векторов для этого документа. Обратите внимание, что это каноническое определение метрик сходства, а не "расстояние" версии. Например, косинус сходства вместо косинусного расстояния.

TextResult

Объект

Оценка BM25 или Классическая оценка для текстовой части запроса.

Имя	Тип	Описание
searchScore	number (double)	Оценка BM25 или Классическая оценка для текстовой части запроса.

VectorFilterMode

Перечисление

Определяет, применяются ли фильтры до или после выполнения векторного поиска.

Значение	Описание
postFilter	Фильтр будет применен после возврата набора кандидатов результатов вектора. В зависимости от избирательности фильтра это может привести к меньшему значению результатов, чем запрашивается параметром k.
preFilter	Фильтр будет применен перед поисковым запросом.

VectorizableImageBinaryQuery

Объект

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

Имя	Тип	Описание
base64Image	string	Двоичный файл в кодировке base 64 изображения, векторизованный для выполнения векторного запроса поиска.
exhaustive	boolean	Если значение true, активирует исчерпывающий поиск ближайших к соседей по всем векторам в индексе векторов. Полезно для сценариев, когда точные совпадения являются критически важными, например определение значений истины на земле.
fields	string	Векторные поля коллекции типов (Edm.Single), которые должны быть включены в векторный поиск.
filterOverride	string	Выражение фильтра OData, применяемое к этому конкретному вектору запроса. Если выражение фильтра не определено на уровне вектора, вместо этого используется выражение, определенное в параметре фильтра верхнего уровня.
k	integer (int32)	Число ближайших соседей, возвращаемых в качестве лучших хитов.
kind	string: imageBinary	Тип выполняемого векторного запроса.
oversampling	number (double)	Превышение коэффициента. Минимальное значение равно 1. Он переопределяет параметр defaultOversampling, настроенный в определении индекса. Его можно задать только в том случае, если параметр rerankWithOriginalVectors имеет значение true. Этот параметр допускается только в том случае, если метод сжатия используется в базовом поле вектора.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Пороговое значение, используемое для векторных запросов. Обратите внимание, что это можно задать только в том случае, если все поля используют одну и ту же метрику сходства.
weight	number (float)	Относительный вес векторного запроса при сравнении с другими векторными запросами и/или текстовым запросом в том же запросе поиска. Это значение используется при объединении результатов нескольких списков ранжирования, созданных различными векторными запросами и (или) результатов, полученных с помощью текстового запроса. Чем выше вес, тем выше документы, соответствующие запросу, будут находиться в окончательном рейтинге. Значение по умолчанию равно 1.0, а значение должно быть положительным числом, превышающим нулю.

VectorizableImageUrlQuery

Объект

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

Имя	Тип	Описание
exhaustive	boolean	Если значение true, активирует исчерпывающий поиск ближайших к соседей по всем векторам в индексе векторов. Полезно для сценариев, когда точные совпадения являются критически важными, например определение значений истины на земле.
fields	string	Векторные поля коллекции типов (Edm.Single), которые должны быть включены в векторный поиск.
filterOverride	string	Выражение фильтра OData, применяемое к этому конкретному вектору запроса. Если выражение фильтра не определено на уровне вектора, вместо этого используется выражение, определенное в параметре фильтра верхнего уровня.
k	integer (int32)	Число ближайших соседей, возвращаемых в качестве лучших хитов.
kind	string: imageUrl	Тип выполняемого векторного запроса.
oversampling	number (double)	Превышение коэффициента. Минимальное значение равно 1. Он переопределяет параметр defaultOversampling, настроенный в определении индекса. Его можно задать только в том случае, если параметр rerankWithOriginalVectors имеет значение true. Этот параметр допускается только в том случае, если метод сжатия используется в базовом поле вектора.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Пороговое значение, используемое для векторных запросов. Обратите внимание, что это можно задать только в том случае, если все поля используют одну и ту же метрику сходства.
url	string	URL-адрес векторного изображения для выполнения векторного запроса поиска.
weight	number (float)	Относительный вес векторного запроса при сравнении с другими векторными запросами и/или текстовым запросом в том же запросе поиска. Это значение используется при объединении результатов нескольких списков ранжирования, созданных различными векторными запросами и (или) результатов, полученных с помощью текстового запроса. Чем выше вес, тем выше документы, соответствующие запросу, будут находиться в окончательном рейтинге. Значение по умолчанию равно 1.0, а значение должно быть положительным числом, превышающим нулю.

VectorizableTextQuery

Объект

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

Имя	Тип	Описание
exhaustive	boolean	Если значение true, активирует исчерпывающий поиск ближайших к соседей по всем векторам в индексе векторов. Полезно для сценариев, когда точные совпадения являются критически важными, например определение значений истины на земле.
fields	string	Векторные поля коллекции типов (Edm.Single), которые должны быть включены в векторный поиск.
filterOverride	string	Выражение фильтра OData, применяемое к этому конкретному вектору запроса. Если выражение фильтра не определено на уровне вектора, вместо этого используется выражение, определенное в параметре фильтра верхнего уровня.
k	integer (int32)	Число ближайших соседей, возвращаемых в качестве лучших хитов.
kind	string: text	Тип выполняемого векторного запроса.
oversampling	number (double)	Превышение коэффициента. Минимальное значение равно 1. Он переопределяет параметр defaultOversampling, настроенный в определении индекса. Его можно задать только в том случае, если параметр rerankWithOriginalVectors имеет значение true. Этот параметр допускается только в том случае, если метод сжатия используется в базовом поле вектора.
text	string	Векторный текст для выполнения запроса векторного поиска.
threshold	VectorThreshold: SearchScoreThreshold VectorSimilarityThreshold	Пороговое значение, используемое для векторных запросов. Обратите внимание, что это можно задать только в том случае, если все поля используют одну и ту же метрику сходства.
weight	number (float)	Относительный вес векторного запроса при сравнении с другими векторными запросами и/или текстовым запросом в том же запросе поиска. Это значение используется при объединении результатов нескольких списков ранжирования, созданных различными векторными запросами и (или) результатов, полученных с помощью текстового запроса. Чем выше вес, тем выше документы, соответствующие запросу, будут находиться в окончательном рейтинге. Значение по умолчанию равно 1.0, а значение должно быть положительным числом, превышающим нулю.

VectorQueryKind

Перечисление

Тип выполняемого векторного запроса.

Значение	Описание
vector	Векторный запрос, в котором предоставляется необработанное векторное значение.
text	Векторный запрос, в котором предоставляется текстовое значение, необходимое для векторизации.
imageUrl	Векторный запрос, в котором указан URL-адрес, представляющий значение изображения, которое необходимо векторизировать.
imageBinary	Векторный запрос, в котором предоставляется векторный двоичный файл в кодировке base 64 изображения, который необходимо векторизировать.

VectorsDebugInfo

Объект

Имя	Тип	Описание
subscores	QueryResultDocumentSubscores	Разбивка подкордер документа до выбранного метода слияния и сочетания результирующих наборов, таких как RRF.

VectorSimilarityThreshold

Объект

Результаты векторного запроса будут отфильтрованы на основе метрики сходства векторов. Обратите внимание, что это каноническое определение метрик сходства, а не "расстояние" версии. Направление порога (больше или меньше) будет выбрано автоматически в соответствии с метрикой, используемой полем.

Имя	Тип	Описание
kind	string: vectorSimilarity	Тип порога, используемого для фильтрации векторных запросов
value	number (double)	Пороговое значение будет фильтроваться на основе значения метрик сходства. Обратите внимание, что это каноническое определение метрик сходства, а не "расстояние" версии. Направление порога (больше или меньше) будет выбрано автоматически в соответствии с метрикой, используемой полем.

VectorThresholdKind

Перечисление

Тип выполняемого векторного запроса.

Значение	Описание
vectorSimilarity	Результаты векторного запроса будут отфильтрованы на основе метрики сходства векторов. Обратите внимание, что это каноническое определение метрик сходства, а не "расстояние" версии. Направление порога (больше или меньше) будет выбрано автоматически в соответствии с метрикой, используемой полем.
searchScore	Результаты векторного запроса будут фильтроваться по значению @search.score. Обратите внимание, что это @search.score, возвращенный в ответе на поиск. Направление порога будет выбрано для более высокого @search.score.

Значение

Описание

vectorSimilarity

searchScore