Tutorial: Criar uma página Web de Pesquisa Personalizada

  • Artigo

Aviso

A 30 de outubro de 2020, as APIs de Pesquisa do Bing passaram dos serviços de IA do Azure para os Serviços Pesquisa do Bing. Esta documentação é fornecida apenas para referência. Para obter documentação atualizada, veja a documentação da API de pesquisa do Bing. Para obter instruções sobre como criar novos recursos do Azure para a pesquisa do Bing, veja Criar um recurso de Pesquisa do Bing através do Azure Marketplace.

Saiba como a Pesquisa Personalizada do Bing lhe permite criar experiências de pesquisa personalizada dos tópicos que mais lhe interessam. Por exemplo, se tiver um site de artes marciais que fornece uma experiência de pesquisa, pode especificar os domínios, subsites e páginas Web que o Bing pesquisa. Os seus utilizadores veem resultados de pesquisa personalizados de acordo com os conteúdos que lhes interessam, em vez de terem de percorrer resultados de pesquisa gerais que podem apresentar conteúdos irrelevantes.

Este tutorial demonstra como configurar uma instância de pesquisa personalizada e integrá-la numa nova página Web.

As tarefas abrangidas são:

  • Criar uma instância de pesquisa personalizada
  • Adicionar entradas ativas
  • Adicionar entradas bloqueadas
  • Adicionar entradas afixadas
  • Integrar a pesquisa personalizada numa página Web

Pré-requisitos

Criar uma instância de pesquisa personalizada

Para criar uma instância de Pesquisa Personalizada do Bing:

  1. Abra um browser.

  2. Navegue para o portal da pesquisa personalizada.

  3. Inicie sessão no portal com uma conta Microsoft (MSA). Se não tiver um MSA, clique em Criar uma conta Microsoft. Se for a primeira vez que utiliza o portal, irá pedir permissões para aceder aos seus dados. Clique em Sim.

  4. Depois de iniciar sessão, clique em Nova pesquisa personalizada. Na janela Criar uma nova instância de pesquisa personalizada , introduza um nome relevante e descreva o tipo de conteúdo devolvido pela pesquisa. Pode alterar o nome em qualquer altura.

    Captura de ecrã da caixa Criar uma nova instância de pesquisa personalizada

  5. Clique em OK, especifique um URL e se quer incluir subpáginas do URL.

    Captura de ecrã da página de definições do URL

Adicionar entradas ativas

Para incluir os resultados de sites ou URLs específicos, adicione-os ao separador Ativo.

  1. Na página Configuração, clique no separador Ativo e introduza o URL de um ou mais sites que queira incluir na sua pesquisa.

    Captura de ecrã do separador Ativo do Editor de Definições

  2. Para confirmar que a sua instância devolve resultados, introduza uma consulta no painel de pré-visualização no lado direito. O Bing só devolve resultados para sites públicos que lhe estejam indexados.

Adicionar entradas bloqueadas

Para excluir os resultados de sites ou URLs específicos, adicione-os ao separador Bloqueado.

  1. Na página Configuração, clique no separador Bloqueado e introduza o URL de um ou mais sites que queira excluir da sua pesquisa.

    Captura de ecrã do separador Bloqueado do Editor de Definições

  2. Para confirmar que a sua instância não devolve resultados de sites bloqueados, introduza uma consulta no painel de pré-visualização no lado direito.

Adicionar entradas afixadas

Para afixar uma página Web específica na parte superior dos resultados da pesquisa, adicione a página Web e o termo de consulta ao separador Afixado . O separador Afixado contém uma lista de pares de termos de página Web e consulta que especificam a página Web que aparece como o resultado principal de uma consulta específica. A página Web só é afixada se a cadeia de consulta do utilizador corresponder à cadeia de consulta do pin com base na condição de correspondência do pin. Apenas as páginas Web indexadas serão apresentadas nas pesquisas. Para obter mais informações, consulte Definir a sua vista personalizada.

  1. Na página Configuração, clique no separador Afixado e introduza o termo de página Web e consulta da página Web a devolver como o melhor resultado.

  2. Por predefinição, a cadeia de consulta do utilizador tem de corresponder exatamente à cadeia de consulta afixada para o Bing devolver a página Web como o melhor resultado. Para alterar a condição de correspondência, clique no ícone de lápis, clique em Exato na coluna Condição de correspondência da consulta e selecione a condição de correspondência mais adequada para a sua aplicação.

    Captura de ecrã do separador Afixado do Editor de Definições

  3. Para confirmar que a sua instância devolve a página Web especificada como o melhor resultado, introduza o termo de consulta afixado no painel de pré-visualização no lado direito.

Configurar a IU Alojada

