创建医疗保健搜索应用

如需在 Agent Search 中搜索临床数据，您可以按照以下工作流之一进行操作：

  • 创建医疗保健数据存储区，将 FHIR R4 数据导入数据存储区，将其关联到医疗保健搜索应用，然后查询临床数据。如需了解详情，请参阅创建医疗保健数据存储区。
  • 创建医疗保健搜索应用，在应用创建过程中创建医疗保健数据存储区并将 FHIR R4 数据导入数据存储区，然后查询临床数据。

本页介绍了第二种方法。

数据导入频率简介

您可以通过以下方式将 FHIR R4 数据导入数据存储区：

  • 批量导入：一次性导入。数据将分批导入数据存储区。如需进一步增量导入，请参阅 刷新医疗保健数据。

  • 流式导入：近乎实时的流式 数据导入。源 FHIR 存储区中的任何增量更改都会在 Agent Search 数据存储区中同步。流式导入需要使用数据 连接器，这是一种数据存储区。如需创建数据连接器，您必须设置集合。数据连接器包含实体，这也是 数据存储区实例。

    您还可以根据需要随时暂停和恢复流式导入，并执行手动同步。如需了解详情，请参阅 管理医疗保健搜索数据存储区。

    给定项目的 Google Cloud __数据流式处理速率 取决于以下配额。如果超出配额，您可能会遇到流式处理延迟。

您可以在创建数据存储区时选择数据导入频率，之后无法更改此配置。

准备工作

在创建医疗保健搜索应用之前，请了解以下内容：

  • 医疗保健搜索应用与数据存储区之间的关系。 如需了解详情，请参阅 应用和数据存储区简介。

  • 准备 FHIR 数据以进行提取。

  • 医疗保健 Agent Search 仅在美国多区域 (us) 提供搜索服务。因此，您的医疗保健搜索应用和数据存储区必须位于 us 多区域中。

  • 如果您要将医疗保健数据从 一个 Google Cloud 项目中的 Cloud Healthcare API FHIR 存储区导入到 另一个 Google Cloud 项目中的 Agent Search 数据存储区，并且您使用的是 VPC Service Controls，则这两个 项目必须位于同一 边界内。

创建应用

您可以在 Google Cloud 控制台中或使用 API。 如需创建医疗保健搜索应用，请按以下步骤操作：

