Informazioni su app e datastore

Questa pagina descrive le app e i datastore di Agent Search.

Con Agent Search, crei un'app di ricerca o di suggerimenti e la colleghi a un datastore. Un progetto Google Cloud può contenere più app.

Relazione tra app e datastore

La relazione tra app e datastore dipende dal tipo di app:

  • Le app di ricerca personalizzata hanno una relazione molti-a-molti con i datastore. Quando più datastore sono collegati a una singola app di ricerca personalizzata, si parla di ricerca combinata. Per informazioni sulle limitazioni del collegamento di un'app di ricerca a più datastore, consulta Informazioni sulla ricerca combinata.

  • Un'app di suggerimenti personalizzati ha una connessione uno a uno con il proprio datastore.

  • Un'app multimediale ha una relazione many-to-one con il proprio datastore. Un'app può connettersi a un solo datastore, mentre un determinato datastore può essere connesso a più app. Ad esempio, un'app di ricerca per contenuti multimediali e un'app di suggerimenti sui contenuti multimediali possono condividere un datastore.

  • Un'app di ricerca dei dati sanitari ha una relazione molti-a-uno con il suo datastore. Un'app può connettersi a un solo datastore, mentre un determinato datastore può essere connesso a più app. Ad esempio, un'app per i pazienti e un'app per i fornitori possono connettersi allo stesso datastore.

    Per un'importazione dati in batch di dati sanitari, i dati vengono importati in un datastore all'interno di un'app. Per l'importazione dati in modalità flusso (anteprima) di dati sanitari, i dati vengono importati in un'entità, che è un tipo di datastore all'interno di un connettore dati. Un connettore dati è anche un tipo di datastore all'interno di un'app.

Una volta collegato a un'app, un datastore non può essere scollegato.

Metodo di creazione dell'app e di importazione dati

La modalità di creazione di un'app e di importazione dei dati dipende dal tipo di dati di cui disponi:

  • Per i dati del sito web, puoi utilizzare la console Google Cloud o l'API. Per utilizzare i dati di un sito web creati con l'API, devi collegarli a un'app con le funzionalità Enterprise attivate nella console Google Cloud .

  • Per i dati strutturati o non strutturati, puoi utilizzare la consoleGoogle Cloud o l'API.

  • Per i dati sanitari, puoi utilizzare la console Google Cloud o l'API.

Documenti

Ogni datastore ha uno o più record di dati, chiamati documenti. Ciò che rappresenta un documento varia a seconda del tipo di dati nel datastore:

  • Sito web. Un documento è una pagina web.

  • Dati strutturati. Un documento è una riga di una tabella o un record JSON che segue uno schema specifico. Puoi fornire questo schema tu stesso o lasciare che Agent Search lo ricavi dai dati importati.

  • Dati strutturati per i contenuti multimediali. Un documento è una riga di una tabella o un record JSON che segue uno schema specifico per i contenuti multimediali. I documenti sono record relativi a contenuti multimediali, come video, articoli, file musicali e podcast. Un documento contiene informazioni che descrivono l'elemento multimediale, almeno: titolo, URI della posizione dei contenuti, categorie, durata e data di disponibilità.

  • Dati non strutturati. Un documento è un file in uno dei seguenti formati: TXT, PDF, HTML, DOCX, PPTX, XLSX e XLSM.

  • Dati FHIR sanitari. Un documento è una risorsa FHIR R4 supportata. Per un elenco delle risorse FHIR R4 supportate dalla ricerca dell'agente, consulta il riferimento allo schema dei dati FHIR R4 di Healthcare.

Operazioni CRUD sui datastore

Per i datastore strutturati e non strutturati, la ricerca dell'agente supporta le operazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD) sui dati dei documenti. Non è necessario eliminare o ricreare un intero datastore per aggiornare i contenuti; puoi gestire i singoli record durante il loro ciclo di vita.

Puoi gestire singoli documenti o record in un datastore utilizzando l'API:

  • Crea: aggiungi singoli documenti a un ramo del datastore utilizzando il metodo documents.create.
  • Lettura (Get e List): recupera un documento specifico in base al suo ID utilizzando il metodo documents.get o elenca i documenti in un ramo utilizzando il metodo documents.list.
  • Aggiornamento: modifica i campi, i contenuti o i metadati dei documenti esistenti utilizzando il metodo documents.patch. Puoi anche eseguire un upsert (inserimento se non trovato) impostando il campo allowMissing su true.
  • Eliminazione selettiva: elimina selettivamente i singoli record utilizzando il metodo documents.delete, anziché eliminare l'intero datastore.

