의료 검색 앱 만들기

Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

앱 페이지에서 add_box 새 앱을 클릭합니다.

앱 만들기 페이지의 의료 검색에서 만들기를 클릭합니다.

검색 앱 구성 창에서 의료를 선택합니다.

이 앱에 고급 LLM 기능을 사용 설정하려면 고급 LLM 기능 전환 버튼을 클릭합니다.

고급 LLM 기능을 활성화하여 상위 검색 결과 1개 이상을 짧게 요약한 검색 요약을 가져옵니다.

LLM 기능을 활성화하면 지원되는 기능이 제공되는 데 최대 5분이 걸릴 수 있습니다.

앱 이름 필드에 앱 이름을 입력합니다.

회사 또는 조직의 외부 이름 필드에 회사 또는 조직의 일반 이름을 입력합니다. Inc 또는 LLC와 같은 서픽스는 포함하지 않아도 됩니다. 이 필드는 LLM이 앱에서 대표하는 회사를 식별하는 데 유용합니다.

계속을 클릭합니다.

데이터 스토어에 연결하려면 데이터 스토어 페이지에서 다음 중 하나를 수행합니다.

• 일괄 가져오기의 경우 기존 의료 데이터 스토어를 선택하고 스트리밍 가져오기의 경우 기존 데이터 커넥터를 선택합니다. 앱을 만들기 전에 데이터 스토어 또는 데이터 커넥터를 만들려면 의료 데이터 스토어 만들기를 참조하세요.
• 데이터 스토어 (일회성 일괄 가져오기용) 또는 데이터 스토어의 인스턴스인 데이터 커넥터 (스트리밍 가져오기용)를 만듭니다.
  1. add_box 데이터 스토어 만들기를 클릭합니다.
  2. 데이터 소스 선택 창에서 데이터 소스로 Healthcare API(FHIR)를 선택합니다.
  3. FHIR 스토어에서 데이터를 가져오려면 다음 중 하나를 수행합니다.
     • 사용 가능한 FHIR 스토어 목록에서 FHIR 스토어를 선택합니다.
       1. FHIR 스토어 필드를 펼칩니다.
       2. 이 목록에서 허용된 위치에 있는 데이터 세트를 선택한 다음 FHIR 버전 R4를 사용하는 FHIR 스토어를 선택합니다.

          FHIR 데이터를 스트리밍(미리보기)하려면 소스 FHIR 스토어가 대상 Vertex AI Search 데이터 스토어와 동일한 Google Cloud 프로젝트에 있어야 합니다.

     • 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이 사전 정의한 스키마: 지원되는 FHIR 리소스 및 요소에 대해 색인 생성 가능 여부, 검색 가능성, 가져오기 가능성과 같은 Google이 사전 정의한 스키마 구성을 유지합니다. 이 옵션을 선택하면 데이터 스토어를 만든 후 스키마를 업데이트할 수 없습니다. 데이터 스토어를 만든 후 스키마를 변경하려면 커스텀 스키마(미리보기) 옵션을 선택합니다.
       1. 계속을 클릭합니다.
       2. 데이터 스토어 이름 필드에 데이터 스토어의 이름을 입력합니다.
       3. 만들기를 클릭합니다.

       생성한 데이터 스토어가 데이터 스토어 페이지에 나열됩니다.

     • 커스텀 스키마(미리보기): 지원되는 FHIR 리소스 및 요소에 대해 색인 생성 가능 여부, 검색 가능성, 가져오기 가능성과 같은 자체 스키마 구성을 정의합니다. 이 기능은 미리보기 기능입니다. 구성 가능한 스키마를 설정하려면 고객 엔지니어에게 문의하세요.
       1. 계속을 클릭합니다.
       2. 스키마를 검토하고 각 필드를 펼친 다음 필드 설정을 수정합니다.
       3. 새 필드 추가를 클릭하여 지원되는 FHIR 리소스에 새 필드를 추가합니다. Google이 정의한 스키마에 제공된 필드는 삭제할 수 없습니다.
       4. 계속을 클릭합니다.
       5. 데이터 커넥터 이름 필드에 데이터 커넥터의 이름을 입력합니다.
       6. 만들기를 클릭합니다.

       만든 데이터 커넥터가 데이터 스토어 페이지에 나열됩니다. 소스 FHIR 스토어가 데이터 커넥터 내에 항목으로 추가됩니다.

  6. 계속을 클릭합니다.
  7. 만든 데이터 스토어 또는 데이터 커넥터를 선택합니다.

