Questa pagina mostra come configurare i campi dello schema per configurare un'app per dati strutturati, per dati non strutturati con metadati o per dati di siti web con attributi strutturati personalizzati.
Le impostazioni dei campi aiutano a determinare in che modo Agent Search utilizza i campi nei risultati. Puoi utilizzare la scheda Schema nella consoleGoogle Cloud per configurare le impostazioni dei campi.
La configurazione delle impostazioni dei campi è disponibile solo per le app con datastore contenenti dati strutturati o non strutturati con metadati.
Impostazioni del campo
Le seguenti impostazioni dei campi sono disponibili per molti tipi di campi nei dati di ricerca o dei contenuti consigliati, ma non per tutti i tipi di dati. Uno schema contiene più impostazioni dei campi per i singoli campi e la tabella successiva contiene le impostazioni che possono essere applicate a un campo all'interno di uno schema. L'utilizzo di dati strutturati è vivamente consigliato per le seguenti impostazioni dei campi:
| Impostazione | Definizione | Finalità | Esempio di caso d'uso |
|---|---|---|---|
| Indicizzabile | L'impostazione dei campi come indicizzabili consente operazioni come il filtro, il boosting e la suddivisione in gruppi su campi strutturati all'interno di un documento. I campi di tipo |
Contrassegnare un campo come Tieni presente che contrassegnare un campo come |
In un datastore di hotel, puoi impostare un campo, ad esempio hotel_chain, come indicizzabile. In questo modo puoi applicare operazioni di ranking, filtro e boosting su hotel_chain. Ad esempio, puoi applicare un filtro in modo che la ricerca mostri solo i risultati di ricerca contenenti la catena alberghiera filtrata. |
| Searchable |
I campi che hanno maggiori probabilità di essere correlati alle ricerche sono designati come Solo i campi con valori di testo possono essere contrassegnati come ricercabili. Pertanto, un campo numerico del prezzo può essere indicizzabile (per il filtro o la suddivisione in gruppi), ma non può essere ricercabile come testo completo. |
Se un campo è impostato su Ricercabile, il richiamo di questo campo nelle query di ricerca viene migliorato, consentendo agli utenti di trovare contenuti, come pagine web, eseguendo query sul testo all'interno di questi campi. Se contrassegni un campo come ricercabile, puoi applicare il ranking. Di conseguenza, contrassegnare un numero eccessivo di campi come ricercabili può influire negativamente sulla precisione della ricerca, saturando l'algoritmo di ranking e restituendo troppi risultati. Ciò può portare a risultati di ricerca non pertinenti. Puoi applicare una ponderazione relativa ai campi di ricerca; tuttavia, grazie ai valori predefiniti efficaci, questa operazione è raramente necessaria. Consulta i campi di ricerca ponderati di seguito. |
Il sistema di ticket di assistenza di un provider di servizi internet archivia ogni ticket come documento strutturato. Se questi documenti contengono campi di testo ricercabili, come
|
| Prefisso abbinabile (Anteprima) |
Consente la corrispondenza del prefisso dei campi di testo utilizzando l'operatore Per saperne di più, consulta Rendi i campi disponibili per la corrispondenza parziale e con prefisso di seguito. |
L'impostazione di un campo su Abbinabile con prefisso consente al motore di ricerca di abbinare le stringhe di query che sono prefissi del valore del campo. Ciò è particolarmente utile per la corrispondenza di identificatori, percorsi o codici gerarchici in cui l'inizio della stringa è noto. La corrispondenza del prefisso è limitata ai primi 12 caratteri del valore del campo normalizzato e aumenta le dimensioni dell'indice della Ricerca. Non puoi impostare più di 10 campi come corrispondenti al prefisso. |
Hai un campo, |
| Parzialmente abbinabile (Anteprima) |
Consente la corrispondenza parziale delle stringhe nei campi di testo utilizzando l'operatore Per saperne di più, consulta Rendi i campi disponibili per la corrispondenza parziale e con prefisso di seguito. |
L'impostazione di un campo su parzialmente corrispondente consente la corrispondenza basata su token all'interno di un campo, consentendo agli utenti di trovare i contenuti quando è nota solo una parte del valore del campo. Il motore di ricerca confronta i token della query con i token nel valore del campo, indipendentemente dal loro ordine. Tieni presente che contrassegnare un campo come parzialmente corrispondente aumenta le dimensioni dell'indice della Ricerca. Non puoi impostare più di 10 campi come parzialmente corrispondenti. |
Vuoi filtrare in base alle regioni in Europa. I nomi |
| Compatibile con la ricerca istantanea (Anteprima) |
Contrassegna un campo di testo come utilizzabile dalla ricerca istantanea: mentre l'utente digita, vengono restituiti i documenti se il valore del campo contiene un token che inizia con il testo della query e l'insieme di risultati viene riordinato a ogni pressione di un tasto. Solo i campi di tipo Per saperne di più, consulta la sezione Rendi i campi disponibili per la ricerca istantanea di seguito. |
Se imposti un campo su |
In un datastore di film, imposti il campo |
| Suddivisione in facet dinamica | Fornisce filtri sensibili al contesto per indirizzare meglio le ricerche degli utenti. Se imposti un campo come Dynamic Facetable, il sistema può generare automaticamente filtri interattivi (aspetti) in base ai valori univoci presenti nel campo. |
Se imposti un campo su Dynamic
facetable, gli utenti possono perfezionare dinamicamente i risultati di ricerca selezionando categorie o attributi derivati direttamente dai dati importati, senza dover predefinire manualmente ogni possibile opzione di filtro. In questo modo, l'utente può restringere la ricerca a contenuti web molto specifici.Utilizza Facettabile dinamico con Ricercabile per ottenere risultati migliori, migliorando sia il richiamo della ricerca sia la qualità dei facet offerti all'utente. |
Le pagine di una knowledge base aziendale interna, come le norme relative RU, vengono importate con dati come department, document_type o last_modified_date. Se questi campi sono taggati come dynamic facetable, la ricerca di un dipendente per un termine come rimborso spese genera dinamicamente filtri interattivi in base ai risultati pertinenti trovati. In questo caso, l'interfaccia web potrebbe visualizzare i facet per Reparto: Finanza, Viaggi, Tipo di documento: Policy, Domande frequenti o Data ultima modifica: Questo trimestre, Ultimo anno. |
| Recuperabile | Quando una query di ricerca trova contenuti corrispondenti, il motore di ricerca può estrarre i valori dei campi recuperabili da visualizzare o da utilizzare nell'applicazione, il che significa che le informazioni del documento originale vengono visualizzate come parte dei risultati di ricerca. I campi chiave (identificatori univoci dei documenti) sono configurati come recuperabili. | I campi recuperabili forniscono il contesto di ricerca distinguendo i campi i cui valori possono essere visualizzati da quelli che devono essere utilizzati solo nella logica di ricerca, ma i cui valori non elaborati non devono essere mostrati all'utente. | Per una ricerca di prodotti su un sito di un commerciante, product_id, name, price e un image_url sono campi tipici che vuoi impostare come recuperabili. D'altra parte, il internal_tracking_code può essere indicizzato e filtrabile solo per scopi amministrativi, ma non recuperabile nei risultati di ricerca pubblici. |
| Completabile | Consente di utilizzare i contenuti di un campo per i suggerimenti per le query di ricerca. Per saperne di più, consulta Configura il completamento automatico. | Questa impostazione consente di utilizzare i valori all'interno di questo campo per fornire suggerimenti di query in tempo reale durante la digitazione degli utenti. Questa funzionalità aiuta a indirizzare gli utenti verso contenuti pertinenti e accelera il processo di ricerca. Alcuni fattori, come l'utilizzo di filtri in linguaggio naturale, possono influire su queste prestazioni. | Se il campo completable è impostato su product_name, brand e category, quando l'utente digita Tech, i suggerimenti di completamento automatico possono mostrare:
|
| Filtrabile | Consente ai suggerimenti di utilizzare un campo per filtrare i risultati suggeriti, determinando quali risultati di ricerca vengono visualizzati dagli utenti. Per informazioni su come filtrare i suggerimenti, consulta Filtra i suggerimenti. | L'impostazione di un campo su Filterable consente di personalizzare i consigli per gli utenti. Tieni presente che si applicano i limiti di filtro. |
Un'impostazione di filtro per lingua e genere drammatico potrebbe essere: language_code: ANY("en", "fr") OR categories: ANY("drama"). |
Differenze tra le impostazioni di uso comune
Esistono differenze fondamentali tra le impostazioni dei campi Indicizzabile, Ricercabile e Recuperabile. La tabella riassume queste differenze.
| Funzionalità | Indicizzabile | Disponibile per la ricerca | Recuperabile |
|---|---|---|---|
| Ruolo principale | Rende i contenuti del campo disponibili per il motore di ricerca | Consente l'esecuzione di query di ricerca a testo intero sui contenuti dei campi | Consente di restituire il valore del campo nei risultati di ricerca |
| Analisi | I contenuti vengono elaborati e inseriti in un indice. | In genere viene sottoposto a un'analisi lessicale approfondita. | Il valore viene memorizzato così com'è per la visualizzazione. |
| Può essere… | |||
| …Ricercabile? | Sì (spesso un prerequisito) | N/D | Non necessariamente (può essere recuperabile senza essere ricercabile) |
| …Recuperabile? | Non necessariamente | Non necessariamente | N/D |
| …Filterable/Sortable/Facetable? | Sì (generalmente un prerequisito anche per questi) | Non direttamente; si tratta di attributi separati spesso basati su un campo indicizzabile. | Non direttamente; questi attributi si riferiscono al modo in cui il campo viene indicizzato e interrogato, non solo visualizzato. |
In pratica, molti campi fondamentali per l'esperienza utente (come titoli, descrizioni e informazioni identitarie) sono spesso impostati su indexable, searchable e retrievable.
Limitazioni
Le impostazioni dei campi presentano le seguenti limitazioni:
- Puoi configurare fino a 50 campi come indicizzabili, ricercabili, recuperabili o con suddivisione dinamica in facet.
- Per configurare un campo come suddivisibile in facet in modo dinamico, deve prima essere configurato come indicizzabile.
- La modifica dell'impostazione indicizzabile richiede la reindicizzazione dei dati, che può richiedere ore, soprattutto per i datastore di grandi dimensioni.
Se stai configurando i campi per un'app di ricerca di contenuti multimediali e vuoi informazioni dettagliate sui campi dello schema, consulta Informazioni sui documenti multimediali e sui datastore.
Aggiorna le impostazioni dei campi
Per aggiornare le impostazioni dei campi:
Nella Google Cloud console, vai alla pagina AI Applications.
Fai clic sul nome dell'app da modificare.
Fai clic su Dati.
Fai clic sulla scheda Schema. Questa scheda mostra le impostazioni correnti dei campi.
La scheda Schema non viene visualizzata se il datastore contiene dati di base del sito web o dati non strutturati senza metadati.
Fai clic su Modifica.
Seleziona o deseleziona le impostazioni dei campi che devi aggiornare. Alcune impostazioni dei campi non sono supportate. Ad esempio, i campi numerici non possono essere impostati su Ricercabile.
Fai clic su Salva per applicare le modifiche.
Pondera i campi di ricerca (anteprima)
Se contrassegni un campo come ricercabile, puoi specificare una ponderazione per indicare la sua importanza relativa nei risultati di ricerca. Nella maggior parte dei casi non è necessario specificare i pesi per i singoli campi perché i pesi predefiniti funzionano bene.
Tuttavia, in alcune situazioni può essere necessario modificare i pesi, ad esempio:
Stai eseguendo la migrazione dei dati da una piattaforma di ricerca esistente che utilizza già campi ponderati.
Quando i pesi predefiniti non forniscono risultati di ricerca soddisfacenti. In particolare, questo può accadere quando hai molti campi di ricerca e alcuni sono decisamente più importanti di altri.
Forse il riepilogo è il campo più importante per le ricerche, quindi vuoi dare la priorità a quel testo.
In alternativa, lo schema ha un campo contenente parole chiave molto pertinenti che sono ottimi predittori per i risultati di ricerca, ma, poiché questo campo è molto più breve di altri, la sua influenza è spesso oscurata da campi più lunghi. Aumentando la ponderazione, l'input avrà l'impatto previsto.
Livelli di peso
I pesi sono suddivisi nei seguenti livelli:
| Importanza dei campi | Spiegazione |
|---|---|
| Molto bassa | Un valore basso che il sistema considera comunque quando combina i punteggi di tutti i campi. Se vuoi un peso ancora inferiore, in modo che l'effetto sia trascurabile, non contrassegnare il campo come ricercabile. |
| Bassa | Un peso inferiore a quello predefinito. |
| Predefinito | Il peso standard per i campi di ricerca. Questo peso offre prestazioni ragionevolmente buone per la maggior parte dei casi. |
| Alta | Un peso notevolmente superiore a quello predefinito. |
| Molto alto | Un peso dominante. In genere, questa opzione viene riservata al massimo a un campo. |
Aggiornamento dello schema e reindicizzazione
L'aggiunta di pesi ai campi di ricerca richiede un aggiornamento dello schema e la successiva reindicizzazione dei dati nel datastore. L'aggiornamento dello schema richiede ore e non esiste un indicatore affidabile per sapere quando l'indicizzazione è completata, quindi devi sovrastimare il tempo di indicizzazione.
Imposta i livelli di ponderazione sui campi
L'attività di impostazione dei livelli di ponderazione per i campi può essere noiosa perché devi apportare solo piccole modifiche ed esaminare attentamente i risultati di ricerca in un secondo momento per verificare la presenza di conseguenze indesiderate. Dopo ogni modifica, devi attendere il completamento della reindicizzazione prima di poter valutare l'impatto della modifica.
Puoi configurare la ponderazione dei campi di ricerca solo tramite l'API. Questa funzionalità non è disponibile nella console Google Cloud .
Per impostare i pesi, devi aggiornare lo schema del datastore tramite il metodo API projects.locations.dataStores.schemas.patch.
Se non hai ancora lo schema, segui le istruzioni per ottenerlo in Visualizza una definizione di schema.
Segui le istruzioni per aggiornare lo schema in modo programmatico. Aggiungi ponderazioni a uno o più campi di ricerca, come in questi esempi:
"summary": { "type": "string", "searchable": true, "weight": "high" }, "uri": { "type": "string", "searchable": true, "weight": "low" },In questo esempio, il campo
summaryè impostato su un peso superiore al normale e il campourisu un peso inferiore. Se vuoi ripristinare il valore predefinito di un peso, impostalo sudefault.I valori consentiti per il parametro weight sono:
very_lowlowdefaulthighvery_high
Attendi il completamento della reindicizzazione e testa il comportamento di ricerca.
Rendi i campi disponibili per la corrispondenza parziale e del prefisso (anteprima)
Per i campi di tipo string, puoi modificare lo schema per renderli disponibili per la corrispondenza dei prefissi o la corrispondenza parziale. In questo modo puoi utilizzare STARTS_WITH o CONTAINS nelle espressioni di filtro.
Aggiornamento dello schema e reindicizzazione
Per rendere i campi disponibili per la corrispondenza parziale o con prefisso, è necessario un aggiornamento dello schema e la successiva reindicizzazione dei dati nel datastore. L'aggiornamento dello schema richiede ore e non esiste un indicatore affidabile che indichi quando l'indicizzazione è completata, quindi devi sovrastimare il tempo di indicizzazione.
Aggiorna lo schema per la corrispondenza parziale e dei prefissi
Per specificare i campi disponibili per la corrispondenza del prefisso o la corrispondenza parziale, devi aggiornare lo schema del datastore tramite il metodo projects.locations.dataStores.schemas.patch dell'API.
Se non hai ancora lo schema, segui le istruzioni per ottenerlo in Visualizza una definizione di schema.
Segui le istruzioni per aggiornare lo schema in modo programmatico. Imposta i parametri abbinabili su
truenello schema, come in questi esempi:"zone": { "type": "string", "searchable": true, "prefixMatchable": true }, "region": { "type": "string", "searchable": true, "partialMatchable": true }, "model": { "type": "string", "searchable": true, "prefixMatchable": true, "partialMatchable": true },In questo esempio, il campo
zoneè impostato in modo da poter essere abbinato al prefisso. Nell'espressione di filtro è possibile utilizzare fino a 12 caratteri, senza distinzione tra maiuscole e minuscole, per trovare una corrispondenza con il valore del campo. Il camporegionè impostato in modo da essere parzialmente abbinabile.Attendi il completamento della reindicizzazione.
Dettagli sulla corrispondenza dei prefissi
La corrispondenza dei prefissi in Agent Search consente di filtrare i risultati in base al fatto che il valore di un campo inizi con una stringa specifica. Questa funzionalità è supportata dall'operatore STARTS_WITH e richiede che il campo di testo di destinazione sia configurato come prefixMatchable nello schema.
Logica di normalizzazione e corrispondenza
Per ottimizzare le prestazioni e garantire la coerenza, il sistema applica un processo di normalizzazione specifico sia al valore del campo (durante l'indicizzazione) sia alla stringa di query (durante la ricerca).
Conversione in minuscolo: tutti i caratteri vengono convertiti in minuscolo. In questo modo, la corrispondenza non distingue tra maiuscole e minuscole.
Troncamento a 12 caratteri: il sistema prende in considerazione solo i primi 12 caratteri della stringa. Eventuali caratteri oltre questo limite vengono ignorati ai fini della corrispondenza del prefisso.
Come funziona
Al momento dell'indicizzazione, per un campo contrassegnato come prefixMatchable, il sistema genera token di prefisso per i primi 12 caratteri. Per un valore come asia-south1-c, l'indice memorizza i token per a, as, asi, asia, asia- e così via, fino al dodicesimo carattere (asia-south1-).
Al momento della query, anche la stringa fornita all'operatore STARTS_WITH viene convertita in minuscolo e troncata a 12 caratteri. La query viene quindi confrontata con i token di prefisso archiviati.
Esempi
Gli esempi seguenti mostrano in che modo la normalizzazione di 12 caratteri influisce sui risultati di ricerca:
Corrispondenze generiche:
STARTS_WITH("A")corrisponde a qualsiasi valore che inizia con "a" (senza distinzione tra maiuscole e minuscole), ad esempioasia,australiaoafrica.Prefissi parziali:
STARTS_WITH("asia-south")corrisponde sia aasia-south1-asia aasia-southeast1-bperché entrambi iniziano con la stringa di 10 caratteri specificata.Comportamento di troncamento: poiché vengono trovati solo i primi 12 caratteri,
STARTS_WITH("asia-south1-a")corrisponde a un valore di campo diasia-south1-c. Questo accade perché entrambe le stringhe vengono normalizzate con lo stesso prefisso di 12 caratteri:asia-south1-.
Dettagli sulla corrispondenza parziale
La corrispondenza parziale in Agent Search consente di filtrare i risultati in base al fatto che il valore di un campo contenga parole o token specifici. Questa funzionalità è basata sull'operatore CONTAINS e richiede che il campo di testo di destinazione sia configurato come partialMatchable nello schema.
Logica di normalizzazione e tokenizzazione
Agent Search normalizza e tokenizza sia il valore del campo (durante l'indicizzazione) sia la stringa di query (durante la ricerca):
Conversione in minuscolo: Agent Search converte i caratteri in minuscolo. In questo modo, la corrispondenza non distingue tra maiuscole e minuscole.
Tokenizzazione: Agent Search suddivide la stringa in singoli token (parole) utilizzando spazi e altri caratteri come delimitatori.
Delimitatori standard: gli spazi e la punteggiatura comune fungono da delimitatori; tra questi sono inclusi trattini (
-), barre (/), virgole (,), punti (.), asterischi (*), parentesi graffe ({ }), parentesi quadre ([ ]), parentesi tonde (( )) e apostrofi (').Non delimitatori: la e commerciale (
&) e il trattino basso (_) non fungono da delimitatori. Il sistema considera i caratteri uniti da questi simboli come un unico token.Delimitatore email (
@): il simbolo@funge da delimitatore speciale per facilitare il riconoscimento degli indirizzi email. Il sistema genera token per i singoli componenti e per le forme combinate. Ad esempio, tokenizzasupport+tier1@example.cominsupport,tier1,example,com,support+tier1@example.comesupport@example.com.
Come funziona
Al momento dell'indicizzazione, per un campo contrassegnato come partialMatchable, il sistema normalizza e tokenizza il valore del campo e memorizza i token risultanti nell'indice. Ad esempio, tokenizza un valore di campo da 25-meter, outdoor, swimming
pool a [25, meter, outdoor, swimming, pool].
Al momento della query, la stringa fornita all'operatore CONTAINS viene sottoposta allo stesso processo di normalizzazione e tokenizzazione. Il motore di ricerca verifica quindi che tutti i token di query risultanti corrispondano ai token archiviati per il campo. L'ordine dei token non ha alcun effetto.
Esempi
I seguenti esempi mostrano in che modo la tokenizzazione influisce sui risultati della corrispondenza parziale:
Corrispondenza di base dei token: se il valore del campo è
25-meter, outdoor, swimming pool, un filtro diCONTAINS("Outdoor pool")corrisponde. Il sistema tokenizza la query in[outdoor, pool], entrambi presenti nei token del campo.Indipendenza dall'ordine: un filtro di
CONTAINS("pool outdoor")corrisponde anche al valore del campo25-meter, outdoor, swimming poolperché il sistema verifica la presenza di ogni token indipendentemente dal suo ordine.Corrispondenza degli indirizzi email: se un campo memorizza l'indirizzo email
support+tier1@example.com, filtri comeCONTAINS("support"),CONTAINS("example.com")oCONTAINS("support@example.com")corrispondono tutti correttamente a causa della tokenizzazione speciale del simbolo@.
Rendi i campi disponibili per la ricerca durante la digitazione (anteprima)
Per i campi di tipo string, puoi modificare lo schema per contrassegnarli come saytCompatible. Quando uno o più campi dello schema sono saytCompatible
e la tua applicazione attiva la ricerca istantanea nella richiesta di ricerca,
Agent Search restituisce i documenti i cui campi saytCompatible contengono
un token che inizia con il testo della query e riordina i documenti a ogni
pressione di un tasto.
Informazioni sulla ricerca istantanea per i contenuti multimediali
La ricerca durante la digitazione è una funzionalità in disponibilità generale per le app multimediali. Consulta Ottenere risultati di ricerca istantanea per un'app multimediale per il campo della richiesta searchAsYouTypeSpec.condition solo per i contenuti multimediali.
L'impostazione del campo saytCompatible estende la ricerca istantanea a qualsiasi app di ricerca, consentendoti di contrassegnare i campi dello schema specifici per rispondere a query parziali.
Le app multimediali possono continuare a utilizzare searchAsYouTypeSpec.condition come prima;
le app non multimediali richiedono i campi saytCompatible nello schema.
Completamento automatico e ricerca durante la digitazione
La ricerca istantanea è diversa dal completamento automatico:
- Il completamento automatico prevede le stringhe di query ed è basato sull'impostazione del campo
completable. - La Search-as-you-type restituisce documenti classificati ed è basata sull'impostazione del campo
saytCompatible.
Le due funzionalità possono essere utilizzate in modo indipendente o insieme e non condividono dati.
Limiti
La creazione di campi saytCompatible presenta i seguenti limiti:
- Non puoi contrassegnare più di tre campi per schema come
saytCompatible. Se ne imposti un quarto, l'API restituisce un erroreINVALID_ARGUMENTquando applichi la patch allo schema. saytCompatibleè valido solo per i campi di tipostring. Se lo imposti sui campinumber,integer,boolean,objectodatetime, l'API restituisce un erroreINVALID_ARGUMENT.- Vengono indicizzati solo i primi 12 token del valore di un campo e ogni token contribuisce con frammenti di prefisso fino ai primi 10 caratteri. I valori più lunghi vengono comunque indicizzati, ma la coda non è raggiungibile tramite un prefisso.
Aggiornamento dello schema e reindicizzazione
L'impostazione dei campi come saytCompatible richiede un aggiornamento dello schema e la successiva reindicizzazione dei dati nel datastore. L'aggiornamento dello schema richiede ore e non esiste un indicatore affidabile per sapere quando l'indicizzazione è stata completata, quindi devi sovrastimare il tempo di indicizzazione.
Aggiorna lo schema per la ricerca durante la digitazione
Per contrassegnare i campi come saytCompatible utilizzando il metodo projects.locations.dataStores.schemas.patch, segui questi passaggi:
Se non hai ancora lo schema, segui le istruzioni per ottenerlo in Visualizza una definizione di schema.
Segui le istruzioni per aggiornare lo schema in modo programmatico. Imposta
saytCompatiblesutruenei campi che vuoi attivare per la funzionalità, come in questo esempio:"title": { "type": "string", "retrievable": true, "saytCompatible": true }, "channel_name": { "type": "string", "retrievable": true, "saytCompatible": true },In questo esempio, i campi
titleechannel_namesono contrassegnati comesaytCompatible. Se impostisaytCompatiblesu un campo il cui tipo non èstring, l'API restituisce un erroreINVALID_ARGUMENT, così come se lo imposti su più di tre campi nello schema.Attendi il completamento della reindicizzazione.
Invia una richiesta di ricerca durante la digitazione
Al termine della reindicizzazione, attiva la ricerca durante la digitazione per ogni richiesta di ricerca inviando una richiesta di ricerca il cui corpo includa searchAsYouTypeSpec.
I campi contrassegnati come saytCompatible nello schema vengono consultati solo quando searchAsYouTypeSpec è impostato nella richiesta, in modo da poter mantenere la stessa configurazione di pubblicazione per le query parziali e complete.
Per inviare una richiesta di ricerca durante la digitazione:
Chiama il metodo di ricerca nella configurazione di pubblicazione, come descritto in Ottieni i risultati di ricerca.
Nel corpo della richiesta, imposta
searchAsYouTypeSpec.conditionsuENABLED. In questo modo, viene attivata la ricerca durante la digitazione nella richiesta.(Facoltativo) Nella stessa
searchAsYouTypeSpec, restringi la ricerca istantanea a un sottoinsieme dei campisaytCompatibledello schema, assegna a ogni campo un peso relativo e imposta una soglia di punteggio minima al di sotto della quale i documenti vengono eliminati. Ogni valore in questo blocco è facoltativo. Se omesso, vengono applicati i valori predefiniti.fields[i].key: un campo dello schema contrassegnato comesaytCompatible. Se fai riferimento a un campo che non èsaytCompatible, non viene restituito alcun contributo di ricerca istantanea da quel campo.fields[i].weight: l'importanza relativa del campo nel punteggio di ricerca durante la digitazione. Il valore predefinito è1.0.scoreThreshold: i documenti il cui punteggio di ricerca istantanea è inferiore a questo valore vengono esclusi. Per impostazione predefinita, non è prevista alcuna soglia.
Invia la richiesta. L'esempio seguente mostra la forma di un
searchAsYouTypeSpecche attiva la ricerca durante la digitazione, la limita a due campi con pesi diversi e imposta un punteggio minimo:"searchAsYouTypeSpec": { "condition": "ENABLED", "fields": [ { "key": "title", "weight": 1.2 }, { "key": "channel_name" } ], "scoreThreshold": 0.5 }
Dettagli sulla ricerca durante la digitazione
La ricerca istantanea in Ricerca agente consente agli utenti di ricevere documenti classificati a ogni pressione di un tasto nei campi contrassegnati come saytCompatible nello schema.
Logica di normalizzazione e tokenizzazione
Agent Search normalizza e tokenizza sia il valore del campo (durante l'indicizzazione) sia il testo della query (durante la ricerca):
Conversione in minuscolo: Agent Search converte i caratteri in minuscolo. In questo modo, la corrispondenza non distingue tra maiuscole e minuscole.
Tokenizzazione: la ricerca dell'agente suddivide la stringa in singoli token (parole) utilizzando spazi e punteggiatura comune come delimitatori, in modo da corrispondere al comportamento utilizzato per la corrispondenza parziale.
Limiti per campo: solo i primi 12 token del valore del campo vengono indicizzati per la ricerca istantanea; ognuno di questi token contribuisce con frammenti di prefisso fino ai primi 10 caratteri.
Esempio
Se il campo actor_name è contrassegnato come saytCompatible e un documento ha il valore Christian Bale, una query di chr raggiunge il documento tramite il frammento di prefisso di lunghezza 3 del token christian ed estendendo la query a chris corrisponde comunque tramite il frammento di prefisso di lunghezza 5. Anche una query di bale corrisponde, tramite il frammento di prefisso di lunghezza 4 del secondo token nel valore del campo. Aggiornamenti del ranking in tempo reale a ogni pressione di un tasto durante la digitazione dell'utente.