Ricevere risultati di navigazione personalizzati

La navigazione utilizza metodi di navigazione per visualizzare i risultati di ricerca che corrispondono alle categorie o ai filtri selezionati dall'utente finale. La navigazione restituisce risultati che possono essere personalizzati. Questa pagina descrive come ottenere i risultati di navigazione per gli archivi di dati di ricerca generici.

Informazioni sulla navigazione

In un'app di ricerca di applicazioni AI, sfogliare significa cercare senza query o con una query vuota. Se hai un datastore di ricerca generico che contiene dati strutturati, dati non strutturati con metadati o dati di siti web, puoi inviare una query di ricerca vuota per ricevere i risultati di navigazione.

Quando invii una richiesta di navigazione, i documenti nel datastore che corrispondono ai filtri vengono restituiti in base ai segnali basati sugli eventi. Puoi offrire un'esperienza di navigazione migliorata nel seguente modo:

  • Utilizza i filtri nella richiesta di ricerca per restringere i risultati. Se utilizzi l'indicizzazione avanzata dei siti web, consulta Utilizzare i dati strutturati per l'indicizzazione avanzata dei siti web per capire come aggiungere metadati allo schema e utilizzarli per arricchire i campi di filtri e boost.
  • Aggiungi una specifica di boost per influenzare l'ordine dei risultati restituiti aumentando o nascondendo risultati specifici.
  • Comprendere gli eventi utente e registrarli. Google utilizza gli eventi utente per ottimizzare il ranking dei risultati in base alla percentuale di clic.

La seguente tabella mostra le differenze tra la ricerca e la navigazione.

Funzionalità Cerca Sfoglia
Finalità Trovare informazioni specifiche Esplorare e scoprire contenuti
Esempio Ricerca di "migliori ristoranti coreani a Vancouver" su Ricerca Google Ricerca di un ristorante in base alle categorie a cui potrebbe appartenere, ad esempio "Ristoranti > Coreano > Vancouver > 4 stelle e superiori"
User Intent In genere orientati agli obiettivi Esplorativo
Punto di partenza Una query o una parola chiave in genere in una barra di ricerca Un sito web o una piattaforma specifici in genere utilizzando un menu, breadcrumb, link o altri metodi di navigazione come i filtri
Metodo Inserimento di parole chiave o frasi e applicazione della configurazione di ricerca e pubblicazione Ricerca con una query vuota, applicazione della configurazione di ricerca e pubblicazione
Risultati Un elenco di risultati pertinenti Tutti i documenti nel datastore che corrispondono ai filtri

Ottenere risultati di navigazione per un'app con dati di un sito web

Per utilizzare l'API per ottenere i risultati di navigazione per un'app con dati del sito web:

  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 della tua app e recupera il relativo ID dalla colonna ID.

  2. Chiama il metodo engines.servingConfigs.search con una query vuota o senza query come segue:

    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",
}'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo Google Cloud progetto.
    • APP_ID: l'ID dell'app Vertex AI Search per cui vuoi eseguire query.
    • ORDER_BY: facoltativo. L'ordine in cui sono disposti i risultati. L'attributo in base al quale ordinare deve avere un'interpretazione numerica, ad esempio date. Per saperne di più, consulta Ordinare i risultati della ricerca web.
    • FILTER: facoltativo, ma consigliato. Un campo di testo per filtrare la ricerca utilizzando un'espressione di filtro. Il valore predefinito è una stringa vuota. Per saperne di più sull'utilizzo del campo filter, consulta Filtrare la ricerca generica per dati strutturati o non strutturati e Filtrare la ricerca sui siti web.
    • BOOST_SPEC: facoltativo. Una specifica per promuovere o nascondere i documenti. Valori:
      • BOOST: un numero in virgola mobile nell'intervallo [-1,1]. Quando il valore è negativo, i risultati vengono declassati (vengono visualizzati più in basso nei risultati). Quando il valore è positivo, i risultati vengono promossi (vengono visualizzati più in alto nei risultati).
      • CONDITION: un'espressione di filtro di testo per selezionare i documenti a cui viene applicato l'incremento. Il filtro deve restituire un valore booleano. Per scoprire di più sul boost per la ricerca strutturata, consulta Migliorare i risultati di ricerca.

    Dovresti ricevere una risposta JSON simile alla seguente risposta troncata. La risposta contiene risultati di ricerca dettagliati elencati nell'ordine determinato dai campi impostati nella richiesta di ricerca.