篩選醫療照護搜尋結果

注意：

• 醫療保健限制：身為客戶，您不得將生成式 AI 服務用於臨床用途 (為求清楚，非臨床研究、排程或其他行政工作不受限制)，也不得允許使用者這麼做。此外，您不得將生成式 AI 服務做為專業醫療建議的替代方案，或以任何受適用監管機構監督或須經其核准的方式使用。詳情請參閱《服務專屬條款》。

  為求明確，就使用 Vertex AI Search 擷取及摘要現有醫療資訊而言，限制用於臨床用途是指限制用於直接診斷或治療用途，但須由符合適用法律和法規的執業專業人員審查。

• 生成內容不一定完全可靠。由於 LLM 和生成式 AI 的本質，輸出內容可能含有不正確或有偏誤 (例如刻板印象或其他有害內容) 的資訊，因此請務必審查。所有摘要或答案都應視為草稿，而非最終版本。
• 本產品的預期用途並非提供與疾病預防、診斷或治療相關的資訊。產品不會回答有關診斷或治療建議的問題。本產品的預期用途是擷取及摘要使用者提供的現有醫療資訊。
• 由於測試資料有限，這項產品可能不適用於 0 到 18 歲的年齡層，以及 85 歲以上的年齡層。因此，在查看生成的輸出內容時，顧客必須考量來源資料中子母體的代表性。

查詢醫療保健資料時，您可以使用篩選器縮小搜尋範圍，在搜尋要求中，您可以提供篩選器來強制執行條件，包括納入或排除特定搜尋回應。

舉例來說，當您搜尋單一病患的資料時，搜尋要求主體必須包含下列篩選器運算式，指定病患 ID：

"filter": "patient_id: ANY(\"PATIENT_ID\")"

本頁說明如何定義醫療保健搜尋的篩選條件。

事前準備

開始之前，請先執行下列操作：

• 建立醫療照護搜尋應用程式和醫療照護搜尋資料儲存庫，並匯入 FHIR R4 資料。詳情請參閱「建立醫療保健搜尋應用程式」和「建立醫療保健搜尋資料儲存庫」。
• 查看 Vertex AI Search 支援的 FHIR R4 資源清單，瞭解可建立索引、搜尋及擷取的欄位。詳情請參閱「Healthcare FHIR R4 資料結構定義參考資料」。
• 瞭解篩選運算式語法。

定義篩選器

篩選器是在 servingConfigs.search 方法的要求主體中，於 filter 欄位指定。

篩選器定義遵循篩選運算式語法。 在篩選運算式中，常值可以是搜尋查詢回應中的任何可建立索引的欄位。舉例來說，如果回應包含 Observation 資源，則可將 Observation 資源參照的 patient_id 做為篩選器常值。

以下各節提供幾個篩選器建構範例。

定義 resource_datetime 篩選器

這個範例說明如何指定搜尋的篩選條件，只納入 resource_datetime 值晚於指定日期和時間值的資源。

REST

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/dataStores/DATA_STORE_ID/servingConfigs/default_search:search" \
    -d '{
"query": "QUERY",
"filter": "patient_id: ANY(\"PATIENT_ID\") AND resource_datetime > \"DATE_TIME_VALUE,
"contentSearchSpec":{"snippetSpec":{"returnSnippet":true}}
}'

更改下列內容：

• PROJECT_ID：您的 Google Cloud 專案 ID。
• DATA_STORE_ID：Vertex AI Search 資料儲存庫的 ID。
• QUERY：搜尋查詢。
• PATIENT_ID：您要搜尋資料的病患資源 ID。
• DATE_TIME_VALUE：resource_datetime 欄位的值，代表 FHIR dateTime 格式的日期和時間。這個欄位的部分範例如下：
  • 如要指定日期和時間，並以 T 分隔符號分隔時區，請使用以下格式：2022-08-05T01:00:00+00:00
  • 如要指定日期：2022-08-05
  • 如要指定月份，請說出 2022-08
  • 如要指定年份，請使用 2022。

回應

您應該會收到類似以下截斷式回應的 JSON 回應。回應會包含依時間倒序排列的搜尋結果，並附上摘要 (如有)。structData 欄位包含文件的結構化 JSON 資料。

{
    "results": [
    {
        "id": "DOCUMENT_ID",
        "document": {
        "name": "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/DATA_STORE_ID/branches/0/documents/DOCUMENT_ID",
        "id": "DOCUMENT_ID",
        "structData": {
            ...
            "resource_type": "FHIR_RESOURCE_TYPE",
            "resource_datetime": "RESOURCE_DATETIME",
            "patient_id": "PATIENT_ID",
            "FHIR_RESOURCE_TYPE": { ... }
        },
        "derivedStructData": {
            "snippets": [
            {
                "snippet": "SNIPPET_TEXT",
                "snippet_status": "SUCCESS"
            }
            ]
        }
        }
    }]
}

定義資源類型篩選器

以下範例說明如何建構篩選器，使用 AND 運算子先篩選所有 Composition 資源，然後篩選日期晚於指定日期和時間的資源。

"filter": "resource_type: ANY("Composition") AND Composition.date > "2022-08-05T01:00:00+00:00""

定義 FHIR 資源篩選器

您可以使用篩選器，檢查 Vertex AI Search 資料儲存庫中是否有 FHIR 資源。舉例來說，您可以使用下列篩選器，搜尋 ID 為 6112d1ac-c6bd-4755-d689-bfb71d59afc5 的 DocumentReference 資源。

"filter": "DocumentReference.id: ANY(\"6112d1ac-c6bd-4755-d689-bfb71d59afc5\")"