Configurar os resultados para o widget de pesquisa

Nesta seção, descrevemos como configurar os resultados para o widget de pesquisa, dependendo do tipo de app de pesquisa que você tem.

Se você usa controle de acesso de terceiros para suas fontes de dados, essas configurações também se aplicam ao app da Web.

Conceitos do widget da Pesquisa

Confira alguns conceitos para entender como usar os controles na guia Interface.

  • Snippet: uma seção curta de texto, geralmente uma frase, no título do documento. Por padrão, um snippet é exibido para cada resultado da pesquisa de site e dados não estruturados.

  • Pesquisar com uma resposta: esse recurso fornece um parágrafo de informações (a resposta) sintetizado dos principais resultados de sites ou dados não estruturados. É possível personalizar o número de principais resultados em que a resposta se baseia. Por padrão, os cinco principais resultados são resumidos para criar a resposta. A pesquisa com uma resposta não pode ser combinada com a pesquisa com acompanhamentos.

  • Pesquisar com acompanhamentos: esse recurso para sites e dados não estruturados permite fazer perguntas de acompanhamento que mantêm o contexto da consulta de pesquisa inicial.

  • Preenchimento automático: sugere consultas de pesquisa com base nas primeiras letras que os usuários digitam na barra de pesquisa. Para mais informações, consulte Configurar o preenchimento automático.

  • Feedback: fornece botões thumb_up e thumb_down para que os usuários possam avaliar a qualidade dos resultados da pesquisa. Essas informações são enviadas apenas ao Google. Para mais informações, consulte Configurar feedback do widget.

  • Metadados: se os dados forem estruturados ou tiverem metadados, você poderá configurar quais campos de metadados incluir nos resultados da pesquisa. Também é possível mapear campos para mostrar nomes de atributos. Para mais informações, consulte Configurar facetas para o widget de pesquisa.

  • Selecione um LLM: a versão estável do LLM é escolhida por padrão para seu aplicativo. Para mudar a versão do LLM, consulte O resumo da pesquisa varia de acordo com o modelo.

  • Desativar os recursos avançados do LLM: se você desativar os recursos avançados do LLM em um widget de pesquisa que usa a pesquisa com perguntas complementares ou com uma resposta, o widget vai parar de funcionar para todos os usuários. Saiba como ativar ou desativar os recursos avançados de LLM.

  • Imagem nas respostas: esse recurso retorna os seguintes tipos de imagens com as respostas:

    • Gráficos gerados com base nas informações da resposta
    • Imagens selecionadas de um repositório de dados não estruturados analisado por um analisador de layout

    Use esse recurso com a Pesquisa com uma resposta ou a Pesquisa com acompanhamentos e o modelo de linguagem grande estável ou qualquer modelo do Gemini 2.0 ou mais recente. Para retornar imagens do corpus na resposta, ative os snippets ou o conteúdo extrativo. Para mais informações, consulte Gerar gráficos para respostas e Recuperar imagens existentes do repositório de dados.

  • Search-as-you-type: disponível apenas para apps de mídia. Esse recurso faz uma pesquisa após cada pressionamento de tecla. Não é necessário pressionar Enter para receber um resultado da pesquisa. Para mais informações, consulte Receber resultados de pesquisa instantânea para um app de mídia.

Configurar resultados da pesquisa para dados não estruturados ou de sites

O widget de pesquisa para dados não estruturados e de sites oferece as seguintes personalizações de pesquisa:

  • Pesquisa (interação única)
  • Pesquisar com uma resposta (pesquisa de interação única com geração de resumos)
  • Pesquisar com acompanhamentos (pesquisa com várias interações)

Para a pesquisa com uma resposta e a pesquisa com perguntas complementares, é necessário ativar algumas configurações avançadas:

Para configurar como o widget mostra os resultados da pesquisa de dados não estruturados:

  1. No console Google Cloud , acesse a página Aplicativos de IA.

    Aplicativos de IA

  2. Clique no nome do app que você quer editar.

  3. No menu de navegação, clique em Configurações.

  4. Clique na guia Interface.

  5. Edite os campos na guia.

  6. Use o painel Visualizar para garantir que as mudanças sejam exibidas como esperado.

  7. Clique em Salvar e publicar para aplicar as mudanças.

Configurar resultados da pesquisa para dados de saúde

O widget de pesquisa para dados de saúde oferece as seguintes personalizações de pesquisa:

  • Pesquisar
  • Pesquisar com uma resposta

Para a pesquisa com uma resposta, ative os recursos avançados do LLM.

