Partilhar via


Guia de início rápido: criar um índice de pesquisa no portal do Azure

Neste início rápido, você cria seu primeiro índice do Azure AI Search usando o assistente Importar dados e uma amostra interna de dados fictícios de hotéis hospedados pela Microsoft. O assistente não requer código para criar um índice, ajudando você a escrever consultas interessantes em poucos minutos.

O assistente cria vários objetos em seu serviço de pesquisa, incluindo um índice pesquisável, um indexador e uma conexão de fonte de dados para recuperação automatizada de dados. No final deste início rápido, analisamos cada objeto.

Nota

O assistente Importar dados inclui opções para OCR, tradução de texto e outros enriquecimentos de IA que não são abordados neste início rápido. Para obter um passo a passo semelhante que se concentra na IA aplicada, consulte Guia de início rápido: criar um conjunto de habilidades no portal do Azure.

Pré-requisitos

Verificar o acesso à rede

Para este início rápido, que usa dados de exemplo internos, verifique se o serviço de pesquisa não tem controles de acesso à rede. O controlador do portal do Azure usa um ponto de extremidade público para recuperar dados e metadados da fonte de dados hospedada pela Microsoft. Para obter mais informações, consulte Conexões seguras nos assistentes de importação.

Verificar o espaço

Muitos clientes começam com um serviço de pesquisa gratuito, que é limitado a três índices, três indexadores e três fontes de dados. Este guia de início rápido cria um de cada um, portanto, antes de começar, certifique-se de ter espaço para objetos extras.

Na guia Visão geral , selecione Uso para ver quantos índices, indexadores e fontes de dados você tem atualmente.

Captura de ecrã da página Descrição Geral de uma instância do serviço Azure AI Search no portal do Azure, mostrando o número de índices, indexadores e origens de dados.

Iniciar o assistente

  1. Inicie sessão no portal Azure.

  2. Aceda ao seu serviço de pesquisa.

  3. Na guia Visão geral , selecione Importar dados para iniciar o assistente.

    Captura de ecrã que mostra como abrir o assistente Importar dados no portal do Azure.

Criar e carregar um índice de pesquisa

Nesta seção, você cria e carrega um índice em quatro etapas:

  1. Conectar-se a uma fonte de dados
  2. Omitir configurações para habilidades cognitivas
  3. Configurar o índice
  4. Configurar e executar o indexador

Ligar a uma origem de dados

O assistente cria uma ligação de origem de dados a dados de exemplo que a Microsoft mantém no Azure Cosmos DB. Os dados de exemplo são acedidos através de um ponto de extremidade público, pelo que não precisas de uma conta do Azure Cosmos DB ou de ficheiros de origem para este passo.

Para se conectar aos dados de exemplo:

  1. Em Conectar aos seus dados, expanda a lista suspensa Fonte de Dados e selecione Exemplos.

  2. Selecione hotels-sample na lista de amostras integradas.

  3. Selecione Next: Add cognitive skills (Optional) para continuar.

    Captura de tela que mostra como selecionar a fonte de dados de exemplo de hotéis no assistente Importar dados.

Pular configuração para habilidades cognitivas

Embora o assistente suporte a criação de conjuntos de habilidades e o enriquecimento da IA durante a indexação, as habilidades cognitivas estão além do escopo deste início rápido.

Para pular esta etapa no assistente de configuração:

  1. Em Adicionar habilidades cognitivas, ignore as opções de configuração de enriquecimento de IA.

  2. Selecione Next: Personalizar índice de destino para continuar.

    Captura de ecrã que mostra como Saltar para o separador Personalizar índice de destino no assistente Importar dados.

Gorjeta

Para começar a usar o enriquecimento de IA, consulte Guia de início rápido: criar um conjunto de habilidades no portal do Azure.

Configurar o índice

O assistente deduz um esquema para o índice de exemplo de hotéis. Para configurar o índice:

  1. Aceite os valores gerados pelo sistema para o nome do índice (hotels-sample-index) e Key (HotelId).

  2. Aceite os valores gerados pelo sistema para todos os atributos de campo.

  3. Selecione Avançar: Criar um indexador para continuar.

    Captura de tela que mostra a definição de índice gerada para a fonte de dados de exemplo de hotéis no assistente Importar dados.

