Creare un'app di ricerca sanitaria

Per cercare dati clinici in Vertex AI Search, puoi seguire uno di questi workflow:

  • Crea un datastore sanitario, importa i dati FHIR R4 nel datastore, connettilo a un'app di ricerca sanitaria ed esegui query sui dati clinici. Per saperne di più, consulta Creare un datastore sanitario.
  • Crea un'app di ricerca dei dati sanitari, crea un datastore sanitari e importa i dati FHIR R4 nelldatastore#39;archivio durante il processo di creazione dell'app ed esegui query sui dati clinici.

Questa pagina descrive il secondo metodo.

Informazioni sulla frequenza di importazione dei dati

Puoi importare i dati FHIR R4 in un datastore nei seguenti modi:

  • Importazione batch: un'importazione una tantum. I dati vengono importati in un datastore in batch. Per ulteriori importazioni incrementali, vedi Aggiornare i dati sanitari.

  • Importazione streaming: un'importazione di dati streaming quasi in tempo reale. Eventuali modifiche incrementali nell'archivio FHIR di origine vengono sincronizzate nel datastore Vertex AI Search. Lo streaming richiede un connettore dati, che è un tipo di datastore. Per creare un connettore dati, devi configurare una raccolta. Un connettore dati contiene un'entità, che è anche un'istanza di datastore.

    Puoi anche mettere in pausa e riprendere lo streaming ed eseguire la sincronizzazione manuale ogni volta che è necessario. Per saperne di più, vedi Gestire un archivio di dati di ricerca sanitaria.

    La velocità di streaming dei dati per un determinato progetto Google Cloud dipende dalle seguenti quote. Se superi la quota, potresti riscontrare ritardi nello streaming.

    • Il numero di scritture in streaming FHIR o BigQuery in attesa al minuto. Per ulteriori informazioni, consulta Quote e limiti.
    • Il numero di operazioni di lettura FHIR al minuto per regione. Per saperne di più, consulta Quote FHIR dell'API Cloud Healthcare.

Puoi selezionare la frequenza di importazione dei dati al momento della creazione del datastore e non puoi modificare questa configurazione in un secondo momento.

Prima di iniziare

Prima di creare l'app di ricerca sanitaria, tieni presente quanto segue:

  • La relazione tra app e datastore per la ricerca dei dati sanitari. Per ulteriori informazioni, vedi Informazioni su app e datastore.

  • La preparazione dei dati FHIR per l'importazione.

  • Vertex AI Search for Healthcare fornisce servizi di ricerca solo nella multiregione Stati Uniti (us). Pertanto, l'app di ricerca per il settore sanitario e i datastore devono risiedere nella multiregione us.

  • Se importi dati sanitari da un archivio FHIR dell'API Cloud Healthcare in un progetto Google Cloud a un datastore di Vertex AI Search in un progetto Google Cloud diverso e utilizzi Controlli di servizio VPC, i due progetti devono trovarsi nello stesso perimetro.

Crea un'app

Puoi creare un'app di ricerca per il settore sanitario nella console Google Cloud o utilizzando l'API. Per creare un'app di ricerca sanitaria, segui questi passaggi:

