Ricerca conversazionale

Questa pagina descrive una funzionalità di ricerca guidata nella ricerca di conversazione di Vertex AI Search per il commercio.

La ricerca conversazionale consente ai rivenditori di offrire un'esperienza di ricerca più interattiva ai propri utenti. La funzionalità di ricerca di conversazione fa parte del pacchetto Ricerca guidata e offre ai clienti il vantaggio di restringere le query degli utenti e presentare più rapidamente i prodotti pertinenti.

Continua a leggere per scoprire di più su:

• Come funziona la ricerca di conversazione
• L'esperienza di pubblicazione tramite l'API principale (query)
• L'esperienza utente dell'amministratore tramite l'API di controllo e la console

Come funziona la ricerca di conversazione

Quando è attivata, la funzionalità di ricerca conversazionale Vertex AI per il commercio guida gli acquirenti nella ricerca di prodotti sui siti dei commercianti utilizzando la conversazione. Dopo una query iniziale di testo in Vertex AI Search for Commerce, lo shopper online riceve una domanda di follow-up pertinente e opzioni a scelta multipla. L'utente può rispondere alla domanda successiva inserendo un testo libero o facendo clic su un'opzione di conversazione a scelta multipla.

Nota: Sfoglia ha solo l'opzione a scelta multipla, mentre Ricerca ha funzionalità di ricerca conversazionale complete.

Se la ricerca conversazionale è attivata sul sito del rivenditore, le domande di follow-up generano una conversazione che prosegue fino a quando non si verifica uno dei tre seguenti scenari:

• Viene raggiunto un numero minimo di prodotti preconfigurato (ad esempio, una conversazione non è utile quando vengono visualizzati solo due prodotti).
• L'utente fa clic su un prodotto e lo aggiunge al carrello (scopo).
• Le ricerche e le esplorazioni per il retail non generano più domande create con l'IA.

dietro le quinte

La ricerca di conversazione si basa sull'interazione con l'utente tramite una conversazione continua di più turni. Pertanto, è necessaria almeno una seconda risposta per il funzionamento della ricerca di conversazione. All'utente viene presentata una domanda di follow-up e le risposte suggerite nella risposta. L'utente può rispondere a questa domanda aggiuntiva inserendo la propria risposta o facendo clic su una risposta suggerita (opzione a scelta multipla).

• A scelta multipla L'opzione a scelta multipla funziona in background come un'estrazione (un filtro per tipo di evento), che restringe la query utilizzando i filtri. In background, quando l'utente fa clic su una risposta a scelta multipla, alla query viene applicato un filtro. L'applicazione di un filtro utilizzando il menu a scelta multipla conversazionale è identica all'applicazione dello stesso filtro utilizzando riquadri o sfaccettature dinamiche.

• Testo libero Se l'utente risponde con testo libero, viene generata una nuova query più specifica. Scopri di più su come la ricerca di conversazione arricchisce la cattura di filtri ed eventi utente nel percorso dell'utente.

Vantaggi della ricerca conversazionale

L'ampliamento dell'esperienza Vertex AI Search for Commerce con la ricerca conversazionale offre diversi vantaggi sia al rivenditore che all'utente.

Restringi le query in pochi clic

La ricerca di conversazione offre un modo rapido per filtrare 10.000 prodotti in meno di 100 in modo più efficiente. Ciò aumenta le probabilità che l'utente decida di effettuare un acquisto, aumentando il tasso di entrate per ricerca.

Alternativa ai facet dinamici

Le sfaccettature dinamiche sono associate a query generiche con entrate ridotte per query. I clienti possono sentirsi sopraffatti quando vedono decine di migliaia di risultati, con il rischio di abbandonare la loro esperienza di ricerca. In particolare, le query di ricerca che restituiscono un numero elevato di prodotti hanno un livello insolitamente basso di entrate per query. La ricerca conversazionale è in grado di perfezionare le query e può essere utilizzata in combinazione con i facet dinamici. La ricerca conversazionale offre alcuni vantaggi rispetto alle sfaccettature dinamiche, in quanto è più umana, più interattiva e occupa meno spazio sulla pagina.

