Documents - Search Post

  • Referência
Serviço:
Search Service
Versão da API:
2023-11-01

Procura documentos no índice.

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

Parâmetros do URI

Name Em Necessário Tipo Description
endpoint
 path True

string

O URL do ponto final do serviço de pesquisa.
indexName
 path True

string

O nome do índice.
api-version
 query True

string

Versão da API do Cliente.

Cabeçalho do Pedido

Name Necessário Tipo Description
x-ms-client-request-id

string

uuid

O ID de controlo enviado com o pedido para ajudar na depuração.

Corpo do Pedido

Name Tipo Description
answers

QueryAnswerType

Um valor que especifica se as respostas devem ser devolvidas como parte da resposta de pesquisa.
captions

QueryCaptionType

Um valor que especifica se as legendas devem ser devolvidas como parte da resposta da pesquisa.
count

boolean

Um valor que especifica se pretende obter a contagem total de resultados. A predefinição é falso. Definir este valor como verdadeiro pode ter um impacto no desempenho. Tenha em atenção que a contagem devolvida é uma aproximação.
facets

string[]

A lista de expressões de facetas a aplicar à consulta de pesquisa. Cada expressão de faceta contém um nome de campo, opcionalmente seguido por uma lista separada por vírgulas de pares name:value.
filter

string

O OData $filter expressão a aplicar à consulta de pesquisa.
highlight

string

A lista separada por vírgulas de nomes de campos a utilizar para os destaques de êxito. Apenas os campos pesquisáveis podem ser utilizados para realce de acesso.
highlightPostTag

string

Uma etiqueta de cadeia que é anexada aos destaques de acesso. Tem de ser definido com highlightPreTag. A predefinição é </em>.
highlightPreTag

string

Uma etiqueta de cadeia que está pré-anexada para atingir destaques. Tem de ser definido com highlightPostTag. A predefinição é <em>.
minimumCoverage

number

Um número entre 0 e 100 que indica a percentagem do índice que tem de ser abrangida por uma consulta de pesquisa para que a consulta seja comunicada com êxito. Este parâmetro pode ser útil para garantir a disponibilidade da pesquisa, mesmo para serviços com apenas uma réplica. A predefinição é 100.
orderby

string

A lista separada por vírgulas de OData $orderby expressões pelas quais ordenar os resultados. Cada expressão pode ser um nome de campo ou uma chamada para as funções geo.distance() ou search.score(). Cada expressão pode ser seguida por asc para indicar ascendente ou desc para indicar descendente. A predefinição é ordem ascendente. Os laços serão quebrados pelas pontuações de correspondência de documentos. Se não for especificado nenhum $orderby, a sequência de ordenação predefinida é descendente pela classificação de correspondência do documento. Pode haver, no máximo, 32 cláusulas de $orderby.
queryType

QueryType

Um valor que especifica a sintaxe da consulta de pesquisa. A predefinição é "simples". Utilize "full" se a consulta utilizar a sintaxe da consulta Lucene.
scoringParameters

string[]

A lista de valores de parâmetros a utilizar nas funções de classificação (por exemplo, referencePointParameter) com o formato name-values. Por exemplo, se o perfil de classificação definir uma função com um parâmetro chamado "mylocation", a cadeia de parâmetros será "mylocation--122.2,44.8" (sem as aspas).
scoringProfile

string

O nome de um perfil de classificação para avaliar pontuações de correspondência para documentos correspondentes para ordenar os resultados.
scoringStatistics

ScoringStatistics

Um valor que especifica se queremos calcular as estatísticas de classificação (como a frequência do documento) globalmente para uma classificação mais consistente, ou localmente, para uma menor latência. A predefinição é "local". Utilize "global" para agregar estatísticas de classificação globalmente antes de pontuar. A utilização de estatísticas de classificação global pode aumentar a latência das consultas de pesquisa.
search

string

Uma expressão de consulta de pesquisa em texto completo; Utilize "*" ou omita este parâmetro para corresponder a todos os documentos.
searchFields

string

