Configurar os 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 UI.

• 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 para sites e dados não estruturados.

• Pesquise com uma resposta. Esse recurso fornece um parágrafo de informações (a resposta) sintetizado com base nos principais resultados do site ou dados não estruturados. É possível personalizar o número de resultados principais que servem de base para a resposta. Por padrão, os cinco melhores resultados são resumidos para criar a resposta. A pesquisa com uma resposta não pode ser combinada com a pesquisa com acompanhamentos.

• Pesquise com acompanhamentos. Esse recurso para sites e dados não estruturados permite 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 os botões thumb_up e thumb_down para que os usuários avaliem 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 contiverem metadados, você poderá configurar quais campos de metadados serão incluídos 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.

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

• 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 da pesquisa à medida que você digita 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 uma etapa com resumo)
• Pesquisar com acompanhamentos (pesquisa com várias interações)

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

• Para apps de pesquisa com dados não estruturados: Recursos avançados de LLM

• Para apps de pesquisa de sites: Recursos avançados do LLM e Indexação avançada de sites

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

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

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

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

4. Clique na guia UI.

5. Edite os campos na guia.

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

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

Configurar os 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 para dados de saúde:

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

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

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

4. Clique na guia UI.

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

   • Pesquisa: para realizar uma pesquisa de uma única etapa.
   • Pesquisar com uma resposta: para realizar uma pesquisa de uma única etapa 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 para o público em geral que aponta para o modelo Gemini 1.5 Flash 1, que é baseado no modelo gemini-1.5-flash-001.
   • Gemini 1.0 Pro 2: um modelo disponível em geral que é baseado no modelo gemini-1.0-pro-002.
   • Gemini 1.5 Flash 1: um modelo estável e disponível para todos que é baseado no modelo gemini-1.5-flash-001. Para mais informações, consulte Modelos disponíveis para todos os usuários (GA).
   • MedLM Medium: um modelo de visualização treinado com dados médicos com base no modelo MedLM. Para mais informações, consulte Modelo MedLM.

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

Configurar resultados da pesquisa para dados estruturados

Observação: este recurso é uma oferta de pré-lançamento, sujeita aos "Termos das Ofertas de pré-GA" dos Termos específicos de serviço do GCP. Os produtos e recursos pré-GA podem ter suporte limitado, e as mudanças neles podem não ser compatíveis com outras versões pré-GA. Para mais informações, consulte as descrições da fase de lançamento. Além disso, ao usar esse recurso, você concorda com os Termos e Condições da Prévia da IA generativa ("Termos de visualização"). Para esse recurso, é possível processar dados pessoais conforme descrito no Adendo sobre processamento de dados do Cloud, sujeito às restrições e obrigações aplicáveis no Contrato (conforme definido nos Termos de Pré-lançamento).

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

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

• Título. Um título de item em que o usuário pode clicar para selecioná-lo em um resultado da pesquisa.
• Miniatura. O URL de uma imagem que 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, você pode selecionar atributos para filtrar os resultados da pesquisa e definir nomes de exibição para eles. Para saber mais sobre como configurar facetas de widgets, consulte Configurar facetas para o widget de pesquisa.

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

1. No Console do Google Cloud, acesse a página Criador de agentes.

   Agent Builder.

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

3. Clique em Configurations.

4. Clique na guia UI.

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

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

7. No painel Preview, 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 no ícone de um dispositivo para conferir a visualização 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 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 Thumbnail e selecione um campo para mapear as imagens de miniatura nos resultados da pesquisa. Ou selecione Nenhum se você não quiser que imagens em miniatura apareçam nos resultados da pesquisa.

   3. Clique na caixa URL e selecione um campo que mapeia os itens que são abertos quando os usuários clicam nos títulos dos itens nos resultados da pesquisa. Ou selecione Nenhum se você 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 no campo Texto 1 e selecione um campo que você quer mostrar nos resultados da pesquisa. Por padrão, apenas o valor do campo é exibido nos resultados da pesquisa.

    2. Clique na seta ao lado da caixa Texto 1 para mostrar a caixa Modelo. O campo {value} na caixa Template representa o valor do campo que 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 Template para "Total Price: {value} USD", a mensagem "Total Price: 42 USD" vai aparecer nos resultados da pesquisa para esse item.

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

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

    1. Abra a seção Configurações de faceta.

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

    3. Para adicionar mais facetas, clique em Adicionar faceta.

12. Verifique o painel Visualização para garantir que as mudanças sejam exibidas corretamente.

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

Observação: para saber como ativar o preenchimento automático, consulte Configurar o preenchimento automático.
Para saber como ativar o feedback, consulte Configurar o feedback do widget.

Próximas etapas

• Receber resultados da pesquisa
• Adicionar o widget de pesquisa a uma página da Web