Receber resultados de navegação personalizados

A navegação usa métodos de navegação para mostrar resultados de pesquisa que correspondem às categorias ou filtros selecionados pelo usuário final. A navegação retorna resultados que podem ser personalizados. Esta página descreve como receber resultados de navegação para armazenamentos de dados de pesquisa genéricos.

Sobre a navegação

Em um app de pesquisa de aplicativos de IA, navegar é pesquisar sem uma consulta ou com uma consulta vazia. Se você tiver um repositório de dados de pesquisa genérica que contenha dados estruturados, dados não estruturados com metadados ou dados de sites, poderá enviar uma consulta de pesquisa vazia para receber resultados de navegação.

Quando você envia uma solicitação de navegação, os documentos no seu repositório de dados que correspondem aos filtros são retornados de acordo com os indicadores baseados em eventos. Você pode oferecer uma experiência de navegação aprimorada fazendo o seguinte:

  • Use filtros na sua solicitação de pesquisa para restringir os resultados. Se você usa a indexação avançada de sites, consulte Usar dados estruturados para indexação avançada de sites e saiba como adicionar metadados ao seu esquema e usá-los para enriquecer os campos de filtro e aumentar.
  • Adicione uma especificação de reforço para influenciar a ordem dos resultados retornados, reforçando ou ocultando resultados específicos.
  • Entenda e registre eventos do usuário. O Google usa seus eventos de usuário para otimizar a classificação dos resultados de acordo com a taxa de cliques.

A tabela a seguir apresenta as diferenças entre pesquisa e navegação.

Recurso Pesquisar Procurar
Finalidade Encontrar informações específicas Explorar e descobrir conteúdo
Exemplo Pesquisando "melhores restaurantes coreanos em Vancouver" na Pesquisa Google Procurar um restaurante com base nas categorias a que ele pode pertencer, como "Restaurantes > Coreano > Vancouver > 4 estrelas e acima"
User Intent Normalmente orientada a metas Exploratória
Ponto de partida Uma consulta ou palavra-chave geralmente em uma barra de pesquisa Um site ou plataforma específica que geralmente usa um menu, rastros de navegação, links ou outros métodos de navegação, como refinamentos
Método Inserir palavras-chave ou frases e aplicar a configuração de pesquisa e veiculação Pesquisar com uma consulta vazia, aplicando a configuração de pesquisa e veiculação
Resultados Uma lista de resultados relevantes Todos os documentos no repositório de dados que correspondem aos filtros

Receber resultados de navegação para um app com dados do site

Para usar a API e receber resultados de navegação de um app com dados de sites,

  1. Encontre o ID do app. Se você já tiver o ID do app, pule para a próxima etapa.

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

      Acessar "Apps".

    2. Na página Apps, encontre o nome do app e confira o ID dele na coluna ID.

  2. Chame o método engines.servingConfigs.search com uma consulta vazia ou sem consulta da seguinte maneira:

    REST

    curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \
-d '{
"servingConfig": "projects/PROJECT_ID/locations/global/collections/default_collection/engines/APP_ID/servingConfigs/default_search",
"orderBy": "ORDER_BY",
"params": {
     "searchType": "0"
 },
"filter": "FILTER",
"boostSpec": "BOOST_SPEC",
}'

    Substitua:

    • PROJECT_ID: o ID do seu Google Cloud projeto.
    • APP_ID: o ID do app da Vertex AI para Pesquisa que você quer consultar.
    • ORDER_BY: opcional. A ordem em que os resultados são organizados. O atributo usado para classificação precisa ter uma interpretação numérica, por exemplo, date. Para mais informações, consulte Ordenar resultados da pesquisa na Web.
    • FILTER: opcional, mas recomendado. Um campo de texto para filtrar sua pesquisa usando uma expressão de filtro. O valor padrão é uma string vazia. Para mais informações sobre como usar o campo filter, consulte Filtrar a pesquisa genérica por dados estruturados ou não estruturados e Filtrar a pesquisa de sites.
    • BOOST_SPEC: opcional. Uma especificação para aumentar ou ocultar documentos. Valores:
      • BOOST: um número de ponto flutuante no intervalo [-1,1]. Quando o valor é negativo, os resultados são rebaixados (aparecem mais abaixo nos resultados). Quando o valor é positivo, os resultados são promovidos (aparecem mais acima nos resultados).
      • CONDITION: uma expressão de filtro de texto para selecionar os documentos a que o aumento é aplicado. O filtro precisa ser avaliado como um valor booleano. Para saber mais sobre o aumento da pesquisa estruturada, consulte Aumentar os resultados da pesquisa.

    Você vai receber uma resposta JSON semelhante a esta, que está truncada. A resposta contém resultados de pesquisa detalhados listados na ordem determinada pelos campos definidos na solicitação de pesquisa.