A lista de nomes de campos separados por vírgulas para definir o âmbito da pesquisa em texto completo. Ao utilizar a pesquisa em campo (fieldName:searchExpression) numa consulta Lucene completa, os nomes de campo de cada expressão de pesquisa em campo têm precedência sobre os nomes de campo listados neste parâmetro.
searchMode

SearchMode

Um valor que especifica se algum ou todos os termos de pesquisa têm de ser correspondidos para contar o documento como uma correspondência.
select

string

A lista de campos separados por vírgulas a obter. Se não for especificado, todos os campos marcados como recuperáveis no esquema serão incluídos.
semanticConfiguration

string

O nome de uma configuração semântica que será utilizada ao processar documentos para consultas do tipo semântico.
semanticErrorHandling

SemanticErrorMode

Permite ao utilizador escolher se uma chamada semântica deve falhar completamente (comportamento predefinido/atual) ou devolver resultados parciais.
semanticMaxWaitInMilliseconds

integer

Permite que o utilizador defina um limite superior sobre a quantidade de tempo que o melhoramento semântico demora a concluir o processamento antes de o pedido falhar.
sessionId

string

Um valor a ser utilizado para criar uma sessão autocolante, o que pode ajudar a obter resultados mais consistentes. Desde que o mesmo sessionId seja utilizado, será feita uma tentativa de melhor esforço para direcionar o mesmo conjunto de réplicas. Tenha em atenção que reutilizar os mesmos valores sessionID repetidamente pode interferir com o balanceamento de carga dos pedidos entre réplicas e afetar negativamente o desempenho do serviço de pesquisa. O valor utilizado como sessionId não pode começar com um caráter "_".
skip

integer

O número de resultados da pesquisa a ignorar. Este valor não pode ser superior a 100 000. Se precisar de analisar documentos em sequência, mas não puder utilizar ignorar devido a esta limitação, considere utilizar orderby numa chave totalmente ordenada e filtre com uma consulta de intervalo.
top

integer

O número de resultados da pesquisa a obter. Isto pode ser utilizado em conjunto com $skip para implementar a paginação do lado do cliente dos resultados da pesquisa. Se os resultados forem truncados devido à paginação do lado do servidor, a resposta incluirá um token de continuação que pode ser utilizado para emitir outro pedido de Pesquisa para a próxima página de resultados.
vectorFilterMode

VectorFilterMode

Determina se os filtros são aplicados antes ou depois de a pesquisa de vetor ser executada. A predefinição é "preFilter" para novos índices.
vectorQueries VectorQuery[]:

RawVectorQuery[]

Os parâmetros de consulta para consultas de vetor e pesquisa híbrida.

Respostas

Name Tipo Description
200 OK

SearchDocumentsResult

Resposta que contém documentos que correspondem aos critérios de pesquisa.
Other Status Codes

SearchError

Resposta de erro.

Exemplos

SearchIndexSearchDocumentsPost
SearchIndexSearchDocumentsSemanticPost

SearchIndexSearchDocumentsPost

Pedido de amostra

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

{
  "count": true,
  "facets": [
    "category,count:10,sort:count"
  ],
  "filter": "rating gt 4.0",
  "highlight": "description",
  "highlightPostTag": "</em>",
  "highlightPreTag": "<em>",
  "minimumCoverage": null,
  "orderby": "rating desc",
  "queryType": "simple",
  "scoringParameters": [
    "currentLocation--122.123,44.77233"
  ],
  "scoringProfile": "sp",
  "search": "nice hotels",
  "searchFields": "category,description",
  "searchMode": "any",
  "sessionId": "mysessionid",
  "scoringStatistics": "global",
  "select": "hotelId,category,description",
  "skip": 0,
  "top": 10,
  "vectorQueries": [
    {
      "kind": "vector",
      "vector": [
        0.103,
        0.0712,
        0.0852,
        0.1547,
        0.1183
      ],
      "fields": "descriptionEmbedding",
      "k": 5,
      "exhaustive": true
    }
  ],
  "vectorFilterMode": "preFilter"
}

Resposta da amostra

