Configurare i risultati per la UI

Questa pagina descrive come configurare i risultati per la UI dell'app web, ovvero l'interfaccia che gli utenti utilizzano per accedere all'app.

Concetti relativi al widget Ricerca

Ecco alcuni concetti che ti aiuteranno a capire come utilizzare i controlli nella scheda UI.

  • Snippet. Una breve sezione di testo, in genere una frase, sotto il titolo del documento. Per impostazione predefinita, viene visualizzato uno snippet per ogni risultato di ricerca per i dati non strutturati e del sito web.

  • Cerca con una risposta. Questa funzionalità fornisce un paragrafo di informazioni (la risposta) sintetizzato dai risultati principali dei dati non strutturati o del sito web. Puoi personalizzare il numero di risultati principali su cui si basa la risposta. Per impostazione predefinita, i primi cinque risultati vengono riepilogati per creare la risposta. La funzionalità Cerca con una risposta non può essere combinata con Cerca con follow-up.

  • Cerca con follow-up. Questa funzionalità per i dati non strutturati e del sito web consente di porre domande di follow-up che mantengono il contesto della query di ricerca iniziale.

  • Completamento automatico. Suggerisce query di ricerca in base alle prime lettere che gli utenti inseriscono nella barra di ricerca. Per scoprire di più, consulta Configura il completamento automatico.

  • Feedback. Fornisce i pulsanti thumb_up e thumb_down in modo che gli utenti possano valutare la qualità dei risultati di ricerca. Queste informazioni vengono inviate solo a Google. Per scoprire di più, consulta Configura il feedback.

  • Metadati. Se i dati sono strutturati o contengono metadati, puoi configurare i campi di metadati da includere nei risultati di ricerca. Puoi anche mappare i campi ai nomi visualizzati per le sfaccettature. Per scoprire di più, consulta Configura le sfaccettature per la UI.

  • Nome visualizzato configurato dall'amministratore per le origini. Mostra il nome visualizzato configurato dall'amministratore per le origini dati nell'app web anziché il tipo di connettore. Per scoprire di più, consulta Mostra i nomi visualizzati configurati dall'amministratore per le origini dati.

Configura i risultati di ricerca per i dati non strutturati o del sito web

La UI per i dati non strutturati e del sito web offre le seguenti personalizzazioni della ricerca:

  • Ricerca (a turno singolo)
  • Cerca con una risposta (ricerca a turno singolo con riepilogo)
  • Cerca con follow-up (ricerca a più turni)

Per configurare la modalità di visualizzazione dei risultati di ricerca per i dati non strutturati nella UI:

  1. Nella Google Cloud console, vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic sul nome dell'app che vuoi modificare.

  3. Nel menu di navigazione, fai clic su Configurazioni.

  4. Fai clic sulla scheda UI.

  5. Modifica i campi nella scheda.

  6. Utilizza il riquadro Anteprima per assicurarti che le modifiche vengano visualizzate come previsto.

  7. Fai clic su Salva e pubblica per applicare le modifiche.

Configura i risultati di ricerca per i dati strutturati

Per impostazione predefinita, la UI visualizza tutte le coppie nome-valore per ogni elemento nei risultati di ricerca per i dati strutturati. Puoi utilizzare la pagina Configurazioni nella Google Cloud console per personalizzare la modalità di visualizzazione dei risultati di ricerca nella UI.

Il seguente elenco mostra i campi principali per la visualizzazione dei risultati di ricerca:

  • Titolo. Il titolo di un elemento su cui un utente può fare clic per selezionarlo in un risultato di ricerca.
  • Miniatura. L'URL di un'immagine da mostrare accanto al titolo dell'elemento in un risultato di ricerca.
  • URL. Un URL a cui l'utente viene indirizzato quando fa clic sul titolo dell'elemento.

Puoi visualizzare fino a tre campi aggiuntivi nei risultati di ricerca e configurare la loro visualizzazione.

Inoltre, puoi selezionare le sfaccettature su cui filtrare i risultati di ricerca e impostare i nomi visualizzati. Per scoprire di più sulla configurazione delle sfaccettature, consulta Configura le sfaccettature per la UI.

