Configura impostazioni dei campi

Questa pagina spiega 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 la Ricerca dell'agente utilizza i campi nei risultati. Puoi utilizzare la scheda Schema nella Google Cloud console per configurare le impostazioni dei campi.

La configurazione delle impostazioni dei campi è disponibile solo per le app con datastore contenenti dati strutturati o dati non strutturati con metadati.

Impostazioni del campo

Le seguenti impostazioni dei campi sono disponibili per molti tipi di campi nei dati di ricerca o di consigli, ma non per tutti i tipi di dati. Uno schema contiene più impostazioni dei campi per i singoli campi e la tabella seguente contiene le impostazioni che possono essere applicate a un campo all'interno di uno schema. L'utilizzo di dati strutturati è vivamente consigliato per queste impostazioni dei campi:

Impostazione	Definizione	Finalità	Esempio di caso d'uso
Indicizzabile	L'impostazione dei campi come indicizzabili consente operazioni come il filtraggio, l'aumento e la suddivisione in facet sui campi strutturati all'interno di un documento. I campi di tipo Object non possono essere impostati su Indexable.	Se contrassegni un campo come Indexable, le ricerche saranno più rapide. Tieni presente che se contrassegni un campo come Indexable, le dimensioni dell' indice di ricerca aumentano e l'indicizzazione può rallentare.	In un datastore di hotel, puoi impostare un campo, ad esempio hotel_chain, come indicizzabile. In questo modo puoi applicare operazioni di ranking, filtraggio e aumento a hotel_chain. Ad esempio, puoi applicare un filtro in modo che la ricerca restituisca solo i risultati di ricerca contenenti la catena alberghiera filtrata.
Ricercabile	I campi che hanno maggiori probabilità di essere correlati alle ricerche sono designati come Searchable. Un campo può essere ricercabile senza essere indicizzabile o recuperabile. Solo i campi con valori di testo possono essere contrassegnati come ricercabili. Pertanto, un campo numerico del prezzo può essere indicizzabile (per il filtraggio o la suddivisione in facet), ma non può essere ricercabile come testo completo.	Se imposti un campo su Ricercabile , il richiamo di questo campo nelle query di ricerca viene migliorato, consentendo agli utenti di trovare contenuti, ad esempio pagine web, eseguendo query sul testo all'interno di questi campi. Se contrassegni un campo come ricercabile, puoi applicare il ranking. Di conseguenza, se contrassegni un numero eccessivo di campi come ricercabili, la precisione della ricerca può risentirne negativamente, in quanto l'algoritmo di ranking viene saturato e vengono restituiti troppi risultati. Questo può portare a risultati di ricerca non pertinenti. Puoi applicare una ponderazione relativa ai campi ricercabili; tuttavia, a causa delle impostazioni predefinite robuste, questo è raramente necessario. Vedi Ponderare i campi ricercabili di seguito.	Il sistema di ticket di assistenza di un fornitore di servizi internet memorizza ogni ticket come documento strutturato. Se questi documenti contengono campi di testo ricercabili, ad esempio issue_description o resolution_notes, un agente di assistenza può eseguire una query relativa ai contenuti di questi campi, ad esempio come risolvere i problemi di velocità di internet dopo la reimpostazione del modem. Il sistema visualizzerà quindi i documenti che contengono uno di questi termini di ricerca, inclusi modem, internet, velocità, in uno o entrambi i campi issue_description o resolution_notes campi.
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 (facet) 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 Suddivisione in facet dinamica 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, ad esempio le norme 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 mostrare i facet per Department: Finance, Travel, Document Type: Policy, Domande frequenti o Last Modified Date: This Quarter, Last Year.
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 devono essere mostrati all'utente finale.	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, 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 di query di ricerca. Per scoprire 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 gli utenti a trovare contenuti pertinenti e accelera il processo di ricerca. Alcuni fattori, come l'utilizzo del filtro in linguaggio naturale possono influire su queste prestazioni.	Se il completable campo è impostato per product_name, brand, e category, quando l'utente digita Tech, i suggerimenti di completamento automatico possono mostrare: TechCo (dal campo brand) TechCo UltraBook X1 (dal campo product_name ) Tecnologia GameMaster Pro (un altro prodotto dal campo category)
Filtrabile	Consente ai consigli di utilizzare un campo per filtrare i risultati consigliati, determinando quali risultati di ricerca vedono gli utenti. Per informazioni sul filtraggio dei consigli, vedi Filtra i consigli.	Se imposti un campo su Filterable, puoi personalizzare i consigli per gli utenti. Tieni presente che si applicano limiti di filtraggio.	Un'impostazione di filtro per lingua e genere drammatico potrebbe essere simile a: language_code: ANY("en", "fr") OR categories: ANY("drama").