Código de estado:
200 
{
  "@odata.count": 25,
  "@search.facets": {
    "category": [
      {
        "count": 1,
        "value": "Economy"
      },
      {
        "count": 1,
        "value": "Luxury"
      }
    ]
  },
  "@search.nextPageParameters": {
    "count": true,
    "facets": [
      "category,count:10,sort:count"
    ],
    "filter": "rating gt 4.0",
    "highlight": "title",
    "highlightPostTag": "</em>",
    "highlightPreTag": "<em>",
    "minimumCoverage": null,
    "orderby": "search.score() desc,rating desc",
    "queryType": "simple",
    "sessionId": "mysessionid",
    "scoringStatistics": "global",
    "scoringParameters": [
      "currentLocation--122.123,44.77233"
    ],
    "scoringProfile": "sp",
    "search": "nice hotels",
    "searchFields": "title,description",
    "searchMode": "any",
    "select": "docId,title,description",
    "skip": 2,
    "top": 8
  },
  "value": [
    {
      "@search.score": 1.5,
      "@search.highlights": {
        "title": [
          "<em>Nice</em> <em>Hotel</em>"
        ]
      },
      "description": "Cheapest hotel in town",
      "docId": "1",
      "title": "Nice Hotel"
    },
    {
      "@search.score": 0.7,
      "@search.highlights": {
        "title": [
          "Fancy <em>Hotel</em>"
        ]
      },
      "description": "Best hotel in town",
      "docId": "2",
      "title": "Fancy Hotel"
    }
  ],
  "@odata.nextLink": "https://myservice.search.windows.net/indexes('myindex')/docs/search.post.search?api-version=2023-11-01"
}

SearchIndexSearchDocumentsSemanticPost

Pedido de amostra

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

{
  "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
}

Resposta da amostra

Código de estado:
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=2023-11-01"
}

Definições

Name Description
AnswerResult

Uma resposta é uma passagem de texto extraída do conteúdo dos documentos mais relevantes que correspondem à consulta. As respostas são extraídas dos principais resultados da pesquisa. Os candidatos às respostas são classificados e as principais respostas estão selecionadas.
CaptionResult

As legendas são as passagens mais representativas do documento relativamente à consulta de pesquisa. São frequentemente utilizados como resumo do documento. As legendas só são devolvidas para consultas do tipo semantic.
QueryAnswerType

Um valor que especifica se as respostas devem ser devolvidas como parte da resposta da pesquisa.
QueryCaptionType

Um valor que especifica se as legendas devem ser devolvidas como parte da resposta de pesquisa.
QueryType

Especifica a sintaxe da consulta de pesquisa. A predefinição é "simples". Utilize "full" se a consulta utilizar a sintaxe da consulta Lucene.
RawVectorQuery

Os parâmetros de consulta a utilizar para pesquisa de vetores quando é fornecido um valor de vetor não processado.
ScoringStatistics

Um valor que especifica se queremos calcular as estatísticas de classificação (como a frequência do documento) globalmente para uma classificação mais consistente, ou localmente, para uma menor latência. A predefinição é "local". Utilize "global" para agregar estatísticas de classificação globalmente antes de pontuar. A utilização de estatísticas de classificação global pode aumentar a latência das consultas de pesquisa.
SearchDocumentsResult

Resposta que contém resultados de pesquisa de um índice.
SearchError

Descreve uma condição de erro para a API.
SearchMode

Especifica se algum ou todos os termos de pesquisa têm de ser correspondidos para contar o documento como uma correspondência.
SearchRequest

Parâmetros para filtrar, ordenar, facetar, paginar e outros comportamentos de consulta de pesquisa.
SearchResult

Contém um documento encontrado por uma consulta de pesquisa, bem como metadados associados.
SemanticErrorMode

Permite ao utilizador escolher se uma chamada semântica deve falhar completamente (comportamento predefinido/atual) ou devolver resultados parciais.
SemanticErrorReason

Motivo pelo qual foi devolvida uma resposta parcial para um pedido de classificação semântica.
SemanticSearchResultsType

