Ordinare i risultati di ricerca sanitari

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

  1. Nella Google Cloud console, vai alla pagina AI Applications.

    Applicazioni di AI

  2. Seleziona l'app di ricerca sanitaria che vuoi interrogare.

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

  4. Nel campo ID paziente, inserisci l'ID del paziente di cui vuoi interrogare i 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 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.
  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/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.