Console

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

    Applicazioni di AI

  2. Nella pagina App, fai clic su Nuova app.

  3. Nella pagina Crea app, fai clic su Crea in Ricerca sanitaria.

  4. Nel riquadro Configurazione dell'app di ricerca, seleziona Sanità.

  5. Per attivare le funzionalità LLM avanzate per questa app, fai clic sul pulsante di attivazione/disattivazione Funzionalità LLM avanzate.

    Attiva le funzionalità LLM avanzate per ottenere riepiloghi della ricerca, ovvero brevi riassunti dei primi risultati di ricerca.

    Quando attivi le funzionalità LLM, potrebbero essere necessari fino a 5 minuti prima che le funzionalità supportate diventino disponibili.

  6. Nel campo Nome app, inserisci un nome per l'app.

  7. Nel campo Nome esterno della tua azienda o organizzazione, inserisci il nome comune della tua azienda o organizzazione. Non è necessario includere suffissi come Inc. o LLC. Questo campo è utile per il LLM per identificare l'azienda rappresentata dall'app.

  8. Nella sezione Access Transparency, seleziona Disabilita le metriche di ricerca per questa app per disattivare la registrazione delle metriche per l'app corrente. Questa impostazione non può essere modificata dopo la creazione dell'app.

  9. Fai clic su Continua.

  10. Per connetterti a un datastore, nella pagina Datastore, esegui una delle seguenti operazioni:

    • Seleziona un datastore sanitario esistente per l'importazione batch o un connettore dati esistente per l'importazione in streaming. Per creare un datastore o un connettore di dati prima di creare un'app, consulta Creare un datastore sanitario.
    • Crea un datastore (per l'importazione batch una tantum) o un connettore dati, che è un'istanza di un datastore (per l'importazione in streaming):
      1. Fai clic su Crea datastore.
      2. Nel riquadro Seleziona un'origine dati, scegli API Healthcare (FHIR) come origine dati.
      3. Per importare i dati dal datastore FHIR, esegui una delle seguenti operazioni:
        • Seleziona l'archivio FHIR dall'elenco degli archivi FHIR disponibili:
          1. Espandi il campo Datastore FHIR.
          2. In questo elenco, seleziona un set di dati che si trova in una posizione consentita e poi seleziona un archivio FHIR che utilizza la versione R4 di FHIR.
        • Inserisci manualmente l'archivio FHIR:
          1. Espandi il campo Datastore FHIR.
          2. Fai clic su Inserisci manualmente l'archivio FHIR.
          3. Nella finestra di dialogo Nome archivio FHIR, inserisci il nome completo dell'archivio FHIR nel seguente formato:

            project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

          4. Fai clic su Salva.
      4. Nella sezione Sincronizzazione, seleziona una delle seguenti opzioni. Questa selezione non può essere modificata dopo la creazione del datastore.
        • Una tantum: per eseguire un'importazione batch di dati una tantum. Per ulteriori importazioni incrementali, vedi Aggiornare i dati sanitari.
        • Streaming: per eseguire un'importazione di dati in streaming quasi in tempo reale. Per trasmettere dati in streaming, devi creare un connettore dati, che è un tipo di datastore. Per configurare un datastore di streaming utilizzando l'API REST, contatta il tuo Customer Engineer.
      5. Nella sezione Qual è lo schema per questi dati?, seleziona una di queste opzioni:
        • Schema predefinito di Google: per conservare le configurazioni dello schema definito da Google, ad esempio indicizzazione, possibilità di ricerca e recupero, per le risorse e gli elementi FHIR supportati. Dopo aver selezionato questa opzione, non puoi aggiornare lo schema dopo aver creato il datastore. Se vuoi poter modificare lo schema dopo la creazione del datastore, seleziona l'opzione Schema personalizzato.
          1. Fai clic su Continua.
          2. Nel campo Nome del tuo datastore, inserisci un nome per il datastore.
          3. Fai clic su Crea.

            4. Il datastore che hai creato è elencato nella pagina Datastore.

        • Schema personalizzato: per definire le tue configurazioni dello schema, ad esempio indicizzazione, possibilità di ricerca e recupero, per le risorse e gli elementi FHIR supportati. Per configurare uno schema configurabile, contatta il tuo Customer Engineer.
          1. Fai clic su Continua.
          2. Esamina lo schema, espandi ogni campo e modifica le impostazioni del campo.
          3. Fai clic su Aggiungi nuovi campi per aggiungere nuovi campi alle risorse FHIR supportate. Non puoi rimuovere i campi forniti nello schema definito da Google.
          4. Fai clic su Continua.
          5. Nel campo Nome del connettore dati, inserisci un nome per il connettore dati.
          6. Fai clic su Crea.

            7. Il connettore dati che hai creato è elencato nella pagina Datastore. L'archivio FHIR di origine viene aggiunto come entità all'interno del connettore dati.

      6. Fai clic su Continua.
      7. Seleziona il datastore o il connettore dati creato.

  11. (Facoltativo) Per visualizzare un elenco di datastore non disponibili, fai clic su Scopri perché.

    Viene visualizzata una tabella con un elenco di datastore e il motivo per cui non sono disponibili. Ecco alcuni motivi per cui un datastore potrebbe non essere disponibile:

    • Il tipo di datastore consente la connessione a una sola app e il datastore è già connesso.
    • Il datastore e l'app sono di tipi diversi. Ad esempio, non puoi collegare un datastore di ricerca di siti web a un'app di ricerca sanitaria.

  12. Fai clic su Crea.

    Se l'app e il relativo datastore vengono creati correttamente, la pagina dei dettagli del datastore mostra i dettagli dei dati FHIR importati.

REST

  1. Crea un datastore sanitario e importa i dati sanitari.

  2. Crea un'app di ricerca dei dati sanitari e connettila a un datastore. Un'app di ricerca dei dati sanitari può connettersi a un solo datastore, mentre un determinato datastore può essere connesso a più app.

    curl -X POST\
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
"https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines?engineId=APP_ID" \
 -d '{
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds":"DATA_STORE_ID",
    "industryVertical": "HEALTHCARE_FHIR",
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": ["SEARCH_ADD_ON"]
    }
}'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo Google Cloud progetto.
    • APP_ID: l'ID dell'app Vertex AI Search che vuoi creare.
    • APP_DISPLAY_NAME: il nome visualizzato dell'app Vertex AI Search che vuoi creare.
    • DATA_STORE_ID: l'ID di un datastore Vertex AI Search esistente che vuoi aggiungere all'app Vertex AI Search.
    • SEARCH_ADD_ON: un campo facoltativo per specificare se vuoi le funzionalità LLM avanzate, come la ricerca con risposte dell'AI generativa, per questa app. Per attivare le funzionalità LLM avanzate, inserisci il valore SEARCH_ADD_ON_LLM. Se non vuoi le funzionalità LLM avanzate, specifica SEARCH_ADD_ON_UNSPECIFIED o rimuovi il campo searchAddOns. Per saperne di più, consulta Funzionalità LLM avanzate.

Verificare la creazione dell'app

Questa attività mostra come verificare se un'app di ricerca dei dati sanitari è stata creata correttamente e se i dati FHIR sono stati importati correttamente nel datastore.

  • Nella console Google Cloud : seleziona l'app e verifica i relativi dettagli.
  • Tramite l'API REST, utilizza il metodo engines.get per ottenere i dettagli del datastore sanitario.

Per verificare la creazione del datastore e l'importazione dei dati, completa i seguenti passaggi.

Console

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

    Applicazioni di AI

  2. Nella pagina App, verifica se l'app che hai creato è presente nell'elenco delle app.

  3. Verifica che il datastore a cui ti sei connesso all'app sia elencato nella tabella Datastore connessi.

  4. Seleziona il datastore e verifica i dettagli del datastore.

REST

  1. Verifica la creazione dell'app.

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
 "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo Google Cloud progetto.
    • APP_ID: l'ID dell'app Vertex AI Search.

  2. Verifica la creazione del datastore e l'importazione dei dati FHIR.

Passaggi successivi