Tipo de resposta parcial devolvida para um pedido de classificação semântica.
VectorFilterMode

Determina se os filtros são ou não aplicados antes ou depois da pesquisa de vetores ser realizada.
VectorQueryKind

O tipo de consulta vetor que está a ser executada.

AnswerResult

Uma resposta é uma passagem de texto extraída do conteúdo dos documentos mais relevantes que correspondem à consulta. As respostas são extraídas dos principais resultados da pesquisa. Os candidatos às respostas são classificados e as principais respostas estão selecionadas.

Name Tipo Description
highlights

string

A mesma passagem de texto que na propriedade Texto com expressões de texto realçadas mais relevantes para a consulta.
key

string

A chave do documento de onde a resposta foi extraída.
score

number

O valor da classificação representa a relevância da resposta para a consulta relativamente a outras respostas devolvidas para a consulta.
text

string

A passagem de texto extraída do conteúdo do documento como resposta.

CaptionResult

As legendas são as passagens mais representativas do documento relativamente à consulta de pesquisa. São frequentemente utilizados como resumo do documento. As legendas só são devolvidas para consultas do tipo semantic.

Name Tipo Description
highlights

string

A mesma passagem de texto que na propriedade Texto com expressões realçadas mais relevantes para a consulta.
text

string

Uma passagem de texto representativa extraída do documento mais relevante para a consulta de pesquisa.

QueryAnswerType

Um valor que especifica se as respostas devem ser devolvidas como parte da resposta da pesquisa.

Name Tipo Description
extractive

string

Extrai os candidatos de resposta dos conteúdos dos documentos devolvidos em resposta a uma consulta expressa como uma pergunta em linguagem natural.
none

string

Não devolva respostas para a consulta.

QueryCaptionType

Um valor que especifica se as legendas devem ser devolvidas como parte da resposta de pesquisa.

Name Tipo Description
extractive

string

Extrai legendas dos documentos correspondentes que contêm passagens relevantes para a consulta de pesquisa.
none

string

Não devolva legendas para a consulta.

QueryType

Especifica a sintaxe da consulta de pesquisa. A predefinição é "simples". Utilize "full" se a consulta utilizar a sintaxe da consulta Lucene.

Name Tipo Description
full

string

Utiliza a sintaxe de consulta Lucene completa para pesquisas. O texto de pesquisa é interpretado com a linguagem de consulta Lucene que permite pesquisas específicas e ponderadas do campo, bem como outras funcionalidades avançadas.
semantic

string

Mais adequado para consultas expressas em linguagem natural em oposição a palavras-chave. Melhora a precisão dos resultados da pesquisa ao voltar a classificar os principais resultados de pesquisa com um modelo de classificação preparado no corpus Web.
simple

string

Utiliza a sintaxe de consulta simples para pesquisas. O texto de pesquisa é interpretado com uma linguagem de consulta simples que permite símbolos como +, * e "". As consultas são avaliadas em todos os campos pesquisáveis por predefinição, a menos que o parâmetro searchFields seja especificado.

RawVectorQuery

Os parâmetros de consulta a utilizar para pesquisa de vetores quando é fornecido um valor de vetor não processado.

Name Tipo Description
exhaustive

boolean

Quando verdadeiro, aciona uma pesquisa de vizinho k-próxima exaustiva em todos os vetores dentro do índice de vetor. Útil para cenários em que as correspondências exatas são críticas, como determinar valores de verdade básica.
fields

string

Campos de Vetor do tipo Coleção(Edm.Single) a incluir no vetor pesquisado.
k

integer

Número de vizinhos mais próximos a regressar à medida que os primeiros atingem.
kind string:

vector

O tipo de consulta de vetor que está a ser executada.
vector

number[]

A representação de vetor de uma consulta de pesquisa.

ScoringStatistics

Um valor que especifica se queremos calcular as estatísticas de classificação (como a frequência do documento) globalmente para uma classificação mais consistente, ou localmente, para uma menor latência. A predefinição é "local". Utilize "global" para agregar estatísticas de classificação globalmente antes de pontuar. A utilização de estatísticas de classificação global pode aumentar a latência das consultas de pesquisa.

