Crea un datastore di ricerca sanitaria

Console

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

   Agent Builder

2. Nel menu di navigazione, fai clic su Datastore.

3. Fai clic su add_box Crea datastore.

4. Nel riquadro Seleziona un'origine dati, seleziona API Healthcare (FHIR) come origine dati.
5. Per importare i dati dal tuo archivio 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 utilizzi 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.
6. 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 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. Questa è una funzionalità in anteprima. Per configurare un datastore in streaming utilizzando l'API REST, contatta il tuo Customer Engineer.
7. 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 l'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 l'indicizzazione, la ricercabilità 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.

8. Fai clic su Continua.

REST

1. Crea un datastore.

   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/dataStores?dataStoreId=DATA_STORE_ID" \
    -d '{
       "displayName": "DATA_STORE_DISPLAY_NAME",
       "industryVertical": "HEALTHCARE_FHIR",
       "solutionTypes": ["SOLUTION_TYPE_SEARCH"],
       "searchTier": "STANDARD",
       "searchAddOns": ["LLM"]
   }'
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.
   • DATA_STORE_ID: l'ID del datastore di Vertex AI Search che vuoi creare. Questo ID può contenere solo lettere minuscole, cifre, trattini bassi e trattini.
   • DATA_STORE_DISPLAY_NAME: il nome visualizzato del datastore di ricerca Vertex AI che vuoi creare.

   Risposta

   Dovresti ricevere una risposta JSON simile alla seguente. Se il valore per la chiave done è true, indica che l'operazione di creazione del datastore è stata completata. In caso contrario, l'operazione di creazione del datastore non è riuscita.

   {
     "name": "projects/PROJECT_NUMBER/locations/us/collections/default_collection/operations/DATA_STORE_CREATION_OPERATION_ID",
     "done": true
   }
   

2. Se l'archivio FHIR di origine e l'datastore Vertex AI Search di destinazione si trovano nello stesso progetto Google Cloud, chiama il seguente metodo per eseguire un'importazione collettiva una tantum. Se non si trovano nello stesso progetto, vai al passaggio successivo.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json; charset=utf-8" \
   -H "X-Goog-User-Project: PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/dataStores/DATA_STORE_ID/branches/0/documents:import" \
   -d '{
      "reconciliation_mode": "FULL",
      "fhir_store_source": {"fhir_store": "projects/PROJECT_ID/locations/CLOUD_HEALTHCARE_DATASET_LOCATION/datasets/CLOUD_HEALTHCARE_DATASET_ID/fhirStores/FHIR_STORE_ID"}
   }'
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.
   • DATA_STORE_ID: l'ID dello datastore di Vertex AI Search.
   • CLOUD_HEALTHCARE_DATASET_ID: l'ID del set di dati dell'API Cloud Healthcare che contiene l'archivio FHIR di origine.
   • CLOUD_HEALTHCARE_DATASET_LOCATION: la posizione del set di dati dell'API Cloud Healthcare che contiene il datastore FHIR di origine.
   • FHIR_STORE_ID: l'ID dello spazio di archiviazione FHIR R4 dell'API Cloud Healthcare.

   Risposta

   Dovresti ricevere una risposta JSON simile alla seguente. La risposta contiene un identificatore per un'operazione a lunga esecuzione. Le operazioni a lunga esecuzione vengono restituite quando il completamento delle chiamate ai metodi potrebbe richiedere molto tempo. Prendi nota del valore di IMPORT_OPERATION_ID. Questo valore è necessario per verificare lo stato dell'importazione.

     {
       "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/operations/IMPORT_OPERATION_ID",
       "metadata": {
         "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ImportDocumentsMetadata"
       }
     }
   

