Configurar resultados para a UI

Esta página descreve como configurar resultados para a interface do app da web, que é a interface que seus usuários usam para acessar o app.

Conceitos do widget da Pesquisa

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

  • Snippet. Uma pequena seção de texto, geralmente uma frase, abaixo do 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 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 o feedback.

  • 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 nomes de exibição de atributos. Para mais informações, consulte Configurar atributos para a interface.

  • Nome de exibição configurado pelo admin para as fontes. Mostra o nome de exibição configurado pelo administrador para fontes de dados no app da Web em vez do tipo de conector. Para mais informações, consulte Mostrar nomes de exibição configurados pelo administrador para fontes de dados.

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

A interface 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 de várias interações)

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

  1. No Google Cloud console, acesse a página Gemini Enterprise.

    Gemini Enterprise

  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 para dados estruturados

Para dados estruturados, por padrão, a interface mostra todos os pares de nome-valor de cada item nos resultados da pesquisa. Use a página Configurações no console Google Cloud para personalizar como a interface 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, consulte Configurar atributos para a interface.

Para configurar como a interface mostra os resultados da pesquisa de dados estruturados:

  1. No Google Cloud console, acesse a página Gemini Enterprise.

    Gemini Enterprise

  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 repositórios de dados conectados ao app, selecione o repositório 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. Selecione um campo para definir como um atributo e insira um nome de exibição.

    3. 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.

Mostrar nomes de exibição configurados pelo administrador para fontes de dados

Por padrão, o app da Web mostra o tipo de conector como o rótulo para fontes de dados de instância única. Você pode ativar a configuração Usar o nome de exibição configurado pelo admin para as fontes para que o app da Web mostre o nome de exibição personalizado que você configurou para cada fonte de dados.

Para ativar ou desativar os nomes de exibição configurados pelo administrador para fontes de dados:

Console

  1. No Google Cloud console, acesse a página Gemini Enterprise.

    Acessar o Gemini Enterprise

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

  5. Na seção Configurações gerais, ative ou desative a opção Usar o nome de exibição configurado pelo admin para as fontes.

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

REST

Atualize o campo uiSettings.sourceAdminDisplayNameEnabled no recurso WidgetConfig do app chamando o engines.widgetConfigs.patch método:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/collections/default_collection/engines/APP_ID/widgetConfigs/default_search_widget_config?updateMask=uiSettings.sourceAdminDisplayNameEnabled" \
  -d '{
    "uiSettings": {
      "sourceAdminDisplayNameEnabled": SOURCE_ADMIN_DISPLAY_NAME_ENABLED
    }
  }'

Substitua:

  • ENDPOINT_LOCATION: a multirregião da sua solicitação de API. Especifique um dos seguintes valores:
    • us para a multirregião dos EUA
    • eu para a multirregião da UE
    • global para o local global
    Para mais informações, consulte Especificar uma multirregião para seu repositório de dados.
  • PROJECT_ID: o número ou ID do Google Cloud projeto.
  • LOCATION_ID: a localização geográfica do seu repositório de dados, como global. Para mais informações, consulte Locais.
  • APP_ID: o ID do app.
  • SOURCE_ADMIN_DISPLAY_NAME_ENABLED: um valor booleano Especifique true para mostrar o nome de exibição configurado pelo administrador para fontes de dados ou false para mostrar o tipo de conector.

Próximas etapas