Ordinare i risultati di ricerca sanitari

Per impostazione predefinita, quando esegui ricerche nei 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 loro pertinenza alla query:

  • Composizione
  • DiagnosticReport
  • DocumentReference

Scenario di esempio

Supponiamo che tu stia cercando la parola chiaveinsulin per un determinato paziente e che tu abbia filtrato i risultati in base alle risorse che contengono testo non strutturato. Tra gli altri risultati, ricevi 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 di insulina" 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 li ordini in base alla 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 relativi alla salute

Per ordinare i risultati di ricerca in base alla pertinenza, svolgi i seguenti passaggi:

Console

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

    Agent Builder

  2. Seleziona l'app di ricerca sanitaria per cui vuoi eseguire una query.

  3. Nel menu di navigazione, fai clic su Anteprima.

  4. Nel campo ID paziente, inserisci l'ID del paziente di cui vuoi eseguire una query sui dati. Gli ID paziente sono sensibili alle maiuscole.

  5. Premi Invio o fai clic su Anteprima per inviare l'ID paziente.

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

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

  8. Per le risorse Composition, DocumentReference e DiagnosticReport, fai clic sul filtro Ordina: cronologico inverso e seleziona Rilevanza dall'elenco. I risultati per queste risorse vengono poi 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 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 richiesta di ricerca e imposta il relativo valore su _RELEVANCE per ricevere risposte di ricerca ordinate in base alla loro pertinente.

  1. 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/v1alpha/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 progetto Google Cloud.
    • APP_ID: l'ID dell'app Vertex AI Search su cui vuoi eseguire una query.
    • KEYWORD_QUERY: la parola chiave da 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.