Per configurare la modalità di visualizzazione dei risultati di ricerca per i dati strutturati nella UI:

  1. Nella Google Cloud console, vai alla pagina Gemini Enterprise.

    Gemini Enterprise

  2. Fai clic sul nome dell'app di ricerca che vuoi modificare.

  3. Fai clic su Configurazioni.

  4. Fai clic sulla scheda UI.

  5. Se hai più datastore collegati all'app, seleziona il datastore per cui vuoi configurare i risultati.

  6. Espandi la sezione Configura i campi nei risultati.

  7. Nel riquadro Anteprima, digita una query e premi Invio per visualizzare la modalità di visualizzazione dei risultati di ricerca con le impostazioni correnti. L'anteprima si aggiorna automaticamente quando inserisci nuove impostazioni.

  8. (Facoltativo) Fai clic sull'icona di un dispositivo per visualizzare l'anteprima in formato desktop o mobile.

  9. Per configurare i campi principali (Titolo, Miniatura e URL) in risultati di ricerca:

    1. Fai clic sulla casella Titolo e seleziona un campo da mappare ai titoli dei risultati di ricerca. In alternativa, seleziona Nessuno se non vuoi che i titoli vengano visualizzati nei risultati di ricerca.

    2. Fai clic sulla casella Miniatura e seleziona un campo da mappare alle immagini in miniatura nei risultati di ricerca. In alternativa, seleziona Nessuno se non vuoi che le immagini in miniatura vengano visualizzate nei risultati di ricerca.

    3. Fai clic sulla casella URL e seleziona un campo che esegue il mapping agli elementi che si aprono quando gli utenti fanno clic sui titoli degli elementi nei risultati di ricerca. In alternativa, seleziona Nessuno se non vuoi che i titoli degli elementi nei risultati di ricerca rimandino agli elementi.

  10. Per aggiungere altri campi ai risultati di ricerca:

    1. Fai clic sulla casella Testo 1 e seleziona un campo che vuoi visualizzare nei risultati di ricerca. Per impostazione predefinita, nei risultati di ricerca viene visualizzato solo il valore del campo.

    2. Fai clic sulla freccia accanto alla casella Testo 1 per visualizzare la casella Modello. Il campo {value} nella casella Modello rappresenta il valore del campo da visualizzare nel risultato di ricerca. Aggiungi testo prima o dopo il campo {value} (o entrambi) per dare un contesto al valore nei risultati di ricerca. Ad esempio, supponiamo che tu abbia selezionato price nella casella Testo 1 e che il valore del prezzo per un determinato articolo sia 42. Se aggiorni il campo Modello a "Total Price: {value} USD", nei risultati di ricerca per quell'articolo verrà visualizzato "Total Price: 42 USD".

    3. Per aggiungere altri campi, ripeti questi passaggi per le caselle Testo 2 e Testo 3.

  11. Per configurare le impostazioni delle sfaccettature:

    1. Espandi la sezione Impostazioni delle sfaccettature.

    2. Seleziona un campo da impostare come sfaccettatura e inserisci un nome visualizzato.

    3. Per aggiungere altre sfaccettature, fai clic su Aggiungi sfaccettatura.

  12. Controlla il riquadro Anteprima per assicurarti che le modifiche vengano visualizzate correttamente.

  13. Fai clic su Salva e pubblica per applicare le modifiche.

Mostra i nomi visualizzati configurati dall'amministratore per le origini dati

Per impostazione predefinita, l'app web visualizza il tipo di connettore come etichetta per le origini dati a istanza singola. Puoi attivare l'impostazione Utilizza il nome visualizzato configurato dall'amministratore per le origini in modo che l'app web visualizzi invece il nome visualizzato personalizzato che hai configurato per ogni origine dati.

Per attivare o disattivare i nomi visualizzati configurati dall'amministratore per le origini dati:

Console

  1. Nella Google Cloud console, vai alla pagina Gemini Enterprise.

    Vai a Gemini Enterprise

  2. Fai clic sul nome dell'app che vuoi modificare.

  3. Nel menu di navigazione, fai clic su Configurazioni.

  4. Fai clic sulla scheda UI di ricerca.

  5. Nella sezione Configurazioni generali, attiva o disattiva l'opzione Utilizza il nome visualizzato configurato dall'amministratore per le origini.

  6. Fai clic su Salva e pubblica per applicare le modifiche.

REST

Aggiorna il campo uiSettings.sourceAdminDisplayNameEnabled nella risorsa dell'app WidgetConfig chiamando il engines.widgetConfigs.patch metodo:

curl -X PATCH \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "Content-Type: application/json" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION_ID/collections/default_collection/engines/APP_ID/widgetConfigs/default_search_widget_config?updateMask=uiSettings.sourceAdminDisplayNameEnabled" \
  -d '{
    "uiSettings": {
      "sourceAdminDisplayNameEnabled": SOURCE_ADMIN_DISPLAY_NAME_ENABLED
    }
  }'

Sostituisci quanto segue:

  • ENDPOINT_LOCATION: la multi-regione per la richiesta API. Specifica uno dei seguenti valori:
    • us per la multi-regione Stati Uniti
    • eu per la multi-regione UE
    • global per la località globale
    Per scoprire di più, consulta Specifica una multi-regione per il datastore.
  • PROJECT_ID: il numero o l'ID del tuo Google Cloud progetto.
  • LOCATION_ID: la località geografica del datastore, ad esempio global. Per scoprire di più, consulta Località.
  • APP_ID: l'ID dell'app.
  • SOURCE_ADMIN_DISPLAY_NAME_ENABLED: un valore booleano. Specifica true per mostrare il nome visualizzato configurato dall'amministratore per le origini dati o false per mostrare il tipo di connettore.

Passaggi successivi