A Pesquisa Personalizada fornece uma IU alojada para compor a resposta JSON da sua instância de pesquisa personalizada. Para definir a experiência de IU:

  1. Clique no separador IU Alojada.

  2. Selecione um esquema.

    Captura de ecrã do passo de seleção de esquema da IU Alojada

  3. Selecione um tema de cores.

    Captura de ecrã da seleção do tema de cores da IU Alojada

    Se precisar de ajustar o tema de cores para uma melhor integração na sua aplicação Web, clique em Personalizar tema. Nem todas as configurações de cores se aplicam a todos os temas de esquema. Para alterar uma cor, introduza o valor HEX de RGB (por exemplo, #366eb8) na caixa de texto correspondente. Em alternativa, clique no botão de cor e, em seguida, clique no tom mais adequado para si. Pense sempre na acessibilidade quando selecionar cores.

    Captura de ecrã da personalização do tema de cores da IU Alojada

  4. Especifique opções de configuração adicionais.

    Captura de ecrã do passo de configurações adicionais da IU Alojada

    Para obter configurações avançadas, clique em Mostrar configurações avançadas. Isto permite adicionar configurações como Destino de ligação às opções de pesquisa Web, Ativar filtros às opções de Imagem e Vídeo, e Marcador de posição de texto da caixa de pesquisa a opções Diversas.

    Captura de ecrã do passo de configurações avançadas da IU Alojada

  5. Selecione as chaves de subscrição nas listas pendentes. Em alternativa, pode introduzir a chave de subscrição manualmente.

    Captura de ecrã da chave de subscrição da IU Alojada

Publicar ou reverter

As alterações efetuadas a uma instância de Pesquisa Personalizada são efetuadas no separador Configuração para que possa validar as alterações. Quando terminar de fazer alterações e estiver pronto para publicar, clique em Publicar. As alterações não são refletidas nos pontos finais de produção até publicar.

Antes de publicar, se decidir que não pretende manter as alterações efetuadas, clique em Reverter. Quando reverte as alterações, a configuração do estado em direto permanece inalterada e o separador Configuração é revertido para corresponder ao estado em direto.

Consumir a IU Alojada

Existem duas formas de consumir a IU alojada.

  • Opção 1: Integrar o fragmento de JavaScript fornecido na sua aplicação.
  • Opção 2: Utilizar o Ponto Final de HTML fornecido.

O resto deste tutorial ilustra a Opção 1: fragmento JavaScript.

Configurar a sua solução do Visual Studio

  1. Abra o Visual Studio no seu computador.

  2. No menu Ficheiro, selecione Novo, e, em seguida, escolha Projeto.

  3. Na janela Novo Projeto, selecione Aplicação Web Visual C#/Web/ASP.NET Core, dê um nome ao projeto e, em seguida, clique em OK.

    Captura de ecrã da janela Novo Projeto

  4. Na janela Nova Aplicação Web do ASP.NET Core, selecione Aplicação Web e clique em OK.

    Captura de ecrã da nova janela da aplicação Web

Editar o ficheiro index.cshtml

  1. No Explorador de Soluções, expanda Páginas e faça duplo clique em index.cshtml para abrir o ficheiro.

    Captura de ecrã do Explorador de Soluções com páginas expandidas e index.cshtml selecionado

  2. Em index.cshtml, elimine tudo a partir da linha 7 e abaixo.

    @page
@model IndexModel
@{
   ViewData["Title"] = "Home page";
}

  3. Adicione um elemento de quebra de linha e um div para atuar como contentor.

    @page
@model IndexModel
@{
   ViewData["Title"] = "Home page";
}
<br />
<div id="customSearch"></div>

  4. Na página IU Alojada, desloque-se para baixo até à secção Consumir a IU. Clique nos Pontos finais para aceder ao fragmento de JavaScript. Também pode obter o fragmento ao clicar em Produção e, em seguida, no separador IU Alojada.

  5. Cole o elemento script no contentor que adicionou.

    @page
@model IndexModel
@{
   ViewData["Title"] = "Home page";
}
<br />
<div id="customSearch">
   <script type="text/javascript" 
       id="bcs_js_snippet"
       src="https://ui.customsearch.ai /api/ux/rendering-js?customConfig=<YOUR-CUSTOM-CONFIG-ID>&market=en-US&safeSearch=Moderate&version=latest&q=">
   </script>
</div>

  6. No Explorador de Soluções, clique com o botão direito do rato em wwwroot e clique em Ver no Browser.

    Captura de ecrã do Explorador de Soluções a selecionar Ver no Browser no menu de contexto wwwroot

A nova página Web de pesquisa personalizada deve ser semelhante à seguinte:

Captura de ecrã de página Web de pesquisa personalizada

Efetuar uma pesquisa compõe resultados como os seguintes:

Captura de ecrã de resultados de pesquisa personalizada

Passos seguintes

Chamar o ponto final de Pesquisa Personalizada do Bing (C#)