Configurar a sua experiência de IU alojada

Artigo
02/12/2019

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.

A Pesquisa Personalizada do Bing fornece uma IU alojada que pode facilmente integrar nas suas páginas Web e aplicações Web como um fragmento de código JavaScript. Com o portal de Pesquisa Personalizada do Bing, pode configurar as opções de esquema, cor e pesquisa da IU.

Configurar a IU alojada personalizada

Para configurar uma IU alojada para as suas aplicações Web, siga estes passos. À medida que efetua alterações, o painel à direita irá dar-lhe uma pré-visualização da sua IU. Os resultados de pesquisa apresentados não são resultados reais para a sua instância.

Inicie sessão no portal de Pesquisa Personalizada do Bing.
Selecione a sua instância de Pesquisa Personalizada do Bing.
Clique no separador IU Alojada.
Selecione um esquema.
- Barra de pesquisa e resultados (predefinição): apresenta uma caixa de pesquisa com resultados de pesquisa abaixo.
- Apenas resultados: apresenta apenas os resultados da pesquisa, sem uma caixa de pesquisa. Ao utilizar este esquema, tem de fornecer a consulta de pesquisa (&q=<query string>). Adicione o parâmetro de consulta ao URL do pedido no fragmento JavaScript ou na ligação do ponto final HTML.
- Pop-over: fornece uma caixa de pesquisa e apresenta os resultados da pesquisa numa sobreposição deslizante.
Selecione um tema de cores. Pode personalizar as cores para se ajustarem à sua aplicação ao clicar em Personalizar tema. Para alterar uma cor, introduza o valor HEX RGB da cor (por exemplo, #366eb8) ou clique na pré-visualização de cores.

Pode pré-visualizar as alterações no lado direito do portal. Clicar em Repor para predefinição reverterá as suas alterações para as cores predefinidas do tema selecionado.

Nota

Considere a acessibilidade ao escolher cores.
Em Configurações Adicionais, forneça valores conforme adequado para a sua aplicação. Estas definições são opcionais. Para ver o efeito da aplicação ou remoção dos mesmos, consulte o painel de pré-visualização à direita. As opções de configuração disponíveis são:
Introduza a chave de subscrição de pesquisa ou escolha uma na lista pendente. A lista pendente é preenchida com chaves das subscrições da sua conta do Azure. Veja Conta de API dos serviços de IA do Azure.
Se tiver ativado a sugestão automática, introduza a chave de subscrição de sugestão automática ou escolha uma na lista pendente. A lista pendente é preenchida com chaves das subscrições da sua conta do Azure. A Sugestão Automática Personalizada requer um escalão de subscrição específico. Veja os preços.

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 IU personalizada

Para consumir a IU alojada:

Incluir o script na sua página Web

<html>
    <body>
        <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>
    </body>    
</html>

Em alternativa, utilize o seguinte URL num browser.

https://ui.customsearch.ai/hosted?customConfig=YOUR-CUSTOM-CONFIG-ID
Nota

Adicione os seguintes parâmetros de consulta ao URL, conforme necessário. Para obter informações sobre estes parâmetros, veja Referência da API de Pesquisa Personalizada .
- q
- mkt
- pesquisa segura
- setlang
Importante

A página não consegue apresentar a sua declaração de privacidade ou outros avisos e termos. A adequação à sua utilização pode variar.

Para obter informações adicionais, incluindo o ID de Configuração Personalizada, aceda a Pontos finais no separador Produção .

Opções de configuração

Pode configurar o comportamento da IU alojada ao clicar em Configurações Adicionais e ao fornecer valores. Estas definições são opcionais. Para ver o efeito da aplicação ou remoção dos mesmos, consulte o painel de pré-visualização à direita.

Configurações de pesquisa na Web

Resultados da Web ativados: determina se a pesquisa na Web está ativada (verá um separador Web na parte superior da página)
Ativar sugestão automática: determina se a sugestão automática personalizada está ativada (veja preços para obter custos adicionais).
Resultados da Web por página: número de resultados de pesquisa na Web a apresentar de cada vez (o máximo é de 50 resultados por página).
Imagem legenda: determina se as imagens são apresentadas com os resultados da pesquisa.

As seguintes configurações são apresentadas se clicar em Mostrar configurações avançadas:

Realçar palavras: determina se os resultados são apresentados com termos de pesquisa a negrito.
Destino da ligação: determina se a página Web é aberta num novo separador do browser (Em branco) ou no mesmo separador do browser (autónomo) quando o utilizador clica num resultado de pesquisa.

Configurações de pesquisa de imagens

Resultados da imagem ativados: determina se a pesquisa de imagens está ativada (verá um separador Imagens na parte superior da página).
Resultados da imagem por página: número de resultados de pesquisa de imagens a apresentar de cada vez (o máximo é de 150 resultados por página).

A seguinte configuração é apresentada se clicar em Mostrar configurações avançadas.

Ativar filtros: adiciona filtros que o utilizador pode utilizar para filtrar as imagens devolvidas pelo Bing. Por exemplo, o utilizador pode filtrar os resultados apenas para GIFs animados.

Configurações de pesquisa de vídeo

Resultados do vídeo ativados: determina se a pesquisa de vídeo está ativada (verá um separador Vídeos na parte superior da página).
Resultados do vídeo por página: número de resultados de pesquisa de vídeo a apresentar de cada vez (o máximo é de 150 resultados por página).

A seguinte configuração é apresentada se clicar em Mostrar configurações avançadas.

Ativar filtros: adiciona filtros que o utilizador pode utilizar para filtrar os vídeos devolvidos pelo Bing. Por exemplo, o utilizador pode filtrar os resultados de vídeos com uma resolução específica ou vídeos detetados nas últimas 24 horas.

Configurações diversas

Título da página: texto apresentado na área de título da página de resultados da pesquisa (não para esquema pop-over).
Tema da barra de ferramentas: determina a cor de fundo da área de título da página de resultados da pesquisa.

As seguintes configurações são apresentadas se clicar em Mostrar configurações avançadas.

Coluna1	Coluna2
Marcador de posição de texto da caixa de pesquisa	Texto apresentado na caixa de pesquisa antes da entrada.
URL da ligação do título	Destino da ligação de título.
URL do logótipo	Imagem apresentada junto ao título.
Favicon	Ícone apresentado na barra de título do browser.

As seguintes configurações aplicam-se apenas se consumir a IU Alojada através do ponto final HTML (não se aplicam se utilizar o fragmento JavaScript).

Título da página
Tema da barra de ferramentas
URL da ligação de título
URL do logótipo
Faviicon URL

Partilhar via