No mínimo, o índice de pesquisa requer um nome e uma coleção de campos. O assistente verifica campos de cadeia de caracteres exclusivos e marca um como a chave do documento, que identifica exclusivamente cada documento no índice.

Cada campo tem um nome, um tipo de dados e atributos que controlam como o campo é usado no índice. Use as caixas de seleção para habilitar ou desabilitar os seguintes atributos:

Atributo Descrição Tipos de dados aplicáveis
Recuperável Campos retornados numa resposta de consulta. Strings e inteiros
Filtrável Campos que aceitam uma expressão de filtro. Números inteiros
Ordenável Campos que aceitam uma expressão orderby. Números inteiros
Facetável Campos utilizados numa estrutura de navegação facetada. Números inteiros
Pesquisável Campos utilizados na pesquisa de texto completo. As cadeias de caracteres são pesquisáveis, mas os campos numéricos e booleanos são frequentemente marcados como não pesquisáveis. Cordas

Os atributos afetam o armazenamento de maneiras diferentes. Por exemplo, os campos filtráveis consomem armazenamento extra, enquanto os campos recuperáveis não. Para obter mais informações, consulte Exemplo demonstrando as implicações de armazenamento de atributos e sugestões.

Se desejar preencher automaticamente ou sugerir consultas, especifique Analisadores ou Sugestões de idioma.

Configurar e executar o indexador

Finalmente, você configura e executa o indexador, que define um processo executável. A fonte de dados e o índice também são criados nesta etapa.

Para configurar e executar o indexador:

  1. Aceite o valor gerado pelo sistema para o nome do indexador (hotels-sample-indexer).

  2. Para este início rápido, use a opção padrão para executar o indexador imediatamente e apenas uma vez. Os dados de exemplo são estáticos, portanto, você não pode habilitar o controle de alterações.

  3. Selecione Enviar para criar e executar simultaneamente o indexador.

    Captura de tela que mostra como configurar o indexador para a fonte de dados de exemplo de hotéis no assistente Importar dados.

Monitorar o progresso do indexador

Você pode monitorar a criação do indexador e do índice no portal do Azure. A guia Visão geral fornece links para os recursos criados em seu serviço de pesquisa.

Para monitorar o progresso do indexador:

  1. Vá para o seu serviço de pesquisa no portal do Azure.

  2. No painel esquerdo, selecione Indexadores.

    Captura de ecrã que mostra a criação do indexador em curso no portal do Azure.

    Pode levar alguns minutos para que os resultados sejam atualizados. Você deve ver o indexador recém-criado com um status de Em andamento ou Sucesso. A lista também mostra o número de documentos indexados.

Verificar os resultados do índice de pesquisa

  1. Vá para o seu serviço de pesquisa no portal do Azure.

  2. No painel esquerdo, selecione Índices.

  3. Selecione hotels-sample-index. Se o índice tiver zero documentos ou armazenamento, aguarde até que o portal do Azure seja atualizado.

    Captura de ecrã da lista Índices no dashboard do serviço Azure AI Search no portal do Azure.

  4. Selecione a guia Campos para exibir o esquema de índice.

  5. Verifique quais campos são Filtráveis ou Classificáveis para saber quais consultas escrever.

    Captura de ecrã que mostra a definição de esquema para um índice no serviço Azure AI Search no portal do Azure.

Adicionar ou alterar campos

Na guia Campos , você pode criar um campo selecionando Adicionar campo e especificando um nome, tipo de dados suportado e atributos.

Mudar os campos existentes é mais difícil. Os campos existentes têm uma representação física no índice de pesquisa, por isso não são modificáveis, nem mesmo no código. Para alterar fundamentalmente um campo existente, você deve criar um novo campo para substituir o original. Você pode adicionar outras construções, como perfis de pontuação e opções de CORS, a um índice a qualquer momento.

Revise as opções de definição de índice para entender o que você pode ou não editar durante o design do índice. Se uma opção aparecer esmaecida, não será possível modificá-la ou excluí-la.