3. Se l'archivio FHIR di origine e l'datastore Vertex AI Search di destinazione si trovano in progetti Google Cloud diversi, chiama il seguente metodo per eseguire un'importazione collettiva una tantum. Se si trovano nello stesso progetto, torna al passaggio precedente.

   curl -X POST \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   -H "Content-Type: application/json; charset=utf-8" \
   -H "X-Goog-User-Project: TARGET_PROJECT_ID" \
   "https://us-discoveryengine.googleapis.com/v1alpha/projects/TARGET_PROJECT_ID/locations/us/dataStores/DATA_STORE_ID/branches/0/documents:import" \
   -d '{
      "reconciliation_mode": "FULL",
      "fhir_store_source": {"fhir_store": "projects/SOURCE_PROJECT_ID/locations/CLOUD_HEALTHCARE_DATASET_LOCATION/datasets/CLOUD_HEALTHCARE_DATASET_ID/fhirStores/FHIR_STORE_ID"}
   }'
   

   Sostituisci quanto segue:

   • TARGET_PROJECT_ID: l'ID del progetto Google Cloud che contiene il datastore di Vertex AI Search.
   • DATA_STORE_ID: l'ID dello datastore di Vertex AI Search.
   • SOURCE_PROJECT_ID: l'ID del progetto Google Cloud che contiene il set di dati dell'API Cloud Healthcare e il repository FHIR.
   • CLOUD_HEALTHCARE_DATASET_ID: l'ID del set di dati dell'API Cloud Healthcare che contiene l'archivio FHIR di origine.
   • CLOUD_HEALTHCARE_DATASET_LOCATION: la posizione del set di dati dell'API Cloud Healthcare contenente il datastore FHIR di origine.
   • FHIR_STORE_ID: l'ID dello spazio di archiviazione FHIR R4 dell'API Cloud Healthcare.

   Risposta

   Dovresti ricevere una risposta JSON simile alla seguente. La risposta contiene un identificatore per un'operazione a lunga esecuzione. Le operazioni che richiedono molto tempo vengono restituite quando le chiamate ai metodi potrebbero richiedere molto tempo per essere completate. Prendi nota del valore di IMPORT_OPERATION_ID. Ti serve questo valore per verificare lo stato dell'importazione.

   {
     "name": "projects/TARGET_PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/operations/IMPORT_OPERATION_ID",
     "metadata": {
       "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ImportDocumentsMetadata"
     }
   }
   

4. (Facoltativo) Per configurare un'importazione di dati in streaming (anteprima) utilizzando l'API REST, contatta il tuo esperto dei clienti.

Python

Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Python Vertex AI Agent Builder.

Per autenticarti in Vertex AI Agent Builder, configura le Credenziali predefinite dell'applicazione. Per ulteriori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.

Crea un datastore

from google.api_core.client_options import ClientOptions
from google.cloud import discoveryengine

# TODO(developer): Uncomment these variables before running the sample.
# project_id = "YOUR_PROJECT_ID"
# location = "YOUR_LOCATION" # Values: "global"
# data_store_id = "YOUR_DATA_STORE_ID"


def create_data_store_sample(
    project_id: str,
    location: str,
    data_store_id: str,
) -> str:
    #  For more information, refer to:
    # https://cloud.google.com/generative-ai-app-builder/docs/locations#specify_a_multi-region_for_your_data_store
    client_options = (
        ClientOptions(api_endpoint=f"{location}-discoveryengine.googleapis.com")
        if location != "global"
        else None
    )

    # Create a client
    client = discoveryengine.DataStoreServiceClient(client_options=client_options)

    # The full resource name of the collection
    # e.g. projects/{project}/locations/{location}/collections/default_collection
    parent = client.collection_path(
        project=project_id,
        location=location,
        collection="default_collection",
    )

    data_store = discoveryengine.DataStore(
        display_name="My Data Store",
        # Options: GENERIC, MEDIA, HEALTHCARE_FHIR
        industry_vertical=discoveryengine.IndustryVertical.GENERIC,
        # Options: SOLUTION_TYPE_RECOMMENDATION, SOLUTION_TYPE_SEARCH, SOLUTION_TYPE_CHAT, SOLUTION_TYPE_GENERATIVE_CHAT
        solution_types=[discoveryengine.SolutionType.SOLUTION_TYPE_SEARCH],
        # TODO(developer): Update content_config based on data store type.
        # Options: NO_CONTENT, CONTENT_REQUIRED, PUBLIC_WEBSITE
        content_config=discoveryengine.DataStore.ContentConfig.CONTENT_REQUIRED,
    )

    request = discoveryengine.CreateDataStoreRequest(
        parent=parent,
        data_store_id=data_store_id,
        data_store=data_store,
        # Optional: For Advanced Site Search Only
        # create_advanced_site_search=True,
    )

    # Make the request
    operation = client.create_data_store(request=request)

    print(f"Waiting for operation to complete: {operation.operation.name}")
    response = operation.result()

    # After the operation is complete,
    # get information from operation metadata
    metadata = discoveryengine.CreateDataStoreMetadata(operation.metadata)

    # Handle the response
    print(response)
    print(metadata)

    return operation.operation.name