Name Tipo Description
global

string

As estatísticas de classificação serão calculadas globalmente para uma classificação mais consistente.
local

string

As estatísticas de classificação serão calculadas localmente para uma latência mais baixa.

SearchDocumentsResult

Resposta que contém resultados de pesquisa de um índice.

Name Tipo Description
@odata.count

integer

A contagem total de resultados encontrados pela operação de pesquisa ou nulo se a contagem não tiver sido pedida. Se estiver presente, a contagem pode ser maior do que o número de resultados nesta resposta. Isto pode acontecer se utilizar os parâmetros $top ou $skip ou se a consulta não conseguir devolver todos os documentos pedidos numa única resposta.
@odata.nextLink

string

URL de continuação devolvido quando a consulta não consegue devolver todos os resultados pedidos numa única resposta. Pode utilizar este URL para formular outro pedido GET ou POST Search para obter a próxima parte da resposta de pesquisa. Certifique-se de que utiliza o mesmo verbo (GET ou POST) que o pedido que produziu esta resposta.
@search.answers

AnswerResult[]

Os resultados da consulta de respostas para a operação de pesquisa; nulo se o parâmetro de consulta de respostas não tiver sido especificado ou definido como "nenhum".
@search.coverage

number

Um valor que indica a percentagem do índice incluído na consulta ou nulo se minimumCoverage não tiver sido especificado no pedido.
@search.facets

object

Os resultados da consulta faceta para a operação de pesquisa, organizados como uma coleção de registos para cada campo facetado; nulo se a consulta não incluir expressões de facetas.
@search.nextPageParameters

SearchRequest

Payload JSON de continuação devolvido quando a consulta não consegue devolver todos os resultados pedidos numa única resposta. Pode utilizar este JSON juntamente com @odata.nextLink para formular outro pedido post search para obter a próxima parte da resposta de pesquisa.
@search.semanticPartialResponseReason

SemanticErrorReason

Motivo pelo qual foi devolvida uma resposta parcial para um pedido de classificação semântica.
@search.semanticPartialResponseType

SemanticSearchResultsType

Tipo de resposta parcial que foi devolvida para um pedido de classificação semântica.
value

SearchResult[]

A sequência de resultados devolvida pela consulta.

SearchError

Descreve uma condição de erro para a API.

Name Tipo Description
code

string

Um dos conjuntos de códigos de erro definidos pelo servidor.
details

SearchError[]

Uma série de detalhes sobre erros específicos que levaram a este erro comunicado.
message

string

Uma representação legível por humanos do erro.

SearchMode

Especifica se algum ou todos os termos de pesquisa têm de ser correspondidos para contar o documento como uma correspondência.

Name Tipo Description
all

string

Todos os termos de pesquisa têm de ser correspondidos para contar o documento como uma correspondência.
any

string

Qualquer um dos termos de pesquisa tem de ser correspondido para contar o documento como uma correspondência.

SearchRequest

Parâmetros para filtrar, ordenar, facetar, paginar e outros comportamentos de consulta de pesquisa.

Name Tipo Description
answers

QueryAnswerType

Um valor que especifica se as respostas devem ser devolvidas como parte da resposta de pesquisa.
captions

QueryCaptionType

Um valor que especifica se as legendas devem ser devolvidas como parte da resposta da pesquisa.
count

boolean

Um valor que especifica se pretende obter a contagem total de resultados. A predefinição é falso. Definir este valor como verdadeiro pode ter um impacto no desempenho. Tenha em atenção que a contagem devolvida é uma aproximação.
facets

string[]

A lista de expressões de facetas a aplicar à consulta de pesquisa. Cada expressão de faceta contém um nome de campo, opcionalmente seguido de uma lista separada por vírgulas de pares name:value.
filter

string

O OData $filter expressão a aplicar à consulta de pesquisa.
highlight

string

A lista separada por vírgulas de nomes de campo a utilizar para os destaques de acesso. Apenas os campos pesquisáveis podem ser utilizados para o realce de resultados.
highlightPostTag