Differenze tra le impostazioni di uso comune

Esistono differenze fondamentali tra le impostazioni dei campi indicizzabili, ricercabili e recuperabili. La tabella riassume queste differenze.

Funzionalità	Indicizzabile	Ricercabile	Recuperabile
Ruolo principale	Rende i contenuti dei campi disponibili per il motore di ricerca	Consente di eseguire query di testo completo 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 eseguita 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
...Filtrabile/Ordinabile/Suddivisibile in facet?	Sì (in genere anche un prerequisito 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 ed eseguita la query, non solo visualizzato.

In pratica, molti campi fondamentali per l'esperienza utente (come titoli, descrizioni e informazioni identificative) sono spesso impostati su indexable, searchable e retrievable.

Nota: la terminologia e il comportamento esatti possono a volte variare leggermente tra le diverse tecnologie dei motori di ricerca (come Elasticsearch, Apache Solr, Azure AI Search, Google Cloud Search), ma i concetti di base rimangono in gran parte gli stessi.

Limitazioni

Le impostazioni dei campi presentano le seguenti limitazioni:

• Puoi configurare fino a 50 campi come indicizzabili, ricercabili, recuperabili o con suddivisione in facet dinamica.
• Per configurare un campo come suddivisione in facet dinamica, devi prima configurarlo 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, vedi Informazioni sui documenti e sui datastore multimediali.

Aggiornare le impostazioni dei campi

Per aggiornare le impostazioni dei campi:

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

   AI Applications

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

3. Fai clic su Dati.

4. Fai clic sulla scheda Schema. Questa scheda mostra le impostazioni dei campi correnti.

   Non vedrai la scheda Schema se il datastore contiene dati di base del sito web o dati non strutturati senza metadati.

5. Fai clic su Modifica.

6. 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.

7. Fai clic su Salva per applicare le modifiche.

Ponderare i campi ricercabili (anteprima)

Anteprima

Questa funzionalità è soggetta ai "Termini dell'offerta pre-GA" nella sezione dei Termini di servizio generali dei Termini specifici dei servizi. Le funzionalità pre-GA sono disponibili "così come sono" e potrebbero avere un supporto limitato. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Se contrassegni un campo come ricercabile, puoi specificare una ponderazione per indicarne l'importanza relativa nei risultati di ricerca. Nella maggior parte dei casi non è necessario specificare le ponderazioni per i singoli campi, perché le ponderazioni predefinite funzionano bene.

Tuttavia, la regolazione delle ponderazioni può essere necessaria in alcune situazioni, ad esempio:

• Stai eseguendo la migrazione dei dati da una piattaforma di ricerca esistente che utilizza già campi ponderati.

• Quando le ponderazioni predefinite non forniscono risultati di ricerca soddisfacenti. In particolare, questo può accadere quando hai molti campi ricercabili e alcuni sono notevolmente più importanti di altri.

  Forse, il riepilogo è il campo più importante per le ricerche, quindi vuoi dare la priorità a questo testo.

  Oppure, lo schema ha un campo contenente parole chiave altamente pertinenti che sono ottimi indicatori per i risultati di ricerca, ma, poiché questo campo è molto più breve di altri, la sua influenza è spesso oscurata da campi più lunghi. L'aumento della ponderazione garantisce l'impatto previsto.

Livelli di ponderazione

Le ponderazioni sono suddivise nei seguenti livelli:

Importanza del campo	Spiegazione
Molto bassa	Un valore basso che il sistema considera comunque quando combina i punteggi di tutti i campi. Se vuoi una ponderazione ancora inferiore in modo che l'effetto sia trascurabile, non contrassegnare il campo come ricercabile.
Bassa	Una ponderazione inferiore a quella predefinita.
Predefinita	La ponderazione standard per i campi ricercabili. Questa ponderazione offre prestazioni ragionevolmente buone nella maggior parte dei casi.
Alta	Una ponderazione notevolmente superiore a quella predefinita.
Molto alta	Una ponderazione dominante. In genere, questa ponderazione viene riservata a un solo campo.

Aggiornamento dello schema e reindicizzazione

L'aggiunta di ponderazioni ai campi ricercabili 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 che ti indichi quando l'indicizzazione è completata, quindi devi sovrastimare il tempo di indicizzazione.

Impostare 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 e rivedere attentamente i risultati di ricerca in un secondo momento per verificare eventuali conseguenze indesiderate. Dopo ogni modifica, devi attendere il completamento della reindicizzazione prima di poter valutare l'impatto della modifica.

Nota: non puoi applicare una ponderazione a un campo che è una proprietà chiave, ad esempio title o description. La Ricerca dell'agente applica già una ponderazione più elevata ai campi contrassegnati come proprietà chiave.

Puoi configurare la ponderazione dei campi di ricerca solo tramite l'API. Questa funzionalità non è disponibile nella Google Cloud console.

Per impostare le ponderazioni, devi aggiornare lo schema del datastore tramite il metodo API projects.locations.dataStores.schemas.patch.

1. Se non hai già lo schema segui le istruzioni per recuperarlo in Visualizzare una definizione dello schema.

2. Segui le istruzioni per aggiornare lo schema in modo programmatico. Aggiungi ponderazioni a uno o più campi ricercabili, 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 una ponderazione superiore al normale e il campo uri su una ponderazione inferiore. Se vuoi ripristinare il valore predefinito di una ponderazione, impostala su default.

   I valori consentiti per il parametro di ponderazione sono:

   • very_low
   • low
   • default
   • high
   • very_high

   Esempio di comando e risultato

   curl -X PATCH \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json" \
   "https://discoveryengine.googleapis.com/v1beta/projects/my-project-123/locations/global/collections/default_collection/dataStores/my-data-store/schemas/default_schema" \
   -d '{
   "structSchema": { "$schema": "https://json-schema.org/draft/2020-12/schema", "properties": { "amenities": { "items": { "completable": true, "dynamicFacetable": true, "indexable": true, "retrievable": true, "searchable": true, "type": "string", "weight": "high" }, "type": "array" }, "available_date": { "indexable": true, "retrievable": true, "type": "datetime" }, "id": { "dynamicFacetable": false, "indexable": true, "retrievable": true, "type": "number" }, "location": { "indexable": true, "retrievable": true, "type": "geolocation" }, "non_smoking": { "dynamicFacetable": true, "indexable": true, "type": "boolean" }, "price_per_night": { "indexable": true, "retrievable": true, "type": "number" }, "rating": { "dynamicFacetable": true, "indexable": true, "retrievable": true, "type": "number" }, "room_types": { "items": { "dynamicFacetable": true, "indexable": true, "retrievable": true, "searchable": true, "type": "string", "weight": "low" }, "type": "array" }, "title": { "keyPropertyMapping": "title", "retrievable": true, "type": "string" } }, "type": "object" }
   }'
   
   {
   "name": "projects/123456/locations/global/collections/default_collection/dataStores/my-data-store/schemas/default_schema/operations/update-schema-123456",
   "metadata": {
   "@type": "type.googleapis.com/google.cloud.discoveryengine.v1beta.UpdateSchemaMetadata"
   }
   }
   

   In questo esempio, al campo amentities viene assegnata una ponderazione superiore al normale e al campo room_types una ponderazione inferiore.

3. Attendi il completamento della reindicizzazione e testa il comportamento di ricerca.

Passaggi successivi

• Aggiornare uno schema per dati strutturati
• Configurare i risultati di ricerca
• Visualizzare l'anteprima dei risultati di ricerca