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

Neste início rápido para o Azure AI Search, saiba como usar o assistente Criar aplicativo de demonstração do 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

Antes de começar, tenha os seguintes pré-requisitos em vigor:

• Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.

• Um serviço Azure AI Search. Crie um serviço ou encontre um serviço existente na sua subscrição atual. Você pode usar um serviço gratuito para este início rápido.

• Microsoft Edge (versão mais recente) ou Google Chrome.

• Um índice de pesquisa para usar como base do seu aplicativo gerado.

  Este guia de início rápido usa o conjunto de dados de exemplo de hotéis integrado. Para criar o índice usado neste exercício, execute o assistente Importar dados, escolhendo a fonte de amostra de hotéis e aceitando todos os padrões.

  

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 Índices de Gerenciamento de>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.

   

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. Ignorar miniatura porque esse índice não tem imagens, mas se você tiver um campo de índice preenchido com URLs resolvendo imagens disponíveis publicamente, especifique 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.

   

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.

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.

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.

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óximos passos

O aplicativo de demonstração é útil para prototipagem porque você pode simular uma experiência do usuário final sem ter que escrever JavaScript ou código front-end, mas à medida que se aproxima da prova de conceito em seu próprio projeto, revise um dos exemplos de código de ponta a ponta que está mais próximo de um aplicativo de palavra real: