Documents - Autocomplete Get

Referência

Serviço:: Search Service

Versão da API:: 2023-10-01-Preview

Preenchimento automático de termos de consulta incompletos com base no texto de entrada e nos termos correspondentes no índice.

GET {endpoint}/indexes('{indexName}')/docs/search.autocomplete?api-version=2023-10-01-Preview&search={search}&suggesterName={suggesterName}

Com parâmetros opcionais:

GET {endpoint}/indexes('{indexName}')/docs/search.autocomplete?api-version=2023-10-01-Preview&search={search}&suggesterName={suggesterName}&autocompleteMode={autocompleteMode}&$filter={$filter}&fuzzy={fuzzy}&highlightPostTag={highlightPostTag}&highlightPreTag={highlightPreTag}&minimumCoverage={minimumCoverage}&searchFields={searchFields}&$top={$top}

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string	A URL do ponto de extremidade do serviço de pesquisa.
indexName	path	True	string	O nome do índice.
api-version	query	True	string	Versão da API do cliente.
search	query	True	string	O termo incompleto que deve ser concluído automaticamente.
suggesterName	query	True	string	O nome do sugestor conforme especificado na coleção de sugestores que faz parte da definição de índice.
$filter	query		string	Uma expressão OData que filtra os documentos usados para produzir termos concluídos para o resultado do preenchimento automático.
$top	query		integer int32	O número de termos concluídos automaticamente a serem recuperados. Esse deve ser um valor entre 1 e 100. O padrão é 5.
autocompleteMode	query		AutocompleteMode	Especifica o modo de preenchimento automático. O padrão é 'oneTerm'. Use 'twoTerms' para obter telhas e 'oneTermWithContext' para usar o contexto atual ao produzir termos concluídos automaticamente.
fuzzy	query		boolean	Um valor que indica se a correspondência difusa deve ser usada para a consulta de preenchimento automático. O padrão é false. Quando definida como true, a consulta encontrará termos mesmo se houver um caractere substituído ou ausente no texto da pesquisa. Embora isso forneça uma experiência melhor em alguns cenários, ele tem um custo de desempenho, pois as consultas de preenchimento automático difuso são mais lentas e consomem mais recursos.
highlightPostTag	query		string	Uma marca de cadeia de caracteres que é acrescentada para atingir realces. Deve ser definido com highlightPreTag. Se omitido, o realce de cliques será desabilitado.
highlightPreTag	query		string	Uma marca de cadeia de caracteres que é prefixada para atingir realces. Deve ser definido com highlightPostTag. Se omitido, o realce de cliques será desabilitado.
minimumCoverage	query		number double	Um número entre 0 e 100 indicando o percentual do índice que deve ser coberto por uma consulta de preenchimento automático para que a consulta seja relatada como um sucesso. Esse parâmetro pode ser útil para garantir a disponibilidade de pesquisa mesmo para serviços com apenas um réplica. O padrão é 80.
searchFields	query		string[]	A lista de nomes de campo a serem considerados ao consultar termos concluídos automaticamente. Os campos de destino devem ser incluídos no sugestor especificado.

Cabeçalho da solicitação

Nome	Obrigatório	Tipo	Description
x-ms-client-request-id		string uuid	A ID de rastreamento enviada com a solicitação para ajudar na depuração.

Respostas

Nome	Tipo	Description
200 OK	AutocompleteResult	Resposta que contém termos de consulta sugeridos que completam a entrada parcial.
Other Status Codes	SearchError	Resposta de erro.

Exemplos

SearchIndexAutocompleteDocumentsGet

Solicitação de exemplo

HTTP

GET https://myservice.search.windows.net/indexes('myindex')/docs/search.autocomplete?api-version=2023-10-01-Preview&search=washington medic&suggesterName=sg&autocompleteMode=oneTerm&fuzzy=False&highlightPostTag=</em>&highlightPreTag=<em>&minimumCoverage=80&searchFields=title,description

Resposta de exemplo

Código de status:: 200

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

Definições

Nome	Description
AutocompleteItem	O resultado das solicitações de preenchimento automático.
AutocompleteMode	Especifica o modo de preenchimento automático. O padrão é 'oneTerm'. Use 'twoTerms' para obter telhas e 'oneTermWithContext' para usar o contexto atual na produção de termos de preenchimento automático.
AutocompleteResult	O resultado da consulta de preenchimento automático.
SearchError	Descreve uma condição de erro para a API.

AutocompleteItem

O resultado das solicitações de preenchimento automático.

Nome	Tipo	Description
queryPlusText	string	A consulta junto com o termo concluído.
text	string	O termo concluído.

AutocompleteMode

Especifica o modo de preenchimento automático. O padrão é 'oneTerm'. Use 'twoTerms' para obter telhas e 'oneTermWithContext' para usar o contexto atual na produção de termos de preenchimento automático.

Nome	Tipo	Description
oneTerm	string	Apenas um termo é sugerido. Se a consulta tiver dois termos, somente o último termo será concluído. Por exemplo, se a entrada for "médico de Washington", os termos sugeridos podem incluir "medicaid", "medicare" e "medicina".
oneTermWithContext	string	Conclui o último termo em uma consulta com dois ou mais termos, em que os dois últimos termos são uma frase que existe no índice. Por exemplo, se a entrada for "médica de Washington", os termos sugeridos podem incluir "washington medicaid" e "washington medical".
twoTerms	string	A correspondência de frases de dois termos no índice será sugerida. Por exemplo, se a entrada for "médica", os termos sugeridos podem incluir "cobertura do medicare" e "assistente médica".

AutocompleteResult

O resultado da consulta de preenchimento automático.

Nome	Tipo	Description
@search.coverage	number	Um valor que indica o percentual do índice que foi considerado pela solicitação de preenchimento automático ou nulo se minimumCoverage não foi especificado na solicitação.
value	AutocompleteItem[]	A lista de itens autocompletados retornados.

SearchError

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

Nome	Tipo	Description
code	string	Um de um conjunto definido pelo servidor de códigos de erro.
details	SearchError[]	Uma matriz de detalhes sobre erros específicos que levaram a esse erro relatado.
message	string	Uma representação legível pelo homem do erro.

Compartilhar via