Domande generative personalizzabili adattate alle preferenze del rivenditore

La ricerca conversazionale incoraggia un'interazione con le domande dell'IA generativa in cui è coinvolto un operatore umano consentendo ai rivenditori di modificare, sovrascrivere o deselezionare preliminarmente le domande generate con l'IA in base alle loro preferenze, in base al catalogo caricato. Le domande possono essere modificate o disattivate singolarmente o collettivamente nella console Ricerca per il commercio o nell'API per personalizzare le domande da mostrare nella ricerca.

Console: esperienza amministratore

La console consente ai rivenditori di gestire le domande generative in un'esperienza di Vertex AI Search for Commerce conversazionale. Scopri di più sull'utilizzo delle domande generative nella ricerca di conversazione.

Passaggi per utilizzare il servizio di domande generative

1. Soddisfare i requisiti dei dati.

2. Configura le sostituzione manuali.

3. Attiva la funzionalità.

4. Anteprima e test.

Requisiti dei dati

Nella console, Ricerca e navigazione conversazionale, nella scheda Controlli copertura o in Qualità dei dati > Conversazione, puoi vedere se i tuoi dati di ricerca sono pronti per la ricerca conversazionale.

Per attivare la ricerca di conversazione, devi soddisfare determinati requisiti relativi ai dati.

Queste sono:

1. 1000 query al giorno: dopo aver raggiunto questa prima soglia, viene generato un piano di conversazione che valuta gli input e gli output:
   • Input: filtra il conteggio negli eventi
   • Output: copertura conversazionale
2. Copertura conversazionale del 25%: calcolata dai modelli di Vertex AI Search for Commerce, la copertura conversazionale indica la percentuale di query che contengono una domanda. Il 25% (per volume) delle query ponderato in base alla frequenza deve avere almeno una prima domanda corrispondente.

Se non hai ancora raggiunto il 25% di copertura conversazionale, ma hai già le prime 1000 query al giorno necessarie, i controlli di blocco e di consulenza iniziano a essere applicati rispettivamente agli output e agli input. A questo punto, Vertex AI Search for Commerce inizia a calcolare in che misura i filtri applicati in base agli eventi utente devono aumentare per raggiungere la soglia del 25% di copertura della conversazione. Più filtri vengono caricati, maggiore sarà la copertura raggiunta.

Per visualizzare la tua idoneità alla conversazione:

1. Vai alla scheda Conversazione nella pagina Qualità dei dati della console Search for Commerce. Qui viene mostrato il controllo critico per verificare se almeno il 25% delle query di ricerca contiene almeno una domanda di follow-up, nonché i controlli di consulenza relativi alla percentuale di eventi utente con filtri validi necessaria per raggiungere l'obiettivo di copertura conversazionale.

2. Se superi il controllo critico, con un numero sufficiente di eventi utente con filtri validi, vai al passaggio successivo.

3. Per controllare il modo in cui vengono pubblicate le domande generative, vai alla pagina Ricerca e navigazione conversazionale nella console Ricerca per il commercio.

Controlli delle domande generative

L'AI generativa scrive una domanda per ogni attributo indicizzato nel catalogo, utilizzando sia i nomi sia i valori degli attributi per gli attributi di sistema e personalizzati. Queste domande vengono generate da un modello LLM e hanno lo scopo di migliorare l'esperienza di ricerca. Ad esempio, per il tipo di arredamento, i valori possono essere interni o esterni, l'IA sintetizzerà una domanda sul tipo di arredamento che stai cercando.

