排序醫療照護搜尋結果

根據預設，當您搜尋醫療照護資料時，系統會以倒轉時間順序傳回搜尋結果。搜尋含有非結構化文字的下列 FHIR 資源類型時，您可以依據搜尋結果與查詢的相關程度排序：

  • 作曲
  • DiagnosticReport
  • DocumentReference

範例情境

假設您要為特定病患搜尋關鍵字 insulin，並將結果篩選為含有非結構化文字的資源。您會收到以下文件：

  • 結果 1：日期為 2024 年 4 月 24 日的 DocumentReference 資源，其中包含患者的「HbA1c」濃度相關備註。
  • 結果 2：日期為 2024 年 1 月 11 日的 DiagnosticReport 資源，其中包含患者必須遵循的「胰島素療程」相關附註。

根據預設，系統會將較新的文件 (結果 1) 排在搜尋結果較前的位置，但如果您依關聯性排序，結果 2 就會排在搜尋結果較前的位置。這是因為該內容與搜尋查詢 insulin 的相關性較高。

排序醫療照護搜尋結果

如要依據相關性排序搜尋結果，請完成下列步驟：

控制台

  1. 前往 Google Cloud 控制台的「AI Applications」頁面。

    AI 應用程式

  2. 選取要查詢的醫療保健搜尋應用程式。

  3. 在導覽選單中，按一下「Preview」。

  4. 在「病患 ID」欄位中，輸入要查詢資料的病患 ID。病患 ID 須區分大小寫。

  5. 按下 Enter 鍵或點選「預覽」，即可提交病人 ID。

  6. 在「搜尋這裡」搜尋列中輸入查詢。

    如果已啟用自動完成功能，當您輸入內容時，搜尋列下方就會顯示自動完成建議清單。

  7. 按下 Enter 鍵提交查詢。

    • 搜尋結果會以分頁表格顯示，並根據 FHIR 資源類型分類。
    • 根據預設，所有 FHIR 資源類型的搜尋結果會以逆時排序方式顯示。

  8. 針對「Composition」、「DocumentReference」和「DiagnosticReport」資源，請按一下「Sort: Reverse Chronological」篩選器，然後從清單中選取「Relevance」。接著，這些資源的結果會依關聯性排序。

REST

如要依關聯性排序搜尋結果，請按照下列方式修改 search 要求：

  • 將 filter 欄位新增至要求，即可將搜尋結果限制為僅包含非結構化文字的 FHIR 資源：Composition、DiagnosticReport 和 DocumentReference。
  • 將 orderBy 欄位新增至搜尋要求，並將其值設為 _RELEVANCE，即可取得依相關性排序的搜尋回應。

  1. 傳送搜尋要求。

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

    更改下列內容：

    • PROJECT_ID： Google Cloud 專案的 ID。
    • APP_ID：您要查詢的 Vertex AI Search 應用程式 ID。
    • KEYWORD_QUERY：您要在篩選後的病患臨床資料中搜尋的關鍵字，例如「糖尿病」或「a1c」。
    • PATIENT_ID：您要搜尋資料的病患資源 ID。

    您應該會收到 JSON 回應，其中包含按關聯性排序的明細搜尋結果。