Consultando na Pesquisa de IA do Azure

Nota

O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.

O Pesquisa de IA do Azure dá suporte a construções de consulta para uma ampla gama de cenários, desde a pesquisa de texto de forma livre até padrões de consulta altamente especificados e a pesquisa vetorial. Todas as consultas são executadas em um índice de pesquisa que armazena conteúdo pesquisável.

Tipos de consultas

Formulário de consulta Conteúdo pesquisável Descrição
Pesquisa de texto completo Índices invertidos de termos tokenizados. As consultas de texto completo percorrem índices invertidos estruturados para pesquisas rápidas, onde uma correspondência pode ser encontrada potencialmente em qualquer campo, entre qualquer número de documentos de pesquisa. O texto é analisado e tokenizado para pesquisa em texto completo.
Pesquisa vetorial Índices vetoriais de incorporações geradas. As consultas vetoriais iteram sobre campos vetoriais em um índice de pesquisa.
Pesquisa híbrida Tudo isto num único índice de pesquisa. Combina pesquisa de texto e pesquisa vetorial em uma única solicitação de consulta. A pesquisa de texto funciona em conteúdo de texto simples em campos pesquisáveis. Os filtros aplicam-se a campos filtráveis. A pesquisa vetorial funciona em campos vetoriais.
Recuperação de comportamento autónomo (visualização) Tudo isto num único índice de pesquisa. Este é um caminho de recuperação alternativo no Pesquisa de IA do Azure que aproveita modelos de linguagem grandes para planejamento de consultas. A resposta é projetada para uso pelo agente, onde é o agente, e não o código do cliente da aplicação de pesquisa, que coordena a resposta entregue ao utilizador.
Outros Texto simples e conteúdo legível por humanos. Conteúdo bruto, extraído literalmente de documentos de origem, filtros de suporte e consultas de correspondência de padrões, como pesquisa geoespacial, pesquisa difusa e pesquisa em campo.

O restante deste artigo traz o foco para a última categoria: consultas clássicas que funcionam em texto simples e conteúdo legível por humanos, extraídas intactas da fonte original, usadas para filtros e outros formulários de consulta especializados. Se você estiver criando um aplicativo de pesquisa tradicional que não esteja usando IA, esta seção explica os métodos de consulta que você pode implementar no código do cliente.

Preenchimento automático e consultas sugeridas

O preenchimento automático ou os resultados sugeridos são alternativas a search que disparam solicitações de consulta sucessivas com base em entradas parciais de texto (após cada caractere) numa experiência de pesquisa à medida que escreve. Você pode usar os parâmetros autocomplete e suggestions juntos ou separadamente, conforme descrito neste passo a passo, mas não pode usá-los com search. Tanto os termos concluídos quanto as consultas sugeridas são derivados do conteúdo do índice. O mecanismo nunca retorna uma cadeia de caracteres ou sugestão que é inexistente em seu índice. Para obter mais informações, consulte Preenchimento automático (API REST) e Sugestões (API REST).

Os filtros são amplamente utilizados em aplicações baseadas na Pesquisa de IA do Azure. Nas páginas de aplicativos, os filtros geralmente são visualizados como facetas em estruturas de navegação de links para filtragem direcionada ao usuário. Os filtros também são usados internamente para expor fatias de conteúdo indexado. Por exemplo, você pode inicializar uma página de pesquisa usando um filtro em uma categoria de produto ou um idioma se um índice contiver campos em inglês e francês.

Você também pode precisar de filtros para invocar um formulário de consulta especializado, conforme descrito na tabela a seguir. Você pode usar um filtro com uma pesquisa não especificada (search=*) ou com uma cadeia de caracteres de consulta que inclua termos, frases, operadores e padrões.

Cenário de filtro Descrição
Filtros de gama No Pesquisa de IA do Azure, as consultas por intervalo são construídas usando o filter parâmetro. Para obter mais informações e exemplos, consulte Exemplo de filtro de intervalo.
Navegação por facetas Na árvore de navegação facetada, os usuários podem selecionar facetas. Quando apoiados por filtros, os resultados da pesquisa diminuem a cada clique. Cada faceta é apoiada por um filtro que exclui documentos que já não correspondem aos critérios fornecidos pela faceta.

