Creare un'app di ricerca sanitaria

Per cercare i dati clinici in Vertex AI Search, puoi seguire uno di questi flussi di lavoro:

  • Crea un datastore sanitario, importa i dati FHIR R4 nel datastore, collegalo a un'app di ricerca sanitaria ed esegui query sui dati clinici. Per ulteriori informazioni, consulta Creare un data store per la salute.
  • Crea un'app di ricerca sanitaria, un datastore sanitario e importa i dati FHIR R4 nel datastore durante la procedura di creazione dell'app, quindi 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 collettiva: un'importazione una tantum. I dati vengono importati in un datastore. Per altre importazioni incrementali, consulta Aggiornare i dati sanitari.

  • Importazione streaming (anteprima): un'importazione di dati in streaming quasi in tempo reale. Eventuali modifiche incrementali nell'archivio FHIR di origine vengono sincronizzate nell'datastore di Vertex AI Search. Lo streaming richiede un connettore dati, che è un tipo di datastore contenente un'entità. Un'entità è anche un'istanza di un datastore.

    La frequenza 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 attesa di streaming FHIR o BigQuery al minuto. Per ulteriori informazioni, consulta Quote e limiti.
    • Il numero di operazioni di lettura FHIR al minuto per regione. Per ulteriori informazioni, consulta le quote FHIR dell'API Cloud Healthcare.

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

L'importazione in streaming è disponibile per tutte le risorse supportate da Vertex AI Search. Per ulteriori informazioni, consulta la documentazione di riferimento dello schema di dati FHIR R4 per la salute.

Prima di iniziare

Prima di creare l'app di ricerca sanitaria, soddisfa i seguenti requisiti:

  • Comprendi la relazione tra app e datastore per la ricerca sanitaria. Per ulteriori informazioni, consulta Informazioni su app e datastore.

  • Prepara i dati FHIR per l'importazione.

  • Vertex AI Search per la sanità fornisce servizi di ricerca solo nella regione multipla degli Stati Uniti (us). Pertanto, l'app di ricerca sanitaria e i datastore devono trovarsi nella regione multipla us.

Crea un'app

Puoi creare un'app di ricerca sanitaria nella console Google Cloud o utilizzando l'API. I due approcci differiscono nel seguente modo:

  • Nella console Google Cloud: seleziona l'archivio FHIR di origine nell'API Cloud Healthcare e importa i dati FHIR nell'ambito della procedura di creazione dell'app di ricerca sanitaria. Per eseguire lo streaming dei dati FHIR (anteprima), l'archivio FHIR di origine deve essere nello stesso progetto Google Cloud dell'app Vertex AI Search di destinazione.
  • Tramite l'API REST: puoi importare i dati FHIR da un archivio FHIR dell'API Cloud Healthcare. Il datastore FHIR può trovarsi nello stesso progetto Google Cloud o in un altro.
    1. Utilizza il metodo dataStores.create per creare un datastore sanitario.
    2. Utilizza il metodo documents.import per specificare l'archivio FHIR nell'API Cloud Healthcare e importare i dati FHIR.
    3. Utilizza il metodo engines.create per creare l'app di ricerca sanitaria e specifica un datastore dei dati sanitari esistente.

Per creare un'app di ricerca sanitaria:

Console

  1. Nella console Google Cloud, vai alla pagina Agent Builder.

    Agent Builder

  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 i riepiloghi della ricerca, ovvero brevi riepiloghi dei risultati di ricerca principali.

    Quando attivi le funzionalità LLM, 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 consentire all'LLM di identificare la società rappresentata dall'app.

  8. Fai clic su Continua.

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

    • Seleziona un datastore sanitario esistente per l'importazione collettiva 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 sanitario.
    • Crea un datastore (per l'importazione collettiva 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 dal tuo archivio FHIR, svolgi 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.

            Per eseguire lo streaming dei dati FHIR (anteprima), l'archivio FHIR di origine deve essere nello stesso progetto Google Cloud del datastore di destinazione di Vertex AI Search.

        • 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 dell'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 collettiva dei dati una tantum. Per altre 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, ovvero un tipo di datastore. Questa è una funzionalità in anteprima. Per configurare un datastore in 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 mantenere le configurazioni dello schema definite da Google, ad esempio la indicizzazione, la ricerca e il recupero, per le risorse e gli elementi FHIR supportati. Una volta selezionata questa opzione, non puoi aggiornare lo schema dopo aver creato il datastore. Se vuoi essere in grado di modificare lo schema dopo la creazione del datastore, seleziona l'opzione Schema personalizzato (anteprima).
          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 (anteprima): per definire le tue configurazioni dello schema, ad esempio la indicizzazione, la ricerca e il recupero, per le risorse e gli elementi FHIR supportati. Questa è una funzionalità in anteprima. 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.
          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 di dati.

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

  10. (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 il collegamento a una sola app e il datastore è già collegato.
    • Il tuo datastore e la tua app sono di tipi diversi. Ad esempio, non puoi collegare un datastore di ricerca di un sito web a un'app di ricerca sanitaria.

  11. 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 sanitaria e collegala a un datastore. Un'app di ricerca sanitaria può collegarsi solo a un datastore, mentre un determinato datastore può essere collegato a diverse 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/v1alpha/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 progetto Google Cloud.
    • 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, ad esempio 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 campo searchAddOns. Per saperne di più, consulta Funzionalità LLM avanzate.

Verificare la creazione dell'app

Questa operazione mostra come verificare se un'app di ricerca sanitaria è stata creata correttamente e se i dati FHIR sono stati importati correttamente nell'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 e l'importazione dei dati del datastore, completa i seguenti passaggi.

Console

  1. Nella console Google Cloud, vai alla pagina Agent Builder.

    Agent Builder

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

  3. Verifica che il data store collegato all'app sia elencato nella colonna 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/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    Sostituisci quanto segue:

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

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

Passaggi successivi