Importa documenti

from google.api_core.client_options import ClientOptions
from google.cloud import discoveryengine

# TODO(developer): Uncomment these variables before running the sample.
# project_id = "YOUR_PROJECT_ID"
# location = "YOUR_LOCATION" # Values: "us"
# data_store_id = "YOUR_DATA_STORE_ID"
# healthcare_project_id = "YOUR_HEALTHCARE_PROJECT_ID"
# healthcare_location = "YOUR_HEALTHCARE_LOCATION"
# healthcare_dataset_id = "YOUR_HEALTHCARE_DATASET_ID"
# healthcare_fihr_store_id = "YOUR_HEALTHCARE_FHIR_STORE_ID"

#  For more information, refer to:
# https://cloud.google.com/generative-ai-app-builder/docs/locations#specify_a_multi-region_for_your_data_store
client_options = (
    ClientOptions(api_endpoint=f"{location}-discoveryengine.googleapis.com")
    if location != "global"
    else None
)

# Create a client
client = discoveryengine.DocumentServiceClient(client_options=client_options)

# The full resource name of the search engine branch.
# e.g. projects/{project}/locations/{location}/dataStores/{data_store_id}/branches/{branch}
parent = client.branch_path(
    project=project_id,
    location=location,
    data_store=data_store_id,
    branch="default_branch",
)

request = discoveryengine.ImportDocumentsRequest(
    parent=parent,
    fhir_store_source=discoveryengine.FhirStoreSource(
        fhir_store=client.fhir_store_path(
            healthcare_project_id,
            healthcare_location,
            healthcare_dataset_id,
            healthcare_fihr_store_id,
        ),
    ),
    # Options: `FULL`, `INCREMENTAL`
    reconciliation_mode=discoveryengine.ImportDocumentsRequest.ReconciliationMode.INCREMENTAL,
)

# Make the request
operation = client.import_documents(request=request)

print(f"Waiting for operation to complete: {operation.operation.name}")
response = operation.result()

# After the operation is complete,
# get information from operation metadata
metadata = discoveryengine.ImportDocumentsMetadata(operation.metadata)

# Handle the response
print(response)
print(metadata)

Console

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

   Agent Builder

2. Nel menu di navigazione, fai clic su Datastore.

   La pagina Datastore mostra un elenco di datastore nel progetto Google Cloud con i relativi dettagli.

3. Verifica che il datastore o il connettore dati che hai creato sia nell'elenco dei datastore.

4. Seleziona il datastore o il connettore dati e verifica i relativi dettagli.

   • Per un datastore:
     • La tabella di riepilogo elenca i seguenti dettagli:
       • L'ID, il tipo e la regione del datastore.
       • Il numero di documenti che indica il numero di risorse FHIR importate.
       • Il timestamp dell'ultima importazione del documento.
       • Se vuoi, fai clic su Visualizza dettagli per visualizzare i dettagli dell'importazione dei documenti, ad esempio i dettagli di un'importazione riuscita, parziale o non riuscita.
     • La scheda Documenti elenca gli ID delle risorse FHIR importate e i relativi tipi di risorse in una tabella paginata. Puoi filtrare questa tabella per verificare se è stata importata una determinata risorsa.
     • La scheda Attività elenca i dettagli dell'importazione dei documenti, ad esempio i dettagli su un'importazione riuscita, parziale o non riuscita.
   • Per un connettore dati:
     • La tabella di riepilogo elenca i seguenti dettagli:
       • L'ID, il tipo e la regione della raccolta.
       • Il nome dell'app collegata.
       • Lo stato del connettore, che può essere attivo o in pausa.
     • La tabella Entità mostra l'entità all'interno del connettore dati. Il nome dell'entità corrisponde al nome dell'archivio FHIR di origine. L'ID dell'entità è l'ID del connettore dati a cui è stato aggiunto il nome dell'archivio FHIR di origine.
       • Fai clic sul nome dell'entità per visualizzarne i dettagli. Poiché un'entità è un'istanza di un datastore all'interno di un connettore dati, i dettagli dell'entità sono gli stessi di un datastore.