Para configurar como o widget mostra os resultados da pesquisa de dados de saúde:

  1. No console Google Cloud , acesse a página Aplicativos de IA.

    Aplicativos de IA

  2. Clique no nome do app que você quer editar.

  3. No menu de navegação, clique em Configurações.

  4. Clique na guia Interface.

  5. Na lista "Tipo de pesquisa", selecione uma das seguintes opções:

    • Pesquisar: para fazer uma pesquisa de uma só vez
    • Pesquisar com uma resposta: para fazer uma pesquisa única com uma resposta gerada por IA generativa
  6. Na seção Modelos de linguagem grande para resumo, selecione uma das seguintes opções:

    • Estável: um modelo estável e disponível de forma geral que aponta para o modelo Gemini 2.0 Flash 1, que é baseado no modelo gemini-2.0-flash-001.
    • Gemini 1.5 Flash 1: um modelo estável e disponível para o público em geral que se baseia no modelo gemini-1.5-flash-001. Para mais informações, consulte Modelos disponíveis para todos os usuários (GA).
    • Gemini 2.0 Flash 1: um modelo estável e disponível de forma geral que se baseia no modelo gemini-2.0-flash-001. Para mais informações, consulte Modelos disponíveis para todos os usuários (GA).
  7. Clique em Salvar e publicar para aplicar as mudanças.

Configurar resultados da pesquisa para dados estruturados

Para dados estruturados, por padrão, o widget mostra todos os pares nome-valor de cada item nos resultados da pesquisa. Use a página Configurações no console do Google Cloud para personalizar como o widget mostra os resultados da pesquisa.

A lista a seguir mostra os principais campos para exibir resultados da pesquisa:

  • Título. Um título de item em que um usuário pode clicar para selecionar o item em um resultado da pesquisa.
  • Miniatura. O URL de uma imagem a ser mostrada ao lado do título do item em um resultado da pesquisa.
  • URL. Um URL para onde o usuário é direcionado quando clica no título do item.

Você pode mostrar até três campos adicionais nos resultados da pesquisa e configurar como eles aparecem.

Além disso, é possível selecionar atributos para filtrar os resultados da pesquisa e definir nomes de exibição para eles. Para mais informações sobre como configurar facetas de widget, consulte Configurar facetas para o widget de pesquisa.

Para configurar como o widget mostra os resultados da pesquisa de dados estruturados:

  1. No console Google Cloud , acesse a página Aplicativos de IA.

    Aplicativos de IA

  2. Clique no nome do app de pesquisa que você quer editar.

  3. Clique em Configurations.

  4. Clique na guia Interface.

  5. Se você tiver vários repositórios de dados conectados ao app, selecione aquele para configurar os resultados.

  6. Expanda a seção Configurar campos nos resultados.

  7. No painel Visualização, digite uma consulta e pressione Enter para ver como os resultados da pesquisa são exibidos com suas configurações atuais. A prévia é atualizada automaticamente quando você insere novas configurações.

  8. Opcional: clique em um ícone de dispositivo para ver a prévia no formato para computador ou dispositivo móvel.

  9. Para configurar os campos principais (Título, Miniatura e URL) nos resultados da pesquisa:

    1. Clique na caixa Título e selecione um campo para mapear com os títulos dos resultados da pesquisa. Ou selecione Nenhum se não quiser que os títulos apareçam nos resultados da pesquisa.

    2. Clique na caixa Miniatura e selecione um campo para mapear com as imagens em miniatura nos resultados da pesquisa. Ou selecione Nenhum se não quiser que as imagens em miniatura apareçam nos resultados da pesquisa.

    3. Clique na caixa URL e selecione um campo que mapeie os itens abertos quando os usuários clicam nos títulos nos resultados da pesquisa. Ou selecione Nenhum se não quiser que os títulos dos itens nos resultados da pesquisa sejam vinculados a itens.

  10. Para adicionar outros campos aos resultados da pesquisa:

    1. Clique na caixa Texto 1 e selecione um campo que você quer mostrar nos resultados da pesquisa. Por padrão, apenas o valor do campo é mostrado nos resultados da pesquisa.

    2. Clique na seta ao lado da caixa Texto 1 para mostrar a caixa Modelo. O campo {value} na caixa Modelo representa o valor do campo a ser mostrado no resultado da pesquisa. Adicione texto antes ou depois do campo {value} (ou ambos) para dar contexto ao valor nos resultados da pesquisa. Por exemplo, suponha que você tenha selecionado price na caixa Texto 1 e que o valor do preço de um item específico seja 42. Se você atualizar o campo Modelo para "Total Price: {value} USD", o preço total de US$ 42 será exibido nos resultados da pesquisa desse item.

    3. Para adicionar mais campos, repita essas etapas para as caixas Texto 2 e Texto 3.

  11. Para configurar as opções de refinamento:

    1. Expanda a seção Configurações de refinamento.

    2. Selecione um campo para definir como um atributo e insira um nome de exibição.

    3. Para adicionar mais refinamentos, clique em Adicionar refinamento.

  12. Verifique o painel Visualização para garantir que as mudanças apareçam corretamente.

  13. Clique em Salvar e publicar para aplicar as mudanças.

Próximas etapas