Per impostazione predefinita, quando cerchi dati sanitari, i risultati di ricerca vengono restituiti in ordine cronologico inverso. Quando esegui ricerche nei seguenti tipi di risorse FHIR che contengono testo non strutturato, puoi ordinare i risultati di ricerca in base alla pertinenza per la query:
- Composizione
- DiagnosticReport
- DocumentReference
Scenario di esempio
Supponiamo che tu stia cercando la parola chiave
insulin
per un determinato paziente e che tu abbia filtrato i risultati in base alle risorse
che contengono testo non strutturato. Tra gli altri risultati, riceverai i seguenti
documenti:
- Risultato 1: una risorsa DocumentReference, datata 24 aprile 2024, che contiene note sui livelli di "HbA1c" del paziente.
- Risultato 2: una risorsa DiagnosticReport, datata 11 gennaio 2024, che contiene note sul "regime insulinico" che il paziente deve seguire.
Per impostazione predefinita, il risultato 1 viene visualizzato più in alto nei risultati perché è un documento più recente, ma quando ordini per pertinenza, il risultato 2 viene visualizzato più in alto nei risultati. Questo perché è più pertinente alla query di ricerca insulin
.
Ordinare i risultati di ricerca per la sanità
Per ordinare i risultati di ricerca in base alla pertinenza, completa i seguenti passaggi:
Console
Nella Google Cloud console, vai alla pagina AI Applications.
Seleziona l'app di ricerca sanitaria che vuoi interrogare.
Nel menu di navigazione, fai clic su Anteprima.
Nel campo ID paziente, inserisci l'ID del paziente di cui vuoi interrogare i dati. Gli ID paziente sono sensibili alle maiuscole.
Premi Invio o fai clic su Anteprima per inviare l'ID paziente.
Nella barra di ricerca Cerca qui, inserisci la query.
Se hai attivato il completamento automatico, vedrai un elenco di suggerimenti di completamento automatico sotto la barra di ricerca mentre digiti.
Premi Invio per inviare la query.
- I risultati di ricerca vengono visualizzati in tabelle paginate classificate in base al tipo di risorsa FHIR.
- Per impostazione predefinita, i risultati di ricerca per tutti i tipi di risorse FHIR vengono visualizzati in ordine cronologico inverso.
Per le risorse Composition, DocumentReference e DiagnosticReport, fai clic sul filtro Ordina: cronologico inverso e seleziona Pertinenza dall'elenco. I risultati per queste risorse vengono quindi ordinati in base alla pertinenza.
REST
Per ordinare i risultati di ricerca in base alla pertinenza, modifica la richiesta
search
nel seguente modo:
- Aggiungi il campo
filter
alla tua richiesta per limitare i risultati di ricerca solo alle risorse FHIR che contengono testo non strutturato: Composition, DiagnosticReport e DocumentReference. - Aggiungi il campo
orderBy
alla tua richiesta di ricerca e imposta il relativo valore su_RELEVANCE
per ottenere risposte di ricerca ordinate in base alla pertinenza.
Invia la richiesta di ricerca.
curl -X POST -H "Authorization: Bearer $(gcloud auth print-access-token)" \ -H "Content-Type: application/json" \ "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID/servingConfigs/default_search:search" \ -d '{ "query": "KEYWORD_QUERY", "filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_type: ANY(\"Composition\", \"DiagnosticReport\", \"DocumentReference\")", "orderBy": "_RELEVANCE" }'
Sostituisci quanto segue:
PROJECT_ID
: l'ID del tuo Google Cloud progetto.APP_ID
: l'ID dell'app Vertex AI Search per cui vuoi eseguire query.KEYWORD_QUERY
: la parola chiave che vuoi cercare nei dati clinici del paziente filtrato, ad esempio "diabete" o "a1c".PATIENT_ID
: l'ID risorsa del paziente di cui vuoi cercare i dati.
Dovresti ricevere una risposta JSON contenente risultati di ricerca dettagliati elencati in ordine di pertinenza.