5. Nella scheda Schema, visualizza le proprietà per le risorse e gli elementi FHIR supportati. Fai clic su Modifica per configurare lo schema. Questa è una funzionalità di anteprima privata. Per configurare uno schema configurabile, contatta il tuo tecnico dedicato ai clienti.

REST

1. Verifica la creazione del datastore.

   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/dataStores/DATA_STORE_ID"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.
   • DATA_STORE_ID: l'ID dello datastore di Vertex AI Search.

   Risposta

   Dovresti ricevere una risposta JSON simile alla seguente. La risposta contiene i dettagli del datastore creato.

   {
     "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID",
     "displayName": "DATA_STORE_DISPLAY_NAME",
     "industryVertical": "HEALTHCARE_FHIR",
     "createTime": "DATA_STORE_CREATION_TIMESTAMP",
     "solutionTypes": [
       "SOLUTION_TYPE_SEARCH"
     ],
     "defaultSchemaId": "default_schema",
     "documentProcessingConfig": {
       "defaultParsingConfig": {
         "ocrParsingConfig": {}
       }
     }
   }
   

2. Verifica che l'operazione di importazione dei dati FHIR sia completata.

   curl -X GET \
   -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/operations/IMPORT_OPERATION_ID"
   

   Sostituisci quanto segue:

   • PROJECT_ID: l'ID del tuo progetto Google Cloud.
   • DATA_STORE_ID: l'ID dello datastore di Vertex AI Search.
   • IMPORT_OPERATION_ID: l'ID operazione dell'operazione a lunga esecuzione restituito quando chiami il metodo import

   Risposta

   Dovresti ricevere una risposta JSON simile alla seguente. L'operazione di importazione è un'operazione a lunga esecuzione. Durante l'esecuzione dell'operazione, la risposta contiene i seguenti campi:

   • successCount: indica il numero di risorse FHIR importate correttamente finora.
   • failureCount: indica il numero di risorse FHIR che non è stato possibile importare finora. Questo campo viene visualizzato solo se esistono risorse FHIR di cui non è stato possibile completare l'importazione.

   Al termine dell'operazione, la risposta contiene i seguenti campi:

   • successCount: indica il numero di risorse FHIR importate correttamente.
   • failureCount: indica il numero di risorse FHIR di cui non è stato possibile completare l'importazione. Questo campo viene visualizzato solo se esistono risorse FHIR di cui non è stata completata l'importazione.
   • totalCount: indica il numero di risorse FHIR presenti nell'archivio FHIR di origine. Questo campo viene visualizzato solo se esistono risorse FHIR di cui non è stata completata l'importazione.
   • done: ha il valore true per indicare che l'operazione di importazione è completata.
   • errorSamples: fornisce informazioni sulle risorse di cui non è stata completata l'importazione. Questo campo viene visualizzato solo se esistono risorse FHIR di cui non è stata completata l'importazione.
   • errorConfig: fornisce il percorso di una posizione Cloud Storage contenente il file di log di riepilogo degli errori.

   {
    "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/operations/IMPORT_OPERATION_ID",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ImportDocumentsMetadata",
      "createTime": "START_TIMESTAMP",
      "updateTime": "END_TIMESTAMP",
      "successCount": "SUCCESS_COUNT",
      "failureCount": "FAILURE_COUNT",
      "totalCount": "TOTAL_COUNT",
    },
    "done": true,
    "response": {
      "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.ImportDocumentsResponse",
     "errorSamples": [ERROR_SAMPLE],
     "errorConfig": {
        "gcsPrefix": "LOG_FILE_LOCATION"
      }
    }
   }