Creare un'app di ricerca sanitaria

Nella console Google Cloud, vai alla pagina Agent Builder.

Agent Builder

Nella pagina App, fai clic su add_box Nuova app.

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

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

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.

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

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.

Fai clic su Continua.

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 add_box 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 Vertex AI Search di destinazione.

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

       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.

       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.

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

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.

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.

{
  "name": "projects/PROJECT_ID/locations/us/collections/default_collection/operations/APP_CREATION_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.Engine",
    "name": "projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID",
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds": [
      "DATA_STORE_ID"
    ],
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": [
        "SEARCH_ADD_ON_LLM"
      ]
    },
    "industryVertical": "HEALTHCARE_FHIR"
  }
}

Nella console Google Cloud, vai alla pagina Agent Builder.

Agent Builder

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

Verifica che il data store collegato all'app sia elencato nella colonna Datastore connessi.

Seleziona il datastore e verifica i dettagli del datastore.

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.

{
  "name": "projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID",
  "displayName": "APP_DISPLAY_NAME",
  "createTime": "APP_CREATION_TIMESTAMP",
  "dataStoreIds": [
    "DATA_STORE_ID"
  ],
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
    "searchTier": "SEARCH_TIER_STANDARD",
    "searchAddOns": [
      "SEARCH_ADD_ON_LLM"
    ]
  },
  "industryVertical": "HEALTHCARE_FHIR",
  "dataStores": [
    "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/APP_ID"
  ]
}

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