Consultar com o Explorador de procura

Agora você tem um índice de pesquisa que pode ser consultado usando o explorador de pesquisa, que envia chamadas REST em conformidade com a API REST de pesquisa POST. Esta ferramenta suporta sintaxe de consulta simples e sintaxe de consulta Lucene completa.

Para consultar o índice de pesquisa:

  1. No separador Explorador de pesquisa, introduza texto para pesquisar.

    Captura de ecrã que mostra como introduzir e executar uma consulta na ferramenta Explorador de Pesquisa.

  2. Para saltar para áreas não visíveis da saída, use o mini mapa.

    Captura de ecrã que mostra resultados longos para uma consulta na ferramenta Explorador de Pesquisa e no minimapa.

  3. Para especificar a sintaxe, alterne para o modo de exibição JSON.

    Captura de tela do seletor de exibição JSON.

Exemplos de consultas para índice de amostra de hotéis

Os exemplos a seguir assumem a exibição JSON e a versão 2024-05-01-preview REST API.

Gorjeta

A visualização JSON suporta o Intellisense para conclusão de nome de parâmetro. Coloque o cursor dentro da visualização JSON e digite um caractere de espaço para ver uma lista de todos os parâmetros de consulta. Você também pode digitar uma letra, como "s", para ver apenas os parâmetros de consulta que começam com essa letra. O Intellisense não exclui parâmetros inválidos, por isso utilize o seu melhor julgamento.

Exemplos de filtros

Estacionamento, tags, data de renovação, classificação e localização são filtráveis.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "Rating gt 4"
}

Os filtros booleanos assumem "true" por padrão.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "ParkingIncluded"
}

A pesquisa geoespacial é baseada em filtros. A geo.distance função filtra todos os resultados para dados posicionais com base no especificado Location e geography'POINT coordenadas. A consulta procura hotéis a menos de cinco quilômetros das coordenadas -122.12 47.67de latitude e longitude, que é "Redmond, Washington, EUA". A consulta exibe o número total de correspondências &$count=true com os nomes dos hotéis e os locais de endereço.

{
    "search": "*",
    "select": "HotelName, Address/City, Address/StateProvince",
    "count": true,
    "top": 10,
    "filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}

Exemplos completos de sintaxe Lucene

A sintaxe padrão é simples, mas se você quiser pesquisa difusa, aumento de termos ou expressões regulares, especifique a sintaxe completa.

{
    "queryType": "full",
    "search": "seatle~",
    "select": "HotelId, HotelName,Address/City, Address/StateProvince",
    "count": true
}

Termos de consulta com erros ortográficos, como seatle em vez de Seattle, não retornam correspondências em uma pesquisa típica. O queryType=full parâmetro invoca o analisador de consulta Lucene completo, que suporta o operando til (~). Ao utilizar estes parâmetros, a consulta executa uma busca aproximada para a palavra-chave especificada e encontra termos semelhantes, mas não exatamente iguais.

Reserve um minuto para experimentar estas consultas de exemplo no seu índice. Para saber mais sobre consultas, consulte Consultando no Azure AI Search.

Clean up resources (Limpar recursos)

Quando você trabalha em sua própria assinatura, é uma boa ideia no final de um projeto identificar se você ainda precisa dos recursos que criou. Os recursos que deixar em execução podem custar dinheiro. Pode eliminar recursos individualmente ou eliminar o grupo de recursos para eliminar todo o conjunto de recursos.

No portal do Azure, você pode localizar e gerenciar recursos para seu serviço em Todos os recursos ou Grupos de recursos no painel esquerdo.

Nota

Se você estiver usando um serviço de pesquisa gratuito, lembre-se de que o limite é de três índices, três indexadores e três fontes de dados. Você pode excluir objetos individuais no portal do Azure para permanecer abaixo do limite.

Próximo passo

Experimente um assistente do portal do Azure para gerar um aplicativo Web pronto para uso que seja executado em um navegador. Use este assistente no pequeno índice que criou neste guia rápido ou utilize um dos conjuntos de dados de amostra integrados para uma experiência de pesquisa mais rica.