Ogni aspetto avrà una domanda generata. In base agli eventi utente storici e al coinvolgimento delle sfaccettature dai dati sugli eventi di ricerca passati, le domande vengono ordinate in base alla frequenza prevista della visualizzazione della domanda. L'IA esaminerà prima le domande in alto, quindi troverà ciò che è pertinente in base all'attributo. L'elenco di domande viene generato una volta. Se viene aggiunto un nuovo attributo, questo verrà visualizzato nell'elenco entro due ore.

1. Vai alla pagina Ricerca e navigazione conversazionale nella console Ricerca per il commercio.
   
   Vai alla pagina Ricerca conversazionale e navigazione.

2. Nella scheda Gestisci le domande create con l'IA, puoi vedere tutte le domande ordinate in base alla frequenza con cui vengono utilizzate, in base alla frequenza ponderata in base alle query, ovvero alla frequenza con cui vengono mostrate con query comuni. Il ranking utilizza il campo della frequenza in GenerativeQuestionConfig. Questo campo è responsabile dell'ordinamento delle domande create con l'IA in base alla frequenza con cui vengono utilizzate.

3. Puoi utilizzare l'opzione di filtro per filtrare le domande.

4. Seleziona la casella per attivare la visibilità delle domande per ogni attributo.

5. Fai clic su alla fine di ogni riga per aprire un riquadro di modifica per ogni domanda.

Per apportare modifiche collettive:

1. Seleziona o deseleziona le caselle accanto alle domande che vuoi includere o escludere dalla conversazione.

2. Fai clic sui pulsanti Consenti nella conversazione o Non consentire nella conversazione visualizzati nella parte superiore dell'elenco. In alternativa, per modificare una singola domanda, fai clic su e deseleziona o riseleziona la casella accanto a Consentite nella conversazione nel riquadro che si apre:

Come utilizzare le domande generative nella ricerca conversazionale

L'API del servizio di domande generative fornisce controlli per mitigare potenziali incoerenze nell'output dell'LLM. che possono essere gestiti dalla console. Qui i rivenditori possono anche configurare la ricerca conversazionale attivando/disattivando lo stato di abilitazione e impostando il numero minimo di prodotti necessari per attivarla.

Puoi definire le domande, specificando la domanda stessa, le potenziali risposte e se la domanda è consentita nella conversazione. Le singole domande possono essere generate da un modello LLM o sostituite dal rivenditore. La console supporta la revisione delle domande generate con l'IA, consentendo ai retailer di sostituirle o attivare/disattivare il loro stato di conversazione. Le domande possono essere modificate anche collettivamente.

Modificare singole domande

Puoi anche utilizzare i controlli per organizzare le singole domande. Ti consigliamo di farlo prima di attivare la ricerca conversazionale.

Per ogni domanda sono disponibili due opzioni. Fai clic su nell'ultima colonna per accedere alle domande visibili al riquadro degli utenti:

1. Disattivare una domanda per tutte le query: la domanda verrà attivata per impostazione predefinita. Deseleziona (o seleziona di nuovo) la casella accanto a Consentito nella conversazione. Questa opzione ignora completamente la domanda. Un rivenditore può scegliere di disattivare completamente una domanda se non è correlata agli attributi sottoposti a query o potrebbe essere fraintesa come inappropriata in qualche modo (ad esempio, una domanda come "Quale taglia di abito cerchi?" potrebbe essere percepita come una curiosità sul peso di un acquirente).
2. Riscrivere una domanda:nel riquadro puoi vedere la domanda creata con l'IA, a quale attributo è associata e quali valori ha l'attributo. Fai clic sulla matita per riscriverlo.

Attivare la ricerca conversazionale

Dopo aver modificato le domande con l'IA generativa nella console, puoi attivare la ricerca conversazionale.

Per attivare la ricerca conversazionale, vai alla pagina Ricerca e navigazione conversazionale nella console Ricerca per il commercio.

1. Vai alla pagina Ricerca e navigazione conversazionale nella console Ricerca per il commercio.
   
   Vai alla pagina Ricerca conversazionale e navigazione.

