Creare un'app di ricerca nei dati sanitari

Per cercare dati clinici nella ricerca dell'agente, puoi seguire uno di questi flussi di lavoro:

  • Crea un datastore di dati sanitari, importa i dati FHIR R4 nel datastore, collegalo a un'app di ricerca di dati sanitari ed esegui query sui dati clinici. Per saperne di più, consulta Creare un datastore di dati sanitari.
  • Crea un'app di ricerca di dati sanitari, crea un datastore di dati sanitari e importa i dati FHIR R4 nel datastore durante la 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, consulta Aggiornare i dati sanitari.

  • Importazione streaming: un'importazione di dati in streaming quasi in tempo reale. Eventuali modifiche incrementali nell'archivio FHIR di origine vengono sincronizzate nel datastore della ricerca dell'agente. Lo streaming richiede un dati connettore, 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ù, consulta Gestire un datastore di ricerca di dati sanitari.

    La velocità di streaming dei dati per un dato Google Cloud progetto è dipendente 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 saperne di più, 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 di dati sanitari, tieni presente quanto segue:

  • La relazione tra app e datastore per la ricerca di dati sanitari. Per saperne di più, consulta Informazioni su app e datastore.

  • La preparazione dei dati FHIR per l'importazione.

  • La ricerca dell'agente per il settore sanitario fornisce servizi di ricerca solo nella regione multi-regionale degli Stati Uniti (us). Pertanto, l'app di ricerca di dati sanitari e i datastore devono risiedere nella regione multi-regionale us.

  • Se stai importando dati sanitari da un archivio FHIR dell'API Cloud Healthcare in un progetto Google Cloud a un datastore della ricerca dell'agente in un altro Google Cloud progetto e stai utilizzando i Controlli di servizio VPC, i due progetti devono trovarsi nello stesso perimetro.

Crea un'app

Puoi creare un'app di ricerca di dati sanitari nella Google Cloud console o utilizzando l' API. Per creare un'app di ricerca di dati sanitari:

Console

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

    AI Applications

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

  3. Nella pagina Crea app, fai clic su Crea in Ricerca di dati sanitari.

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

  5. Per attivare le risposte generative che utilizzano le funzionalità LLM avanzate per questa app, fai clic sul pulsante di attivazione/disattivazione Risposte generative per attivarlo.

    Quando attivi le risposte generative, potrebbero essere necessari fino a cinque 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 l'LLM per identificare l'azienda che l'app rappresenta.

  8. Nella sezione Access Transparency, seleziona Disabilita le metriche di ricerca per questa app per disattivare le metriche di logging 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 di dati sanitari esistente per l'importazione batch o un connettore dati esistente per l'importazione in streaming. Per creare un datastore o un connettore dati prima di creare un'app, consulta Creare un datastore di dati sanitari.
    • 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, seleziona API Healthcare (FHIR) come origine dati.
      3. Per importare i dati dall'archivio FHIR, esegui una delle seguenti operazioni:
        • Seleziona l'archivio FHIR dall'elenco degli archivi FHIR disponibili:
          1. Espandi il campo Archivio FHIR.
          2. In questo elenco, seleziona un set di dati che si trova in una località consentita e quindi seleziona un archivio FHIR che utilizza la versione R4 di FHIR.
        • Inserisci manualmente l'archivio FHIR:
          1. Espandi il campo Archivio 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, consulta Aggiornare i dati sanitari.
        • Streaming: per eseguire un'importazione di dati in streaming quasi in tempo reale. Per eseguire lo streaming dei dati, 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 definite da Google, come l'indicizzazione, la ricercabilità e la recuperabilità, 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, come l'indicizzazione, la ricercabilità e la recuperabilità, 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 dei campi.
          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 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 dei 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 connettere un datastore di ricerca di siti web a un'app di ricerca di dati sanitari.

  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 di dati sanitari e importa i dati sanitari.

  2. Crea un'app di ricerca di dati sanitari e collegala a un datastore. Un'app di ricerca di dati sanitari può connettersi a un solo datastore, mentre un dato 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 di ricerca dell'agente che vuoi creare.
    • APP_DISPLAY_NAME: il nome visualizzato dell'app di ricerca dell'agente che vuoi creare.
    • DATA_STORE_ID: l'ID di un datastore della ricerca dell'agente esistente che vuoi aggiungere all'app di ricerca dell'agente.
    • SEARCH_ADD_ON: un campo facoltativo per specificare se vuoi le funzionalità LLM avanzate, come la ricerca con risposte di 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 searchAddOns campo. Per saperne di più, consulta Funzionalità LLM avanzate.

Verificare la creazione dell'app

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

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

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.

    AI Applications

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

  3. Verifica che il datastore che hai collegato all'app sia elencato nella tabella Datastore collegati.

  4. Seleziona il datastore e verifica i relativi dettagli.

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 di ricerca dell'agente.

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

Passaggi successivi