Receba resultados de navegação personalizados

A navegação usa métodos de navegação para apresentar resultados da pesquisa que correspondem às categorias ou aos filtros selecionados pelo utilizador final. A navegação devolve resultados que podem ser personalizados. Esta página descreve como obter resultados de navegação para arquivos de dados de pesquisa genéricos.

Acerca da navegação

Numa app de pesquisa de aplicações de IA, procurar significa pesquisar sem uma consulta ou com uma consulta vazia. Se tiver um arquivo de dados de pesquisa genérico que contenha dados estruturados, dados não estruturados com metadados ou dados de Websites, pode enviar uma consulta de pesquisa vazia para receber resultados de navegação.

Quando envia um pedido de navegação, os documentos na sua base de dados que correspondem aos filtros são devolvidos de acordo com os sinais baseados em eventos. Pode oferecer uma experiência de navegação melhorada fazendo o seguinte:

  • Use filtros no seu pedido de pesquisa para restringir os resultados da pesquisa. Se usar a indexação avançada de Websites, consulte o artigo Use dados estruturados para a indexação avançada de Websites para compreender como adicionar metadados ao seu esquema e usá-los para enriquecer os campos de filtro e de reforço.
  • Adicione uma especificação de otimização para influenciar a ordem dos resultados devolvidos através da otimização ou da ocultação de resultados específicos.
  • Compreenda os eventos do utilizador e registe-os. A Google usa os seus eventos de utilizador para otimizar a classificação dos resultados em função da taxa de cliques.

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

Funcionalidade Pesquisar Procurar
Finalidade Encontre informações específicas Explore e descubra conteúdo
Exemplo Pesquisar "melhores restaurantes coreanos em Vancouver" na Pesquisa Google Procurar um restaurante com base nas categorias a que pode pertencer, como "Restaurantes > Coreanos > Vancouver > 4 estrelas e superior"
User Intent Normalmente, orientado para objetivos Exploratório
Ponto de partida Uma consulta ou uma palavra-chave normalmente numa barra de pesquisa Um Website ou uma plataforma específica que usa normalmente um menu, links de navegação, links ou outros métodos de navegação, como facetas
Método Introduzir palavras-chave ou expressões e aplicar a configuração de pesquisa e publicação Pesquisar com uma consulta vazia, aplicar a configuração de pesquisa e publicação
Resultados Uma lista de resultados relevantes Todos os documentos no arquivo de dados que correspondem aos filtros

Obtenha resultados de navegação para uma app com dados do Website

Para usar a API para obter resultados de navegação de uma app com dados de Websites:

  1. Encontre o ID da app. Se já tiver o ID da app, avance para o passo seguinte.

    1. Na Google Cloud consola, aceda à página Aplicações de IA.

      Aceda a Apps

    2. Na página Apps, encontre o nome da sua app e obtenha o ID da app na coluna ID.

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

    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 o seguinte:

    • PROJECT_ID: o ID do seu projeto Google Cloud .
    • APP_ID: o ID da app Vertex AI Search que quer consultar.
    • ORDER_BY: opcional. A ordem pela qual os resultados são organizados. O atributo para o qual ordenar tem de ter uma interpretação numérica, por exemplo, date. Para mais informações, consulte o artigo Ordene os resultados da pesquisa na Web.
    • FILTER: opcional, mas recomendado. Um campo de texto para filtrar a pesquisa através de uma expressão de filtro. O valor predefinido é uma string vazia. Para mais informações sobre a utilização do campo filter, consulte os artigos Filtre a pesquisa genérica de dados estruturados ou não estruturados e Filtre a pesquisa de Websites.
    • BOOST_SPEC: opcional. Uma especificação para realçar ou ocultar documentos. Valores:
      • BOOST: um número de vírgula flutuante no intervalo [-1,1]. Quando o valor é negativo, os resultados são despromovidos (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 aos quais o aumento se aplica. O filtro tem de ser avaliado como um valor booleano. Para saber mais sobre o aumento da pesquisa estruturada, consulte o artigo Aumente os resultados da pesquisa.

    Deve receber uma resposta JSON semelhante à seguinte resposta truncada. A resposta contém resultados da pesquisa detalhados apresentados na ordem determinada pelos campos definidos no pedido de pesquisa.