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 de pesquisa

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

• Snippet. Uma pequena seção de texto, normalmente uma frase, abaixo do o 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 de sites ou dados não estruturados. Você pode personalizar o número de resultados principais em que a resposta é baseada. 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 dados não estruturados e de site permite perguntas de follow-up 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 os 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 somente ao Google. Para mais informações, consulte Configurar o feedback do widget.

• Metadados. Se os dados forem estruturados ou tiverem metadados, você pode 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 Configure atributos para o widget de pesquisa.

• Desativar os recursos avançados do LLM. Se você desativar o modo avançado recursos LLM para um widget de pesquisa que está usando a pesquisa com acompanhamentos ou pesquisa com uma resposta, o widget para de funcionar para todos usuários. Consulte Ative ou desative os recursos avançados do LLM.

• Pesquisar enquanto você digita. Disponível apenas para apps de música. Esse recurso realiza uma pesquisa após cada pressionamento de tecla. Não é preciso 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)
• Pesquisa com acompanhamentos (pesquisa em vários turnos)

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: LLM avançado recursos

• Para apps de pesquisa em 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 IU.

5. Edite os campos na guia.

6. Use o painel Visualização para garantir que suas 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 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:

   • Pesquisar: para realizar uma pesquisa de uma única etapa.
   • Pesquisa com uma resposta: para realizar uma pesquisa em turno único com uma resposta gerada por IA generativa.

6. Na seção Modelos de linguagem grande para resumo, selecione uma das seguintes opções:

   • Stable: um modelo estável com disponibilidade geral que aponta para o modelo Gemini 1.5 Flash 1, que é baseado na 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 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).
   • 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 da prévia"). 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 e valor de cada item nos resultados da pesquisa. É possível usar as Configurações no console do Google Cloud para personalizar como o widget mostra as pesquisas resultados.

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 a ser exibida ao lado do título do item em uma resultado da pesquisa.
• URL. Um URL para o qual 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 a exibição e dar um nome a eles. Para mais informações sobre a configuração de atributos de widgets, consulte Configurar atributos de widgets para o widget de pesquisa.

Para configurar como o widget exibe 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 seu app, selecione os dados para configurar os resultados.

6. Expanda 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 prévia atualiza 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 Miniatura e selecione um campo para mapear a miniatura. imagens nos resultados da pesquisa. Ou selecione Nenhum se você não quiser imagens em miniatura que 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 não quiser que os títulos dos itens em seus resultados de pesquisa sejam vinculados itens.

10. Para adicionar mais 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, somente o valor do campo é exibido no 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ê selecionou price no Texto 1 e o valor do preço de um determinado item é 42. Se você atualizar o campo Modelo para "Total Price: {value} USD", a mensagem "Preço total: 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 do atributo:

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

    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 informações sobre como ativar o feedback, consulte Configurar widget feedback.

Próximas etapas

• Conferir os resultados da pesquisa
• Adicionar o widget da Pesquisa a uma página da Web