Order healthcare search results

Console

1. In the Google Cloud console, go to the AI Applicationspage.

   AI Applications

2. Select the healthcare search app that you want to query.

3. In the navigation menu, click Preview.

4. In the Patient IDfield, enter the ID of the patient whose data you want to query. Patient IDs are case-sensitive.

5. Press Enteror click Previewto submit the patient ID.

6. In the Search heresearch bar, enter your query.

   If you enabled autocomplete, you see a list of autocomplete suggestions below the search bar as you type.

7. Press Enterto submit the query.

   • The search results are displayed in paginated tables that are categorized based on their FHIR resource type.
   • By default, the search results for all FHIR resource types are displayed in reverse chronological order.

8. For the Composition, the DocumentReference, and the DiagnosticReport resources, click the Sort: Reverse Chronologicalfilter and select Relevancefrom the list. The results for these resources are then ordered according to relevance.

REST

To order your search results according to relevance, modify your search request in the following way:

• Add the filter field to your request to limit the search results to only those FHIR resources that contain unstructured text: Composition, DiagnosticReport, and DocumentReference.
• Add the orderBy field to your search request and set its value to _RELEVANCE to get search responses that are sorted according to their relevance.

1. Send the search request.

   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"
   }'

   Replace the following:

   • PROJECT_ID : the ID of your Google Cloud project.
   • APP_ID : the ID of the Vertex AI Search app that you want to query.
   • KEYWORD_QUERY : the keyword that you want to search across the patient clinical data for the filtered patient, such as "diabetes" or "a1c".
   • PATIENT_ID : the resource ID of the patient whose data you want to search.

   You should receive a JSON response that contains itemized search results listed in the order of their relevance.