Questa pagina è stata tradotta dall'API Cloud Translation.

Filtrare la ricerca nel settore sanitario

Attenzione:

Restrizioni per la salute: in qualità di cliente, non utilizzerai e non consentirai agli Utenti finali di utilizzare i Servizi di IA generativa a scopi clinici (per chiarezza, la ricerca non clinica, la pianificazione o altre attività amministrative non sono soggette a limitazioni), come sostituti di consulenza medica professionale o in qualsiasi modo che sia supervisionato o richieda l'autorizzazione o l'approvazione di qualsiasi autorità di regolamentazione vigente. Per ulteriori informazioni, consulta i Termini di servizio specifici.
Per chiarezza, in merito all'utilizzo di Vertex AI Search per recuperare e riepilogare le informazioni mediche esistenti, la limitazione all'uso a fini clinici si riferisce alla limitazione all'uso a fini di diagnosi o cura dirette senza revisione da parte di un professionista autorizzato in conformità con le leggi e le normative vigenti.
Il risultato generato potrebbe non essere sempre completamente affidabile. A causa della natura degli LLM e dell'IA generativa, gli output potrebbero contenere informazioni scorrette o con bias (ad esempio stereotipi o altri contenuti dannosi) e dovrebbero essere esaminati. Tutti i riepiloghi o le risposte devono essere considerati bozze e non definitivi.
L'utilizzo previsto di questo prodotto non è fornire informazioni relative alla prevenzione, alla diagnosi o alla cura di malattie. Le domande relative a diagnosi o consigli per la cura non sono destinate a essere risolte dal prodotto. Lo scopo di questo prodotto è recuperare e riepilogare le informazioni mediche esistenti fornite dagli utenti.
A causa della scarsità di dati di test, questo prodotto può essere o meno applicabile alla fascia d'età 0-18 anni e alla fascia d'età 85 anni e oltre. Pertanto, quando esaminano l'output generato, i clienti devono considerare la rappresentatività dei sottogruppi all'interno dei propri dati di origine.

Quando esegui query sui dati sanitari, puoi utilizzare i filtri per perfezionare le risposte di ricerca. In una richiesta di ricerca, puoi fornire filtri per applicare criteri che includono o escludono determinate risposte di ricerca.

Ad esempio, quando esegui una ricerca nei dati di un singolo paziente, il corpo della richiesta di ricerca deve contenere la seguente espressione di filtro che specifica l'ID paziente:

"filter": "patient_id: ANY(\"PATIENT_ID\")"

Questa pagina mostra come definire i filtri per la ricerca sanitaria.

Prima di iniziare

Prima di iniziare, segui questi passaggi:

Crea un'app di ricerca sanitaria e un datastore di ricerca sanitaria e importa i dati FHIR R4. Per ulteriori informazioni, consulta Creare un'app di ricerca sanitaria e Creare un datastore per la ricerca sanitaria.
Esamina l'elenco delle risorse FHIR R4 supportate da Vertex AI Search come campi indicizzabili, disponibili per la ricerca e recuperabili. Per ulteriori informazioni, consulta la documentazione di riferimento dello schema di dati FHIR R4 per la salute.
Comprendi la sintassi delle espressioni di filtro.

Definire i filtri

I filtri vengono specificati nel campo filter nel corpo della richiesta del metodo servingConfigs.search.

La definizione del filtro segue la sintassi delle espressioni di filtro. Nell'espressione del filtro, il valore letterale può essere qualsiasi campo indicizzato della risposta alla query di ricerca. Ad esempio, se la risposta contiene una risorsa Observation, il patient_id a cui fa riferimento la risorsa Observation può essere utilizzato come valore letterale del filtro.

Le sezioni seguenti mostrano alcuni esempi di come creare filtri.

Definisci un filtro `resource_datetime`

Questo esempio mostra come specificare un filtro per una ricerca che includa solo le risorse con un valore resource_datetime successivo alla data e all'ora specificate.

REST

curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \
    -H "Content-Type: application/json" \
    "https://us-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/servingConfigs/default_search:search" \
    -d '{
"query": "QUERY",
"filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_datetime > \"DATE_TIME_VALUE,
"contentSearchSpec":{"snippetSpec":{"returnSnippet":true}}
}'

Sostituisci quanto segue:

PROJECT_ID: l'ID del tuo progetto Google Cloud.
DATA_STORE_ID: l'ID dello datastore di Vertex AI Search.
QUERY: la query di ricerca.
PATIENT_ID: l'ID risorsa del paziente di cui vuoi cercare i dati.
DATE_TIME_VALUE: il valore del campo resource_datetime che rappresenta una data e un'ora nel formato dateTime di FHIR. Ecco alcuni esempi di questo campo:
- Per specificare una data e un'ora con un fuso orario separato da un separatore T: 2022-08-05T01:00:00+00:00
- Per specificare una data: 2022-08-05
- Per specificare un mese: 2022-08
- Per specificare un anno: 2022

Risposta

Dovresti ricevere una risposta JSON simile alla seguente risposta troncata. La risposta contiene i risultati di ricerca dettagliati elencati in ordine cronologico inverso con gli snippet, se disponibili. Il campo structData contiene i dati JSON strutturati per il documento.

{
    "results": [
    {
        "id": "DOCUMENT_ID",
        "document": {
        "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
        "id": "DOCUMENT_ID",
        "structData": {
            ...
            "resource_type": "FHIR_RESOURCE_TYPE",
            "resource_datetime": "RESOURCE_DATETIME",
            "patient_id": "PATIENT_ID",
            "FHIR_RESOURCE_TYPE": { ... }
        },
        "derivedStructData": {
            "snippets": [
            {
                "snippet": "SNIPPET_TEXT",
                "snippet_status": "SUCCESS"
            }
            ]
        }
        }
    }]
}

Definisci un filtro per tipo di risorsa

L'esempio seguente mostra come creare un filtro che utilizza un operatore AND per filtrare prima tutte le risorse di composizione e poi quelle la cui data è successiva a una data e a un'ora specificate.

"filter": "resource_type: ANY("Composition") AND Composition.date > "2022-08-05T01:00:00+00:00""

Definire un filtro delle risorse FHIR

Puoi utilizzare un filtro per verificare se una risorsa FHIR è presente nel datastore di Vertex AI Search. Ad esempio, puoi cercare una risorsa DocumentReference con l'ID6112d1ac-c6bd-4755-d689-bfb71d59afc5 utilizzando il seguente filtro.

"filter": "DocumentReference.id: ANY(\"6112d1ac-c6bd-4755-d689-bfb71d59afc5\")"