Partilhar via

Guia de início rápido: criar um aplicativo de pesquisa de demonstração no portal do Azure

Neste início rápido, você usa o assistente Criar aplicativo de demonstração no portal do Azure para gerar um aplicativo Web baixável no estilo "localhost" que é executado em um navegador. Dependendo de como você o configurar, o aplicativo gerado estará operacional no primeiro uso, com uma conexão somente leitura ao vivo para um índice em seu serviço de pesquisa. Um aplicativo padrão pode incluir uma barra de pesquisa, área de resultados, filtros da barra lateral e suporte a digitação.

Um aplicativo de demonstração pode ajudá-lo a visualizar como um índice funcionará em um aplicativo cliente, mas não se destina a cenários de produção. Os aplicativos de produção devem incluir segurança, tratamento de erros e lógica de hospedagem que o aplicativo de demonstração não fornece.

Pré-requisitos

Quando o índice estiver pronto para uso, passe para a próxima etapa.

Iniciar o assistente

  1. Entre no portal do Azure com sua conta do Azure e encontre seu serviço de pesquisa.

  2. Em >Pesquisa

  3. Selecione hotels-sample-index.

  4. Na página de índice, na parte superior, selecione Criar aplicativo de demonstração para iniciar o assistente.

  5. Na primeira página do assistente, selecione Ativar compartilhamento de recursos entre origens (CORS) para adicionar suporte a CORS à sua definição de índice. Esta etapa é opcional, mas seu aplicativo Web local não se conectará ao índice remoto sem ele.

    Captura de tela da ação ativar CORS.

Configurar resultados da pesquisa

O assistente fornece um layout básico para resultados de pesquisa renderizados que inclui espaço para uma imagem em miniatura, um título e uma descrição. Apoiar cada um desses elementos é um campo no seu índice que fornece os dados.

  1. Saltar miniatura porque este índice não tem imagens, mas se tiveres um campo de índice preenchido com URLs que conduzam a imagens disponíveis publicamente, deves especificar esse campo para a área de miniatura. Se o seu índice não tiver URLs de imagem, deixe este campo em branco.

  2. Em Título, escolha um campo que transmita a singularidade de cada documento. Neste exemplo, o Nome do Hotel é uma seleção razoável.

  3. Em Descrição, escolha um campo que forneça detalhes que possam ajudar alguém a decidir se deseja detalhar esse documento específico. Neste exemplo, a Descrição é um bom candidato.

    Captura de ecrã da página de configuração dos resultados da pesquisa.

Adicionar uma barra lateral

O serviço de pesquisa suporta navegação facetada, que muitas vezes é renderizada como uma barra lateral. As facetas são baseadas em campos filtráveis e facetable, conforme expresso no esquema de índice.

No Azure AI Search, a navegação facetada é uma experiência de filtragem cumulativa. Dentro de uma categoria, selecionar vários filtros expande os resultados (por exemplo, selecionar Seattle e Bellevue dentro da cidade). Em todas as categorias, a seleção de vários filtros reduz os resultados.

Gorjeta

Você pode exibir atributos de campos na guia Campos do índice no portal do Azure. Os campos marcados como filtráveis e faceiros podem ser usados na barra lateral

  1. No assistente, selecione a guia Barra lateral na parte superior da página. Você verá uma lista de todos os campos atribuídos como filtráveis e faceiros no índice.

  2. Remova alguns dos campos para encurtar a barra lateral para que você não tenha rolagem no aplicativo concluído.

Adicionar sugestões

As sugestões referem-se a prompts de consulta automatizados anexados à caixa de pesquisa. O aplicativo de demonstração suporta sugestões que fornecem uma lista suspensa de possíveis documentos correspondentes com base em entradas parciais de texto.

Nesta página, selecione os campos para os quais as consultas sugeridas são fornecidas. Você deve escolher campos de cadeia de caracteres mais curtos. Evite campos detalhados, como descrições.

A captura de tela a seguir mostra a página de sugestões, justaposta a uma página renderizada no aplicativo. Você pode ver como as seleções de campo são usadas e como "Mostrar nome do campo" é usado para incluir ou excluir rótulos na sugestão.

Captura de ecrã da página de configuração de sugestões.

Criar, baixar e executar

  1. Selecione Criar aplicativo de demonstração na parte inferior da página para gerar o arquivo HTML.

  2. Quando solicitado, selecione Baixar seu aplicativo para baixar o arquivo.

  3. Abra o arquivo e selecione o botão Pesquisar . Essa ação executa uma consulta, que pode ser uma consulta vazia (*) que retorna um conjunto de resultados arbitrário. A página deve ser semelhante à captura de tela a seguir.

  4. Insira um termo e use filtros para restringir os resultados. Se não vir as consultas sugeridas, verifique as definições do navegador ou experimente um navegador diferente.

Captura de ecrã da aplicação de pesquisa numa janela do browser.

Clean up resources (Limpar recursos)

Ao trabalhar na sua própria subscrição, recomendamos que verifique, depois de concluir um projeto, se ainda vai precisar 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.

Você pode localizar e gerenciar recursos no portal do Azure, usando o link Todos os recursos ou Grupos de recursos no painel de navegação esquerdo.

Lembre-se de que um serviço gratuito é limitado a três índices, indexadores e fontes de dados. Você pode excluir itens individuais no portal do Azure para permanecer abaixo do limite.

Próximo passo

O aplicativo de demonstração é útil para prototipagem porque você pode simular uma experiência do usuário final sem escrever nenhum JavaScript ou código front-end. À medida que se aproxima da prova de conceito no seu próprio projeto, reveja os exemplos de código completo que imitam mais de perto uma aplicação do mundo real.

Adicionar pesquisa a aplicações Web