string

Uma etiqueta de cadeia de carateres que é anexada para obter destaques. Tem de ser definido com highlightPreTag. A predefinição é </em>.
highlightPreTag

string

Uma etiqueta de cadeia de carateres que está pré-anexada para obter destaques. Tem de ser definido com highlightPostTag. A predefinição é <em>.
minimumCoverage

number

Um número entre 0 e 100 que indica a percentagem do índice que tem de ser abrangido por uma consulta de pesquisa para que a consulta seja reportada como um êxito. Este parâmetro pode ser útil para garantir a disponibilidade da pesquisa, mesmo para serviços com apenas uma réplica. A predefinição é 100.
orderby

string

A lista separada por vírgulas de OData $orderby expressões pelas quais ordenar os resultados. Cada expressão pode ser um nome de campo ou uma chamada para as funções geo.distance() ou search.score(). Cada expressão pode ser seguida por asc para indicar ascendente ou desc para indicar descendente. A predefinição é ordem ascendente. Os empates serão quebrados pelas pontuações de correspondência de documentos. Se não for especificada nenhuma $orderby, a sequência de ordenação predefinida é descendente por classificação de correspondência do documento. Pode haver, no máximo, 32 cláusulas de $orderby.
queryType

QueryType

Um valor que especifica a sintaxe da consulta de pesquisa. A predefinição é "simples". Utilize "full" se a consulta utilizar a sintaxe de consulta Lucene.
scoringParameters

string[]

A lista de valores de parâmetros a utilizar nas funções de classificação (por exemplo, referencePointParameter) com o formato name-values. Por exemplo, se o perfil de classificação definir uma função com um parâmetro chamado "mylocation", a cadeia de parâmetros será "mylocation--122.2,44.8" (sem as aspas).
scoringProfile

string

O nome de um perfil de classificação para avaliar pontuações de correspondência para documentos correspondentes para ordenar os resultados.
scoringStatistics

ScoringStatistics

Um valor que especifica se queremos calcular as estatísticas de classificação (como a frequência do documento) globalmente para uma classificação mais consistente, ou localmente, para uma menor latência. A predefinição é "local". Utilize "global" para agregar estatísticas de classificação globalmente antes de classificar. A utilização de estatísticas de classificação globais pode aumentar a latência das consultas de pesquisa.
search

string

Uma expressão de consulta de pesquisa em texto completo; Utilize "*" ou omita este parâmetro para corresponder a todos os documentos.
searchFields

string

A lista separada por vírgulas de nomes de campo para definir o âmbito da pesquisa em texto completo. Ao utilizar a pesquisa em campo (fieldName:searchExpression) numa consulta Lucene completa, os nomes de campo de cada expressão de pesquisa em campo têm precedência sobre quaisquer nomes de campo listados neste parâmetro.
searchMode

SearchMode

Um valor que especifica se algum ou todos os termos de pesquisa têm de ser correspondidos para contar o documento como uma correspondência.
select

string

A lista de campos separados por vírgulas a obter. Se não for especificado, todos os campos marcados como recuperáveis no esquema são incluídos.
semanticConfiguration

string

O nome de uma configuração semântica que será utilizada ao processar documentos para consultas do tipo semântico.
semanticErrorHandling

SemanticErrorMode

Permite ao utilizador escolher se uma chamada semântica deve falhar completamente (comportamento predefinido/atual) ou devolver resultados parciais.
semanticMaxWaitInMilliseconds

integer

Permite que o utilizador defina um limite superior sobre a quantidade de tempo que o melhoramento semântico demora a concluir o processamento antes de o pedido falhar.
sessionId

string

Um valor a ser utilizado para criar uma sessão autocolante, o que pode ajudar a obter resultados mais consistentes. Desde que o mesmo sessionId seja utilizado, será efetuada uma tentativa de melhor esforço para direcionar o mesmo conjunto de réplicas. Tenha em atenção que reutilizar repetidamente os mesmos valores sessionID pode interferir com o balanceamento de carga dos pedidos entre réplicas e afetar negativamente o desempenho do serviço de pesquisa. O valor utilizado como sessionId não pode começar com um caráter "_".
skip