2. Nella scheda Configura della ricerca per il commercio, troverai l'impostazione a livello di sistema. Sono incluse l'impostazione dei prodotti minimi necessari per trovare una corrispondenza alla query prima che possa avvenire una conversazione, ovvero quando vengono generate le domande. Questo numero minimo è>= 2. Il valore minimo può essere configurato in modo da essere superiore, ma mai inferiore a 2. Valuta la quantità di prodotti nel tuo catalogo che vuoi che vengano restituiti nella ricerca per consentire agli utenti di iniziare una conversazione. Ad esempio, un punto ottimale per questo numero è una riga per pagina per i risultati di ricerca minimi per attivare una conversazione.

3. Imposta l'opzione su On. Questa pagina fornisce anche informazioni sullo stato dei controlli di blocco e di consulenza. Se hai un numero sufficiente di query di ricerca con almeno una domanda di follow-up, la ricerca di conversazione è ora attivata sul tuo sito.

Valuta e testa

L'opzione Valuta ti consente di visualizzare in anteprima l'esperienza di pubblicazione eseguendo una ricerca di prova e testando le tue domande in base alle sfaccettature visualizzate. Questa parte della console ti offre un'anteprima della tua esperienza di pubblicazione con la ricerca conversazionale.

Per farlo, individua questo modulo nelle schede Cerca o Sfoglia nella pagina Valuta della console Ricerca per il commercio.

1. Vai alla pagina Valuta nella console Ricerca per il commercio.
   
   Vai alla pagina Valuta

2. Nel campo Valutazione ricerca, inserisci una query di test sensata in base al catalogo che hai caricato per la ricerca. Fai clic su Anteprima ricerca. Vedrai i risultati di ricerca e, se hai attivato la ricerca di conversazione, vedrai le domande generative nel riquadro a destra.

3. Nel riquadro a destra viene visualizzato un elenco di domande del test.

API di domande generative: esperienza amministratore

Questa sezione descrive come utilizzare l'API di domande generative per integrare l'API di ricerca conversazionale nella tua UI, gestire le domande generative e pubblicare la funzionalità sul tuo sito.

Integrazione API

• Gestisci l'API GenerativeQuestion dalla Ricerca per il commercio utilizzando:
  • Console di ricerca e navigazione conversazionale
  • Qualità dei dati
  • Valuta

Oggetti:

• GenerativeQuestionsFeatureConfig
• GenerativeQuestionConfig
• Servizio GenerativeQuestions
  • UpdateGenerativeQuestionsFeatureConfiguration
  • UpdateGenerativeQuestionConfig
  • ListGenerativeQuestionConfigs
  • GetGenerativeQuestionFeatureConfig
  • BatchUpdateGenerativeQuestionConfigs

L'elemento fondamentale dell'integrazione di questa funzionalità è la definizione della risorsa "question". Sono inclusi la domanda stessa e se è consentita nella conversazione. Per impostazione predefinita, la domanda viene generata da un modello LLM, ma può essere sostituita dall'amministratore.

Attivare la funzionalità

Oggetto:

• GenerativeQuestionsFeatureConfig

Questo oggetto è un file di configurazione di controllo per attivare la funzionalità per le domande generative al fine di gestire l'esperienza di pubblicazione complessiva della ricerca conversazionale. GenerativeQuestionsFeatureConfig ottiene utilizzando un metodo GET le informazioni sugli attributi e se gli attributi sono indicizzabili o meno dal catalogo associato al progetto.

L'opzione feature_enabled determina se le domande vengono utilizzate al momento della pubblicazione. Gestisce gli switch di primo livello nella console.

Nota: questa funzionalità non può essere attivata finché non vengono soddisfatti i requisiti iniziali dei dati. Se i requisiti dei dati non sono soddisfatti, l'API attiverà un errore di convalida. La convalida dei requisiti dei dati è visibile nella Ricerca per il commercio. Sotto il cofano, chiama questa API di configurazione della funzionalità.

