Ordinare i risultati della ricerca web

L'ordinamento è un tipo di meccanismo di ranking che modifica dinamicamente la sequenza in cui vengono restituiti i risultati dopo un ranking iniziale stabilito durante il processo di recupero. Durante il recupero, la Ricerca agente recupera i documenti pertinenti dal datastore nell'ordine di migliaia (a seconda delle dimensioni del datastore). Dopodiché, i risultati principali vengono pubblicati in base alla condizione specificata per il riordinamento. Per ulteriori informazioni, consulta la sezione Informazioni su recupero e ranking.

In questa pagina viene spiegato come ordinare i risultati di una query di ricerca web per data.

  • Per i datastore che utilizzano la ricerca di base su sito web, puoi ordinare in base alle date delle pagine dedotte da Google.
  • Per i datastore che utilizzano l'indicizzazione avanzata dei siti web, puoi ordinare in base agli attributi dei dati personalizzati o alle date delle pagine dedotte da Google aggiunte allo schema del datastore. Per ulteriori informazioni, consulta la sezione Utilizzare i dati strutturati per l'indicizzazione avanzata dei siti web.

Prima di iniziare

Assicurati di svolgere le seguenti operazioni:

  • Crea un datastore con i dati del sito web. Per ulteriori informazioni, consulta la sezione URL dei siti web.

  • Crea un'app di ricerca e collegala al datastore. Per ulteriori informazioni, consulta la sezione Creare un'app di ricerca.

Ordinare i risultati di ricerca per la ricerca di base su sito web

Per ordinare i risultati di ricerca per un datastore di dati di siti web con la ricerca di base su sito web:

REST

L'esempio seguente mostra come ordinare i risultati della ricerca web per un'app con la ricerca di base su sito web. Questo esempio utilizza il engines.servingConfigs.search metodo:

  1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

    1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

    2. Nella pagina App, trova il nome dell'app e recupera l'ID dell'app dalla colonna ID.

  2. Crea una query di ricerca e includi il 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"
}'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo Google Cloud progetto.
    • APP_ID: l'ID dell'app Ricerca agente.
    • QUERY: il testo della query da cercare.
    • ORDER_BY: l'ordine in cui sono disposti i risultati. Ad esempio, per ordinare in ordine cronologico, specifica date per restituire le pagine web ordinate in base alla data della pagina dedotta da Google. Per ulteriori informazioni sulla data della pagina dedotta da Google, consulta il post del blog Aiutare la Ricerca Google a conoscere la data migliore per la pagina web. L'ordinamento predefinito è decrescente, in cui le pagine con le date più recenti vengono restituite per prime. Per ottenere l'ordinamento crescente, aggiungi :a al valore date , ad esempio date:a.

Ordinare i risultati di ricerca per l'indicizzazione avanzata dei siti web

Per ordinare i risultati di ricerca per un datastore di dati di siti web con l'indicizzazione avanzata dei siti web:

REST

L'esempio seguente mostra come ordinare i risultati della ricerca web per un'app con l'indicizzazione avanzata dei siti web. Questo esempio utilizza il engines.servingConfigs.search metodo:

  1. Trova l'ID app. Se hai già l'ID app, vai al passaggio successivo.

    1. Nella Google Cloud console, vai alla pagina AI Applications.

      Vai ad App

    2. Nella pagina App, trova il nome dell'app e recupera l'ID dell'app dalla colonna ID.

  2. Crea una query di ricerca e includi il 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"
}'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo Google Cloud progetto.
    • APP_ID: l'ID dell'app Ricerca agente.
    • QUERY: il testo della query da cercare.
    • ORDER_BY: l'ordine in cui sono disposti i risultati. Il campo può avere valori dei seguenti tipi di dati: datetime, integer o number. Per ordinare in ordine cronologico, specifica l'attributo data personalizzato specificato nello schema o la data della pagina dedotta da Google per restituire le pagine web ordinate per data. Ad esempio, per ordinare in base a un date_edited attributo PageMap, puoi specificare il campo orderBy come "orderBy": "date_edited". L'ordinamento predefinito è crescente, in cui le pagine meno recenti vengono restituite per prime. Per ottenere i risultati in ordine decrescente, aggiungi desc al valore dell'attributo personalizzato, ad esempio "orderBy":"date_edited desc".