integer

O número de resultados da pesquisa a ignorar. Este valor não pode ser superior a 100 000. Se precisar de analisar documentos em sequência, mas não puder utilizar ignorar devido a esta limitação, considere utilizar orderby numa chave totalmente ordenada e filtre com uma consulta de intervalo.
top

integer

O número de resultados da pesquisa a obter. Isto pode ser utilizado em conjunto com $skip para implementar a paginação do lado do cliente dos resultados da pesquisa. Se os resultados forem truncados devido à paginação do lado do servidor, a resposta incluirá um token de continuação que pode ser utilizado para emitir outro pedido de Pesquisa para a próxima página de resultados.
vectorFilterMode

VectorFilterMode

Determina se os filtros são aplicados antes ou depois de a pesquisa de vetor ser executada. A predefinição é "preFilter" para novos índices.
vectorQueries VectorQuery[]:

RawVectorQuery[]

Os parâmetros de consulta para consultas de vetor e pesquisa híbrida.

SearchResult

Contém um documento encontrado por uma consulta de pesquisa, bem como metadados associados.

Name Tipo Description
@search.captions

CaptionResult[]

As legendas são as passagens mais representativas do documento relativamente à consulta de pesquisa. São frequentemente utilizados como resumo do documento. As legendas só são devolvidas para consultas do tipo semantic.
@search.highlights

object

Fragmentos de texto do documento que indicam os termos de pesquisa correspondentes, organizados por cada campo aplicável; null if hit highlighting was not enabled for the query.
@search.rerankerScore

number

A classificação de relevância calculada pelo classificador semântico para os principais resultados da pesquisa. Os resultados da pesquisa são ordenados primeiro pelo RerankerScore e, em seguida, pela Pontuação. RerankerScore só é devolvido para consultas do tipo semantic.
@search.score

number

A classificação de relevância do documento em comparação com outros documentos devolvidos pela consulta.

SemanticErrorMode

Permite ao utilizador escolher se uma chamada semântica deve falhar completamente (comportamento predefinido/atual) ou devolver resultados parciais.

Name Tipo Description
fail

string

Se existir uma exceção durante o passo de processamento semântico, a consulta falhará e devolverá o código HTTP adequado consoante o erro.
partial

string

Se o processamento semântico falhar, os resultados parciais continuarão a ser devolvidos. A definição de resultados parciais depende do passo semântico que falhou e qual foi o motivo da falha.

SemanticErrorReason

Motivo pelo qual foi devolvida uma resposta parcial para um pedido de classificação semântica.

Name Tipo Description
capacityOverloaded

string

O pedido foi limitado. Apenas os resultados base foram devolvidos.
maxWaitExceeded

string

Se semanticMaxWaitInMilliseconds foi definido e a duração do processamento semântico excedeu esse valor. Apenas os resultados base foram devolvidos.
transient

string

Pelo menos um passo do processo semântico falhou.

SemanticSearchResultsType

Tipo de resposta parcial devolvida para um pedido de classificação semântica.

Name Tipo Description
baseResults

string

Resultados sem qualquer melhoramento semântico ou refrancagem.
rerankedResults

string

Os resultados foram reclassificados com o modelo de reranker e incluirão legendas semânticas. Não incluirão respostas, destaques de respostas ou destaques legenda.

VectorFilterMode

Determina se os filtros são ou não aplicados antes ou depois da pesquisa de vetores ser realizada.

Name Tipo Description
postFilter

string

O filtro será aplicado após o conjunto de candidatos dos resultados do vetor ser devolvido. Consoante a selectividade do filtro, isto pode resultar em menos resultados do que os pedidos pelo parâmetro 'k'.
preFilter

string

O filtro será aplicado antes da consulta de pesquisa.

VectorQueryKind

O tipo de consulta vetor que está a ser executada.

Name Tipo Description
vector

string

Consulta de vetor onde é fornecido um valor de vetor não processado.