Scopri di più su come attivare la ricerca conversazionale nella console.

Attivazione della funzionalità nell'API

// Configuration for overall generative question feature state.
message GenerativeQuestionsFeatureConfig {
...

  // Resource name of the affected catalog.
  // Format: projects/{project}/locations/{location}/catalogs/{catalog}
  string catalog = 1 [(google.api.field_behavior) = REQUIRED];

  // Determines whether questions will be used at serving time.
  // Note: This feature cannot be enabled until initial data requirements are
  // satisfied.
  bool feature_enabled = 2 [(google.api.field_behavior) = OPTIONAL];

  // Minimum number of products in the response to trigger follow-up questions.
  // Value must be 0 or positive.
  int32 minimum_products = 3 [(google.api.field_behavior) = OPTIONAL];
}

Campi pertinenti alla conversazione
catalog	stringa Il nome della risorsa del catalogo interessato a livello di progetto. Formato: projects/{project}/locations/{location}/catalogs/{catalog}.
feature_enabled	boolean Attiva o disattiva le domande. Campo facoltativo. Non può essere attivata finché non vengono soddisfatti i requisiti dei dati. Se viene tentato, viene generato un errore.
minimum_products	Integer32 Numero minimo di prodotti nella risposta per attivare le domande di follow-up. Deve avere un valore pari o superiore a 0.

Gestire le domande generative

Oggetto:

• GenerativeQuestionConfig

Può essere attivato per le conversazioni con il campo booleano allowed_in_conversation. Controlla la configurazione di una singola domanda generata.

Campi (comportamenti di controllo per la conversazione evidenziati)
catalog	stringa Utilizzata per identificare l'insieme di attributi (e per estensione le domande) disponibili. Questi valori sono tutti definiti nel catalogo. Campo obbligatorio.
Facet	stringa Facet a cui è associata una domanda. Campo obbligatorio.
generated_question	stringa La domanda predefinita generata dall'LLM. Solo output.
final_question	string La domanda che verrà posta. Può avere una lunghezza massima di 300 byte. Campo facoltativo.
example_values	Valori di stringa ripetuti che possono essere utilizzati per rispondere alla domanda. Solo output
frequenza	float Il rapporto tra la frequenza con cui è stata posta una domanda. Solo output.
allowed_in_conversation	boolean Indica se la domanda viene posta al momento della pubblicazione. Questo campo è facoltativo.

Esperienza di pubblicazione abilitata da questa funzionalità

Il servizio di domande generative (service GenerativeQuestionService{...}) viene utilizzato per gestire le domande generate con LLM. Il suo oggetto principale è il catalogo, da cui recupera le informazioni per restituire le domande per un determinato catalogo. Il servizio viene utilizzato per gestire lo stato complessivo della funzionalità delle domande generative, apportare modifiche singole o collettive e attivare o disattivare le domande. Per interfacciarsi con l'API di servizio, devono essere soddisfatti i requisiti dei dati e le domande devono essere prima inizializzate prima di poter essere gestite.

Il servizio interagisce con le configurazioni a livello di funzionalità e di domanda con due insiemi di gestori:

• Gestore di GenerativeQuestionsFeatureConfig (a livello di funzionalità):

  1. Aggiornamento: consente di modificare i prodotti minimi e attivare i campi
  2. Get: restituisce un oggetto

• Gestione degli elementi Config di GenerativeQuestion (a livello di domanda):

  1. Elenco: restituisce tutte le domande per un determinato catalogo
  2. Aggiornamento: gestione delle singole domande
  3. Aggiornamento collettivo: gestione delle domande raggruppate

Il servizio restituirà una domanda semanticamente appropriata in base alla query iniziale.

