Ordenar resultados da pesquisa na Web

A ordenação é um tipo de mecanismo de classificação que muda dinamicamente a sequência em que os resultados são retornados após uma classificação inicial estabelecida durante o processo de recuperação. Durante a recuperação, a Vertex AI para Pesquisa busca os documentos relevantes do repositório de dados na ordem de milhares (sujeito ao tamanho do repositório de dados). Depois disso, os principais resultados são exibidos de acordo com a condição especificada para reordenar. Para mais informações, consulte Sobre recuperação e classificação.

Esta página explica como ordenar os resultados de uma consulta de pesquisa na Web por data.

  • Para repositórios de dados que usam a pesquisa básica no site, é possível ordenar por datas de páginas inferidas pelo Google.
  • Para repositórios de dados que usam a indexação avançada de sites, é possível ordenar por atributos de dados personalizados ou datas de páginas inferidas pelo Google que são adicionadas ao esquema do repositório de dados. Para mais informações, consulte Usar dados estruturados para indexação avançada de sites.

Antes de começar

É necessário fazer o seguinte:

  • Criar um repositório de dados com dados de sites. Para mais informações, consulte URLs de sites.

  • Criar um app de pesquisa e conectá-lo ao repositório de dados. Para mais informações, consulte Criar um app de pesquisa.

Ordenar resultados da pesquisa para pesquisa básica no site

Para ordenar os resultados da pesquisa de um repositório de dados de sites com pesquisa básica no site, siga estas etapas:

REST

O exemplo a seguir mostra como ordenar os resultados da pesquisa na Web para um app com pesquisa básica no site. Este exemplo usa o engines.servingConfigs.search método:

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

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

      Acessar "Apps"

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

  2. Faça uma consulta de pesquisa e inclua o campo orderBy.

    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",
    "query": "QUERY",
    "orderBy": "ORDER_BY"
    }'
    

    Substitua:

    • PROJECT_ID: o ID do Google Cloud projeto.
    • APP_ID: o ID do app da Vertex AI para Pesquisa.
    • QUERY: o texto da consulta a ser pesquisado.
    • ORDER_BY: a ordem em que os resultados são organizados. Por exemplo, para ordenar cronologicamente, especifique date para retornar páginas da Web classificadas por data de página inferida pelo Google. Para mais informações sobre a data da página inferida pelo Google, consulte a postagem do blog Como ajudar a Pesquisa Google a saber qual a melhor data para sua página da Web. A ordem de classificação padrão é decrescente, em que as páginas com as datas mais recentes são retornadas primeiro. Para receber a ordem de classificação crescente, anexe :a ao valor datedate:a.

Ordenar resultados da pesquisa para indexação avançada de sites

Para ordenar os resultados da pesquisa de um repositório de dados de sites com indexação avançada de sites, siga estas etapas:

REST

O exemplo a seguir mostra como ordenar os resultados da pesquisa na Web para um app com indexação avançada de sites. Este exemplo usa o engines.servingConfigs.search método:

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

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

      Acessar "Apps"

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

  2. Faça uma consulta de pesquisa e inclua o campo orderBy.

    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",
    "query": "QUERY",
    "orderBy": "ORDER_BY"
    }'
    

    Substitua:

    • PROJECT_ID: o ID do Google Cloud projeto.
    • APP_ID: o ID do app da Vertex AI para Pesquisa.
    • QUERY: o texto da consulta a ser pesquisado.
    • ORDER_BY: a ordem em que os resultados são organizados. O campo pode ter valores dos seguintes tipos de dados: datetime, integer ou number. Para ordenar cronologicamente, especifique o atributo de data personalizado especificado no esquema ou a data da página inferida pelo Google para retornar páginas da Web classificadas por data. Por exemplo, para ordenar por um date_edited atributo do PageMap, especifique o campo orderBy como "orderBy": "date_edited". A ordem de classificação padrão é crescente, em que as páginas mais antigas são retornadas primeiro. Para receber os resultados em ordem decrescente, anexe desc ao valor do atributo personalizado. Por exemplo, "orderBy":"date_edited desc".