控制台

  1. 在 Google Cloud 控制台中，前往 AI Applications 页面。

    AI Applications

  2. 在应用 页面上，点击 新应用。

  3. 在创建应用 页面的医疗保健搜索 下方，点击创建 。

  4. 在搜索应用配置 窗格中，选择医疗保健 。

  5. 如需为此应用启用使用 高级 LLM 功能 的生成式回答， 请将 生成式回答 开关切换到“开启”位置。

    启用生成式回答后，最多可能需要 5 分钟才可使用受支持的功能。

  6. 在应用名称 字段中，输入应用的名称。

  7. 在贵公司或组织的外部名称 字段中，输入贵公司或组织的常用名称。您无需添加 Inc 或 LLC 等后缀。此字段有助于 LLM 识别应用所代表的公司。

  8. 在 Access Transparency 部分中，选择为此应用停用搜索指标 以关闭当前应用的日志记录指标。应用创建后，您将无法更改此设置。

  9. 点击继续 。

  10. 如需连接到数据存储区，请在数据存储区 页面上执行以下操作之一：

    • 选择现有的医疗保健数据存储区进行批量导入，或选择现有的数据连接器进行流式导入。如需在创建应用之前创建数据存储区或 数据连接器，请参阅 创建医疗保健数据存储区。
    • 创建数据存储区（用于一次性批量导入）或数据连接器（数据存储区的实例，用于流式导入）：
      1. 点击 创建数据存储区 。
      2. 在选择数据源 窗格中，选择 Healthcare API (FHIR) 作为数据源。
      3. 如需从 FHIR 存储区导入数据，请执行以下操作之一：
        • 从可用 FHIR 存储区列表中选择 FHIR 存储区：
          1. 展开 FHIR 存储区 字段。
          2. 在此列表中，选择位于 允许的位置的数据集，然后 选择使用 FHIR 版本 R4 的 FHIR 存储区。
        • 手动输入 FHIR 存储区：
          1. 展开 FHIR 存储区 字段。
          2. 点击手动输入 FHIR 存储区 。
          3. 在 FHIR 存储区名称 对话框中，输入 FHIR 存储区的完整名称，格式如下：

            project/PROJECT_ID/locations/LOCATION/datasets/DATASET_ID/fhirStores/FHIR_STORE_ID

          4. 点击保存 。
      4. 在同步 部分中，选择以下选项之一。 在数据存储区创建完毕后，将无法更改此选择。
        • 一次性：执行一次性批量数据导入。如需进一步 增量导入，请参阅刷新医疗保健数据。
        • 流式：执行近乎实时的流式数据导入。如需 流式传输数据，您必须创建数据连接器，这是一种 数据存储区。如需使用 REST API 设置流式数据存储区 ，请与您的客户工程师联系。
      5. 在此数据的架构是什么？ 部分中，选择以下选项之一：
        • Google 预定义架构：保留 Google 定义的架构配置（例如 可编入索引性、可搜索性和可检索性），以用于受支持的 FHIR 资源和元素。选择此选项后，您将无法在创建数据存储区后更新架构。 如果您希望能够在创建数据存储区后更改架构，请选择自定义架构 选项。
          1. 点击继续 。
          2. 在数据存储区名称 字段中，输入数据存储区的名称。
          3. 点击创建 。

            4. 您创建的数据存储区会列在数据存储区 页面上。

        • 自定义架构：为您自己的架构配置（例如 可编入索引性、可搜索性和可检索性）定义受支持的 FHIR 资源和元素。如需设置可配置的 架构，请与您的客户工程师联系。
          1. 点击继续 。
          2. 查看架构，展开每个字段，然后修改字段 设置。
          3. 点击添加新字段 以在 受支持的 FHIR 资源中添加新字段。您无法移除 Google 定义的架构中提供的字段 。
          4. 点击继续 。
          5. 在数据连接器名称 字段中，输入数据连接器的名称。
          6. 点击创建 。

            7. 您创建的数据连接器会列在数据存储区 页面上。 源 FHIR 存储区将作为实体添加到数据 连接器中。

      6. 点击继续 。
      7. 选择创建的数据存储区或数据连接器。

  11. 可选：如需查看不可用数据存储区的列表，请点击了解原因 。

    系统会显示一个表格，其中列出了数据存储区及其不可用的原因。以下是数据存储区可能不可用的一些原因：

    • 您的数据存储区类型仅允许连接到一个应用，并且该数据存储区已连接。
    • 您的数据存储区和应用属于不同类型。例如，您无法将网站搜索数据存储区连接到医疗保健搜索应用。

  12. 点击创建 。

    如果应用及其数据存储区创建成功，数据存储区详情页面会显示导入的 FHIR 数据的详细信息。

REST

  1. 创建医疗保健数据存储区并将医疗保健数据导入其中。

  2. 创建医疗保健搜索应用并将其关联到数据存储区。医疗保健搜索应用只能连接到一个数据存储区，而给定的数据存储区可以连接到多个应用。

    curl -X POST\
 -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
"https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines?engineId=APP_ID" \
 -d '{
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds":"DATA_STORE_ID",
    "industryVertical": "HEALTHCARE_FHIR",
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": ["SEARCH_ADD_ON"]
    }
}'

    替换以下内容：

验证应用创建

此任务向您展示了如何验证医疗保健搜索应用是否创建成功，以及 FHIR 数据是否已成功导入数据存储区。

  • 在 Google Cloud 控制台中：选择应用并验证其详细信息。
  • 通过 REST API，使用 engines.get 方法获取医疗保健数据存储区详细信息。

如需验证数据存储区创建和数据导入，请完成以下步骤。

控制台

  1. 在 Google Cloud 控制台中，前往 AI Applications 页面。

    AI Applications

  2. 在应用 页面上，验证您创建的应用是否在应用列表中。

  3. 验证您连接到应用的数据存储区是否列在关联的数据存储区 表中。

  4. 选择数据存储区并 验证数据存储区详细信息。

REST

  1. 验证应用创建。

    curl -X GET -H "Authorization: Bearer $(gcloud auth print-access-token)" \
 -H "Content-Type: application/json"\
 -H "X-Goog-User-Project: PROJECT_ID" \
 "https://us-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

    替换以下内容：

    • PROJECT_ID：您的 Google Cloud 项目的 ID。
    • APP_ID：Agent Search 应用的 ID。

  2. 验证数据存储区创建和 FHIR 数据导入。

后续步骤