Una domanda di follow-up viene generata dal modello LLM e può essere sostituita. Le domande vengono visualizzate in base alla probabilità che vengano utilizzate dai clienti chiamando la cronologia degli eventi di ricerca. Se non è presente una cronologia degli eventi di ricerca, il valore predefinito è nei log di ricerca del rivenditore.

Vengono generate domande diverse in base alla query precedente. Non sono previsti pesi fissi. L'AI che genera le domande con l'LLM apprende dalle query e modifica il peso di ogni query, in modo che, ad esempio, la parola "camicia" abbia un peso molto elevato per la categoria, mentre "camicia rossa XL" abbia un peso maggiore per categoria, taglia e colore.

API di configurazione della ricerca conversazionale: esperienza di pubblicazione

L'API di configurazione della ricerca conversazionale è integrata con l'API di ricerca dell'API Vertex AI.

Integrazione API

L'API di configurazione ConversationalSearchSpec per la funzionalità si basa sull'API Vertex AI Search for Commerce esistente. Per supportare la nuova funzionalità di ricerca conversazionale, sono state apportate le seguenti modifiche all'API principale (query) Vertex AI Search for Commerce già esistente:

• ConversationalSearchSpec: questo campo facoltativo è stato aggiunto in SearchRequest, ma è obbligatorio se vuoi utilizzare la funzionalità di ricerca di conversazione. Il campo riutilizza i campi SearchRequest, query e filtro. Include anche un campo per attivare una domanda di follow-up presentata all'utente dopo una query iniziale e un conversation_id per mantenere lo stato della conversazione tra il client e il server.

