Documents - Search Post

Service:

Search Service

API Version:

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

Sample Request

HTTP

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

Sample Response

Status code:

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

Sample Request

HTTP

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
}

Sample Response

Status code:

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.