Datastore e app

In Agent Search esistono vari tipi di datastore. Un datastore può contenere un solo tipo di dati.

Dati sui siti web

Un datastore con dati di siti web utilizza i dati indicizzati dai siti web pubblici. Puoi fornire un insieme di pattern URL da includere nel datastore. Le pagine web che corrispondono ai pattern URL sono chiamate pagine web incluse. Puoi quindi configurare la ricerca sui dati sottoposti a scansione dalle pagine web incluse.

Ad esempio, puoi fornire pattern URL come example.com/faq/* e example.com/events/* e attivare la ricerca sui dati sottoposti a scansione da queste pagine web che corrispondono al pattern. Questi dati includono testo, immagini taggate con metadati e altri dati strutturati, come tag meta, attributi PageMap e dati schema.org.

Puoi anche fornire pattern URL per parti di siti web che vuoi escludere, ad esempio example.com/events/members-only/* o example.com/events/past-*. Gli URL esclusi hanno la priorità su quelli inclusi.

Esistono due tipi di datastore di siti web:

  • Ricerca di base su sito web:

    • Fornisce funzionalità di ricerca nell'indice della Ricerca Google esistente per i siti web inclusi.
    • Non richiede la verifica del dominio.

  • Indicizzazione avanzata dei siti web:

    • Fornisce funzionalità di ricerca avanzate su un indice generato in base a uno dei seguenti elementi:
      • I proprietari dell'app Agent Search possono controllare quali pagine web vengono indicizzate inviando e gestendo le Sitemap. Per saperne di più, consulta Indicizza e aggiorna le pagine web utilizzando le Sitemap. Questo processo mantiene l'indice aggiornato senza intervento manuale.
      • I proprietari dell'app Agent Search possono eseguire un'indicizzazione iniziale che rispecchia l'indice della Ricerca Google e poi espandere la copertura dell'indice eseguendo nuovamente la scansione dei siti web ogni volta che è necessario, mantenendolo aggiornato. Per saperne di più, consulta Aggiorna le pagine web. Le funzionalità avanzate dell'indicizzazione avanzata dei siti web sono elencate in Indicizzazione avanzata dei siti web.
    • Richiede ai proprietari dei datastore di Agent Search di verificare i domini a cui appartengono i siti web inclusi. Per saperne di più, consulta Verifica i domini dei siti web.
    • Consente di aggiungere dati strutturati allo schema del datastore. Un sito web contiene dati non strutturati, ma puoi aggiungere dati strutturati sotto forma di tag meta, attributi PageMap e dati schema.org alle tue pagine web. Puoi quindi utilizzare questi dati strutturati per modificare lo schema del datastore, come spiegato in Utilizza i dati strutturati per l'indicizzazione avanzata del sito web.

Passaggi successivi

Per la ricerca nel sito web:

Dati strutturati

Un datastore con dati strutturati consente la ricerca semantica o i suggerimenti su dati strutturati. Puoi importare dati da BigQuery o Cloud Storage. Puoi anche caricare manualmente i dati JSON strutturati tramite l'API.

Ad esempio, puoi attivare la ricerca o i suggerimenti su un catalogo dei prodotti per la tua esperienza di e-commerce o su un elenco di medici per la ricerca o i suggerimenti di fornitori.

Agent Search rileva automaticamente lo schema dai dati che importi. Facoltativamente, puoi fornire uno schema per i dati. In genere, fornire uno schema per i dati migliora la qualità dei risultati.

Passaggi successivi

Per la ricerca personalizzata:

Per i consigli personalizzati:

Dati strutturati per i contenuti multimediali

Le app multimediali possono essere collegate solo a datastore di contenuti multimediali. I datastore di contenuti multimediali sono datastore di dati strutturati con uno schema definito da Google o con il tuo schema personalizzato che contiene un insieme specifico di cinque campi relativi ai contenuti multimediali. Per ulteriori informazioni sullo schema, consulta Informazioni sui documenti multimediali e sui datastore.

Ad esempio, puoi attivare i suggerimenti creando un'app di suggerimenti sui contenuti multimediali per un catalogo di film o un sito nella nuova versione di Sites, in modo che i tuoi utenti ricevano suggerimenti adatti e personalizzati.

Oltre ai documenti multimediali, i datastore multimediali contengono anche le informazioni sugli eventi utente che consentono ad Agent Search di personalizzare i suggerimenti e la ricerca per i tuoi utenti. Gli eventi utente sono obbligatori per le app multimediali. Per informazioni sugli eventi utente, consulta Registra gli eventi utente in tempo reale.

Passaggi successivi

Dati non strutturati

Un datastore di dati non strutturati consente la ricerca semantica su dati come documenti e immagini.

I datastore non strutturati supportano documenti nei formati TXT, PDF, HTML, DOCX, PPTX, XLSX e XLSM.

La Ricerca fornisce risultati sotto forma di 10 URL e risposte riepilogative per le query in linguaggio naturale. I documenti devono essere caricati in un bucket Cloud Storage con le autorizzazioni di accesso appropriate. Ad esempio, un istituto finanziario può abilitare la ricerca nel proprio corpus privato di pubblicazioni di ricerca finanziaria, oppure un'azienda di biotecnologie può abilitare la ricerca o i suggerimenti nel proprio repository privato di ricerca medica.

Passaggi successivi

Per la ricerca:

Dati FHIR Healthcare

Un'app di ricerca sanitaria utilizza i dati FHIR R4 importati da un archivio FHIR dell'API Cloud Healthcare. Per un elenco delle risorse FHIR R4 supportate da Agent Search, consulta Riferimento allo schema dei dati FHIR R4 per l'assistenza sanitaria. Un datastore FHIR R4 deve soddisfare alcuni requisiti prima di poter essere utilizzato come origine dati per il datastore della Ricerca agente. Per saperne di più, consulta come preparare i dati FHIR sanitari per l'importazione.

Passaggi successivi

Informazioni sulla ricerca combinata

Puoi creare un'app di ricerca combinata, in cui più datastore possono essere collegati a una singola app di ricerca personalizzata. Questa funzionalità ti consente di utilizzare un'unica app per eseguire ricerche in più origini e tipi di dati.

Per creare un'app di ricerca combinata, seleziona più datastore durante la creazione di una nuova app di ricerca personalizzata. Se non selezioni più datastore durante la creazione, non potrai aggiungerne altri in un secondo momento.

Quando ottieni i risultati di ricerca, puoi eseguire la ricerca in tutti i datastore o filtrare i risultati di un singolo datastore.

Si applicano le seguenti limitazioni:

  • Aggiunta e rimozione di datastore:
    • Per attivare la ricerca combinata per un'app, devi collegare almeno due datastore all'app durante la creazione.
    • Puoi aggiungere o rimuovere datastore da un'app di ricerca combinata, ma l'app non può avere meno di due datastore collegati in qualsiasi momento.
    • Se colleghi un singolo datastore a un'app di ricerca durante la creazione dell'app, non puoi aggiungere o rimuovere il datastore.
  • Per poter essere utilizzati per la ricerca combinata, i datastore dei siti web devono avere l'indicizzazione avanzata dei siti web attivata. Per saperne di più, consulta l'indicizzazione avanzata dei siti web.
  • I datastore che contengono dati non strutturati importati utilizzando BigQuery non sono supportati.
  • La ricerca di immagini (utilizzando il campo params con searchType: 1) non è supportata.
  • La ricerca combinata consente i seguenti campi nelle richieste di ricerca:
    • boostSpec
    • contentSearchSpec
    • dataStoreSpecs
    • facetSpecs
    • filter
    • languageCode
    • offset
    • oneBoxPageSize
    • orderBy
    • query
    • pageSize
    • pageToken
    • relevanceScoreSpec
    • relevanceThreshold
    • session
    • sessionSpec
    • spellCorrectionSpec
    • userInfo
    • userPseudoId
  • La ricerca combinata consente i seguenti campi in DataStoreSpec:
    • dataStore
    • boostSpec: se sono specificate specifiche di boost sia per SearchRequest che per dataStoreSpecs, entrambe le specifiche di boost vengono applicate ai risultati di ricerca
    • filter: se sono specificati filtri sia per SearchRequest che per dataStoreSpecs, entrambi i filtri vengono applicati ai risultati di ricerca
  • Le operazioni di creazione, lettura, aggiornamento ed eliminazione (CRUD) sulle configurazioni di pubblicazione sono supportate per le app combinate. Solo i seguenti campi possono essere aggiunti o aggiornati in una configurazione di distribuzione:
    • boostControlIds
    • displayName
    • filterControlIds
    • genericConfig:
      • contentSearchSpec
    • name
    • solutionType
    • synonymsControlIds
  • Le operazioni CRUD sui seguenti controlli sono supportate per le app di ricerca combinata:
    • boostAction
    • synonymAction
    • filterAction
  • Esiste un limite di 50 datastore per app di ricerca.
  • Se un datastore utilizza una configurazione CMEK, anche tutti gli altri datastore devono utilizzare la stessa configurazione CMEK.