• ConversationalSearchResult: un file proto contiene informazioni aggiuntive da restituire per il flusso RCS conversazionale in SearchResponse. Sono inclusi conversation_id, refined_query, additional_filters, follow_up_question e suggested_answers (consulta la sezione Percorso dell'utente).

Percorso dell'utente

Il flusso di conversazione funziona nel seguente modo: l'utente avvia una ricerca con una query iniziale e il flag followup_conversation_requested impostato su "true". L'utente seleziona quindi una risposta o fornisce un input di testo libero, che viene inviato nuovamente all'API utilizzando il campo user_answer. L'API perfeziona quindi i risultati di ricerca in base all'input dell'utente e fornisce una nuova domanda di follow-up, che richiede una query di follow-up e continua la conversazione in più turni finché l'utente non trova ciò che cerca sul sito web del rivenditore.

Supponendo che la ricerca di conversazione sia attivata sul sito web, il percorso dell'utente e la successiva interazione con Vertex AI Search for Commerce seguono questo percorso:

• Passaggio 1. La prima query proviene dall'utente
• Passaggio 1a. Conversazione di follow-up richiesta inviata alla ricerca
• Passaggio 1b. Risposta iniziale della ricerca con query perfezionata e risposte suggerite
• Scenario 2: l'utente seleziona una risposta con più opzioni
• Passaggio 2a. Filtro delle risposte selezionate inviato alla ricerca
• Passaggio 2b. Ricerca eseguita di nuovo con il filtro applicato
• Scenario 3: l'utente seleziona un testo libero
• Passaggio 3a. Risposta di testo inviata alla Ricerca
• Passaggio 3b. Ricerca eseguita di nuovo con una query modificata

Passaggio 1: La prima query proviene dall'utente

conversational_search_spec: l'introduzione di questo campo nel messaggio SearchRequest consente al sistema di distinguere tra ricerche conversazionali e regolari. Questa determinazione influisce sul fatto che gli utenti ricevano o meno risposte conversazionali aggiuntive, preservando così le funzionalità di ricerca originali e allo stesso tempo estendendole alle interazioni conversazionali. Il campo conversational_search_spec è nel formato del messaggio e contiene i dettagli necessari per il flusso di conversazione, ad esempio le risposte dell'utente, gli ID conversazione e se l'utente vuole una conversazione di follow-up. Queste informazioni aiutano il sistema a comprendere il contesto e le interazioni degli utenti.

Se il campo booleano followup_conversation_requested è impostato su TRUE, l'API risponde con un insieme iniziale di risultati e una domanda successiva. L'utente riceverà un'esperienza di conversazione nella sua ricerca. Se questo campo è impostato su "FALSE", non viene visualizzata alcuna domanda successiva.

Passaggio 1a. Rivenditore → ricerca: query iniziale con conversazione abilitata

Richiesta JSON

{
  "query": "dress",
  "conversational_search_spec":  {
    "followup_conversation_requested": true
  }
}

Passaggio 1b. Ricerca → rivenditore: ID conversazione, query perfezionata, domanda di follow-up, risposte suggerite

Risposta JSON

{
  "conversational_search_result": {
    "conversation_id": "c154d073-87f5-4edb-accd-587eabe014ff",
    "refined_query": "dress",
    "followup_question": "What is the color?",
    "suggested_answers": [
      {
        "product_attribute_value": {
          "name": "colors",
          "value": "yellow"
        }
      },
      {
        "product_attribute_value": {
          "name": "colors",
          "value": "blue"
        }
      },
      {
        "product_attribute_value": {
          "name": "colors",
          "value": "red"
        }
      }
    ]
  }
}

• conversational_search_result: "ConversationalSearchResult" è un proto che contiene informazioni aggiuntive restituite dal flusso di conversazione. Il campo conversational_search_result in SearchResponse fornisce dati supplementari fondamentali per il rendering dell'interfaccia utente lato client. Il campo conversational_search_result utilizza messaggi nidificati come SuggestedAnswer e AdditionalFilter per strutturare i dati restituiti in modo chiaro e comprensibile. Questa struttura gerarchica garantisce che le informazioni scambiate tra il client e il server siano ben definite e interpretabili.
• Le risposte suggerite sono ordinate in base ai valori facet del catalogo che sono stati attivati più di frequente negli eventi utente come filtri per tutte le query. L'ordinamento utilizza il campo engagement_rate nella domanda di follow-up generata dal proto ConversationalSearch. Questo campo acquisisce il tasso di coinvolgimento storico mostrato dal filtro dagli eventi di ricerca del rivenditore inviati al server.

Che cosa fare con il risultato iniziale della ricerca conversazionale

• conversation_id: un identificatore univoco per la sessione di ricerca in corso, che deve essere archiviato e utilizzato nelle richieste successive. È vuoto nella query iniziale e il server risponderà con conversation_id. Il campo viene utilizzato per tenere traccia di "quale conversazione è in corso", perché uno shopper potrebbe avere più schede o dispositivi aperti.
• refined_query: monitora la query corrente e viene aggiornato man mano che l'utente interagisce con la Ricerca. La situazione cambia se un acquirente sceglie l'input di testo libero. Se lo shopper seleziona un'opzione a scelta multipla, questo campo sarà uguale alla query nella richiesta.
• followup_question: indica al rivenditore quale domanda mostrare all'utente. Contiene i campi question, suggested_answers
• suggested_answers: contiene i valori degli attributi del prodotto contenenti coppie chiave-valore di nome e valore per ogni risposta suggerita. Fornisce un elenco di opzioni a scelta multipla. Questo campo può essere impostato in modo da mostrare solo i primi N risultati a scelta multipla. Questi vengono ordinati in base a un campo engagement_rate, che rappresenta la probabilità che la domanda venga utilizzata in una ricerca.

Scenario 2: l'utente seleziona un'opzione a scelta multipla

Se un utente ha selezionato una risposta a scelta multipla yellow:

• conversation_id viene ripristinato dallo spazio di archiviazione della sessione.
• followup_conversation_requested è impostato su true.
• La stringa user_answer utilizza "selected_answer", che contiene una coppia chiave-valore product_attribute_value, o text_answer, che contiene il valore di input di testo libero per indicare la scelta dell'utente. Questo campo si trova all'interno del campo conversational_search_spec e contiene altri messaggi nidificati come "Risposta selezionata" per specificare i tipi di input dell'utente (testo o risposte selezionate).
• Il risultato torna a chiamare l'oggetto SearchResults e i relativi campi.
• selected_answerQuesto campo trasmette gli attributi del prodotto per guidare la ricerca conversazionale.

Passaggio 2a. Rivenditore → ricerca: filtro di risposta selezionato

Richiesta JSON

{
  "query": "dress",
  "conversational_search_spec": {
    "followup_conversation_requested": true,
    "conversation_id": "c154d073-87f5-4edb-accd-587eabe014ff",
    "user_answer": {
      "selected_answer": {
        "product_attribute_value": {
          "name": "colors",
          "value": "yellow"
        }
      }
    }
  }
}

Passaggio 2b. Ricerca → rivenditore: filtri applicati

Risposta JSON

{
  "conversational_search_result": {
    "conversation_id": "c154d073-87f5-4edb-accd-587eabe014ff",
    "refined_query": "dress",
    "additional_filter": {
      "product_attribute_value": {
        "name": "colors",
        "value": "yellow"
      }
    },
    "followup_question": "What is the occasion?",
    "suggested_answers": [
      {
        "product_attribute_value": {
          "name": "attribute.occasion",
          "value": "wedding"
        }
      },
      {
        "product_attribute_value": {
          "name": "attribute.occasion",
          "value": "party"
        }
      }
    ]
  }
}

Che cosa fare con una risposta a scelta multipla

La risposta alla ricerca è praticamente identica alla risposta alla prima query, tranne per il fatto che utilizza anche un additional_filter. In questo esempio, deve essere utilizzato per selezionare la casella del filtro per colore = giallo. Deve essere aggiunto al campo filter nelle richieste di ricerca di follow-up o nei caricamenti di eventi, come in filter: "colors:ANY(\"yellow\")".

Scenario 3: l'utente seleziona un input di testo libero

Se un utente digita lavender:

• conversation_id viene ripristinato dallo spazio di archiviazione della sessione
• followup_conversation_requested è impostato su true
• user_answer è impostato per ciò che l'utente inserisce (con il prefisso text_answer:)

Passaggio 3a. Rivenditore → ricerca: risposta di testo

Richiesta JSON

{
  "query": "dress",
  "conversational_search_spec": {
    "followup_conversation_requested": true,
    "conversation_id": "c154d073-87f5-4edb-accd-587eabe014ff",
    "user_answer": {
      "text_answer": "lavender"
    }
  }
}

Tieni presente l'assenza di un campo di filtro nella richiesta di testo libero.

Passaggio 3b. Ricerca → rivenditore: esecuzione con query modificata

Risposta JSON

{
  "conversational_search_result": {
    "conversation_id": "c154d073-87f5-4edb-accd-587eabe014ff",
    "refined_query": "lavender dress",
    "followup_question": "What is the occasion?",
    "suggested_answers": [
      {
        "product_attribute_value": {
          "name": "attribute.occasion",
          "value": "wedding"
        }
      },
      {
        "product_attribute_value": {
          "name": "attribute.occasion",
          "value": "party"
        }
      }
    ]
  }
}

Che cosa fare con una risposta di testo libera

• Simile alla risposta iniziale, ma tieni presente che refined_query è ora aggiornato di conseguenza.
• Aggiorna l'interfaccia utente della ricerca ("casella di ricerca") con la query perfezionata.
• Invia la query perfezionata negli eventi nelle richieste di ricerca di follow-up o nei caricamenti di eventi.
• Se l'utente fornisce una risposta di testo libero che corrisponde a una risposta suggerita (ad esempio text_answer="yellow" quando è presente colors="yellow" come risposta suggerita), questa richiesta verrà trattata come una risposta a scelta multipla (vedi sopra).