선택사항: 사용할 수 없는 데이터 스토어 목록을 보려면 이유 알아보기를 클릭합니다.

데이터 스토어 목록과 사용 불가 이유가 포함된 테이블이 표시됩니다. 데이터 스토어를 사용할 수 없는 몇 가지 이유는 다음과 같습니다.

• 데이터 스토어 유형은 하나의 앱에만 연결할 수 있으며 데이터 스토어가 이미 연결되어 있습니다.
• 데이터 스토어와 앱의 유형이 다릅니다. 예를 들어 웹사이트 검색 데이터 스토어를 의료 검색 앱에 연결할 수 없습니다.

만들기를 클릭합니다.

앱과 데이터 스토어가 생성되면 데이터 스토어 세부정보 페이지에 가져온 FHIR 데이터의 세부정보가 표시됩니다.

의료 검색 앱을 만들고 데이터 스토어에 연결합니다. 의료 검색 앱은 하나의 데이터 스토어에만 연결할 수 있지만, 특정 데이터 스토어는 여러 앱에 연결할 수 있습니다.

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/v1alpha/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"]
    }
}'

다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• APP_ID: 만들려는 Vertex AI Search 앱의 ID입니다.
• APP_DISPLAY_NAME: 만들려는 Vertex AI Search 앱의 표시 이름입니다.
• DATA_STORE_ID: Vertex AI Search 앱에 추가하려는 기존 Vertex AI Search 데이터 스토어의 ID입니다.
• SEARCH_ADD_ON: 이 앱에 생성형 AI 답변으로 검색과 같은 고급 LLM 기능을 사용할지 여부를 지정하는 선택사항 필드입니다. 고급 LLM 기능을 활성화하려면 값 SEARCH_ADD_ON_LLM을 입력합니다. 고급 LLM 기능을 사용하지 않으려면 SEARCH_ADD_ON_UNSPECIFIED를 지정하거나 searchAddOns 필드를 삭제합니다. 자세한 내용은 고급 LLM 기능을 참조하세요.

{
  "name": "projects/PROJECT_ID/locations/us/collections/default_collection/operations/APP_CREATION_OPERATION_ID",
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.cloud.discoveryengine.v1alpha.Engine",
    "name": "projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID",
    "displayName": "APP_DISPLAY_NAME",
    "dataStoreIds": [
      "DATA_STORE_ID"
    ],
    "solutionType": "SOLUTION_TYPE_SEARCH",
    "searchEngineConfig": {
      "searchTier": "SEARCH_TIER_STANDARD",
      "searchAddOns": [
        "SEARCH_ADD_ON_LLM"
      ]
    },
    "industryVertical": "HEALTHCARE_FHIR"
  }
}

Google Cloud 콘솔에서 Agent Builder 페이지로 이동합니다.

Agent Builder를 사용하여 이 모든 것을 자체 데이터에 그라운딩하세요.

앱 페이지에서 만든 앱이 앱 목록에 있는지 확인합니다.

앱에 연결한 데이터 스토어가 연결된 데이터 스토어 열에 표시되는지 확인합니다.

데이터 스토어를 선택하고 데이터 스토어 세부정보를 확인합니다.

앱 생성을 확인합니다.

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/v1alpha/projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID"

다음을 바꿉니다.

• PROJECT_ID: Google Cloud 프로젝트의 ID입니다.
• APP_ID: Vertex AI Search 앱의 ID입니다.

{
  "name": "projects/PROJECT_ID/locations/us/collections/default_collection/engines/APP_ID",
  "displayName": "APP_DISPLAY_NAME",
  "createTime": "APP_CREATION_TIMESTAMP",
  "dataStoreIds": [
    "DATA_STORE_ID"
  ],
  "solutionType": "SOLUTION_TYPE_SEARCH",
  "searchEngineConfig": {
    "searchTier": "SEARCH_TIER_STANDARD",
    "searchAddOns": [
      "SEARCH_ADD_ON_LLM"
    ]
  },
  "industryVertical": "HEALTHCARE_FHIR",
  "dataStores": [
    "projects/PROJECT_ID/locations/us/collections/default_collection/dataStores/APP_ID"
  ]
}

데이터 스토어 생성 및 FHIR 데이터 가져오기를 확인합니다.