Configurar resultados para o widget de pesquisa

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

Se você usa o 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 é mostrado para cada resultado da pesquisa de sites 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 perguntas de acompanhamento que mantêm o contexto da pesquisa inicial consulta.

  • 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 o 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 atributos para o widget de pesquisa.

  • Selecionar 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 respostas generativas: se você desativar as respostas generativas de um widget de pesquisa, o recurso avançado de LLM, como a pesquisa com acompanhamentos e a pesquisa com uma resposta, vai parar de funcionar para todos os usuários do projeto. Consulte Ativar ou desativar respostas generativas.

  • 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 que um analisador de layout analisa

    Use esse recurso com Pesquisar com uma resposta ou Pesquisar 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 snippets ou conteúdo extrativo. Para mais informações, consulte Gerar gráficos para respostas e Recuperar imagens atuais do armazenamento de dados de dados.

  • Search-as-you-type: disponível apenas para apps de mídia. Esse recurso realiza 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 de dados não estruturados ou de sites

O widget de pesquisa de 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 resumo)
  • Pesquisar com acompanhamentos (pesquisa com várias interações)

Para pesquisar com uma resposta e pesquisar com acompanhamentos, é 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 Google Cloud console, 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 Visualização para garantir que as mudanças sejam mostradas conforme o esperado.

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

Configurar resultados da pesquisa de dados de saúde

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

  • Pesquisa
  • Pesquisar com uma resposta

Para pesquisar com uma resposta, ative a opção Respostas generativas.

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

  1. No Google Cloud console, 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:

    • Pesquisa: para fazer uma pesquisa de interação única
    • Pesquisar com uma resposta: para fazer uma pesquisa de interação única com uma resposta gerada por IA generativa
  6. Se você selecionou Pesquisar com uma resposta, na seção Modelos de linguagem grandes para resumo, selecione um dos modelos compatíveis com a área da saúde. Consulte Modelos em disponibilidade geral (GA).

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

Configurar resultados da pesquisa de dados estruturados

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

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

  • Título. Um título de item em que um usuário pode clicar para selecionar esse 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.

É possível 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 atributos de widget, consulte Configurar atributos para o widget de pesquisa.

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

  1. No Google Cloud console, 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 Configurações.

  4. Clique na guia interface.

  5. Se você tiver vários armazenamentos de dados conectados ao app, selecione o armazenamento de dados 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 conferir como os resultados da pesquisa são mostrados com as configurações atuais. A visualização é atualizada automaticamente quando você insere novas configurações.

  8. Opcional: clique em um ícone de dispositivo para conferir a visualização no formato para computador ou dispositivos móveis.

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

    1. Clique na caixa Título e selecione um campo para associar aos 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 associar às 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 seja mapeado para os itens que são abertos quando os usuários clicam nos títulos dos itens 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 o valor do preço de um item específico seja 42. Se você atualizar o campo Modelo para "Total Price: {value} USD", "Total Price: 42 USD" será mostrado nos resultados da pesquisa desse item.

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

  11. Para definir as configurações de atributo:

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

    2. Clique em Adicionar atributo.

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

    4. Para adicionar mais atributos, clique em Adicionar atributo.

  12. Confira o painel Visualização para garantir que as mudanças sejam mostradas corretamente.

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

Próximas etapas