Nota

O texto usado em uma expressão de filtro não é analisado durante o processamento da consulta. Presume-se que a entrada de texto seja um padrão de caractere literal que diferencia maiúsculas de minúsculas que é bem-sucedido ou falha na correspondência. As expressões de filtro são construídas usando a sintaxe OData e passadas num filter parâmetro em todos os campos filtráveis no índice. Para obter mais informações, consulte Filtros no Pesquisa de IA do Azure.

A pesquisa geoespacial faz corresponder as coordenadas de latitude e longitude de um local para "procurar perto de mim" ou uma experiência de pesquisa baseada em mapas. No Pesquisa de IA do Azure, você pode implementar a pesquisa geoespacial seguindo estas etapas:

  1. Defina um campo filtrável do tipo Edm.GeographyPoint ou Collection(Edm.GeographyPoint).
  2. Verifique se os documentos recebidos incluem as coordenadas apropriadas.
  3. Após a conclusão da indexação, crie uma consulta que use um filtro e uma função geoespacial.

A pesquisa geoespacial utiliza quilómetros para distância. As coordenadas são especificadas neste formato: (longitude, latitude).

Aqui está um exemplo de um filtro para pesquisa geoespacial. Este filtro encontra outros Location campos no índice de pesquisa que têm coordenadas num raio de 300 quilómetros do ponto geográfico (neste exemplo, Washington D.C.). Ele retorna informações de endereço no resultado e inclui uma cláusula opcional facets para autonavegação com base na localização.

POST https://{{searchServiceName}}.search.windows.net/indexes/hotels-vector-quickstart/docs/search?api-version=2026-04-01
{
    "count": true,
    "search": "*",
    "filter": "geo.distance(Location, geography'POINT(-77.03241 38.90166)') le 300",
    "facets": [ "Address/StateProvince"],
    "select": "HotelId, HotelName, Address/StreetAddress, Address/City, Address/StateProvince",
    "top": 7
}

Para obter mais informações e exemplos, consulte Exemplo de pesquisa geoespacial.

Pesquisa de documentos

Em contraste com os formulários de consulta descritos anteriormente, este recupera um único documento de pesquisa por ID, sem pesquisa ou verificação de índice correspondente. Apenas um documento é solicitado e devolvido. Quando um usuário seleciona um item nos resultados da pesquisa, recuperar o documento e preencher uma página de detalhes com campos é uma resposta típica, e uma pesquisa de documento é a operação que oferece suporte a ele.

Pesquisa avançada: fuzzy, wildcard, proximity, regex

Um formulário de consulta avançado depende do analisador Lucene completo e dos operadores que acionam um comportamento de consulta específico.

Tipo de consulta Utilização Exemplos e mais informações
Pesquisa em campo search parâmetro, queryType=full Crie uma expressão de consulta composta direcionada a um único campo.
Exemplo de pesquisa em campo
Pesquisa difusa search parâmetro, queryType=full Fazer corresponder termos com estrutura ou grafia semelhantes.
Exemplo de pesquisa difusa
Pesquisa de proximidade search parâmetro, queryType=full Encontre termos que estejam próximos uns dos outros num documento.
Exemplo de pesquisa de proximidade
Reforço de termos search parâmetro, queryType=full Classifica um documento mais acima se ele contiver o termo reforçado, em comparação com outros que não o tenham.
Exemplo de reforço de termos
Pesquisa por expressões regulares search parâmetro, queryType=full Faz a correspondência com base no conteúdo de uma expressão regular.
Exemplo de expressão regular
Pesquisa por caráter universal ou por prefixo search parâmetro com * ou ?, queryType=full Faz corresponder com base num prefixo, múltiplos caracteres (*) ou um carácter (?).
Exemplo de pesquisa curinga

Próximos passos

Para ver mais detalhadamente a implementação da consulta, revise os exemplos de cada sintaxe. Se é novo na pesquisa por texto completo, talvez queira também saber mais sobre o que faz o motor de consultas.

  • Last updated on