데이터 스토어 및 항목 세부정보 가져오기

이 페이지에서는 Google Cloud 콘솔 또는 Discovery Engine REST API를 사용하여 Gemini Enterprise 데이터 스토어와 기본 엔티티의 리소스 세부정보를 가져오는 방법을 설명합니다.

리소스 수준 IAM 액세스 제어 구성, 검색 엔드포인트 쿼리, 수집 파이프라인 자동화와 같은 API를 사용하여 데이터 스토어와 상호작용할 때는 타겟 데이터 스토어와 기본 엔티티의 고유 리소스 ID가 필요합니다.

데이터 스토어 개념

Discovery Engine API에서 데이터 스토어 리소스가 구조화되는 방식을 이해하려면 다음 개념을 고려하세요.

개념 설명
데이터 스토어 Google 또는 서드 파티 데이터 소스에서 수집한 데이터의 컨테이너입니다. 독립형 데이터 스토어는 기본 컬렉션(default_collection)에 속합니다. 자세한 내용은 Gemini Enterprise 개념 및 앱 및 데이터 스토어 정보를 참고하세요.
데이터 수집 Google Cloud 프로젝트 및 위치(projects/{project}/locations/{location}/collections/{collection}) 내의 논리적 그룹화 리소스입니다.

다중 항목 서드 파티 데이터 스토어 (예: Jira, Salesforce, SharePoint Online)는 데이터 스토어 인스턴스를 나타내는 전용 컬렉션을 만듭니다.
데이터 스토어 항목 여러 항목 유형 (예: Jira 문제, Jira 프로젝트, SharePoint 파일)이 포함된 서드 파티 데이터 소스를 연결하면 Gemini Enterprise에서 각 항목 유형에 대해 별도의 하위 데이터 스토어를 자동으로 만듭니다.

이러한 엔티티 데이터 스토어는 collections/default_collection/dataStores/{DATA_STORE_ENTITY_ID} 아래에 하위 리소스로 상주합니다.

자세한 내용은 서드 파티 데이터 스토어용 구조화된 데이터 및 커넥터 및 데이터 스토어 소개를 참고하세요.

데이터 스토어 및 항목 세부정보 가져오기

다음 옵션 중 하나를 선택합니다.

콘솔

Google Cloud 콘솔에서 데이터 스토어 및 항목 세부정보를 가져오려면 다음 단계를 따르세요.

  1. Google Cloud 콘솔에서 Gemini Enterprise > 데이터 스토어 페이지로 이동합니다.

    데이터 스토어 페이지로 이동

  2. 타겟 데이터 스토어의 이름을 클릭합니다.

  3. 데이터 스토어 세부정보 페이지에서 헤더에 표시된 데이터 스토어 ID를 확인합니다.

  4. 데이터 스토어에 항목이 포함된 경우 항목 탭을 클릭하여 구성된 항목, 표시 이름, 해당 항목 데이터 스토어 ID (예: DataConnector3_entityA 및 DataConnector3_entityB) 목록을 확인합니다.

REST

REST API를 사용하여 데이터 스토어 및 엔티티 ID를 검색하려면 다음 단계를 완료하세요.

  1. 데이터 스토어 컬렉션 ID를 나열합니다 (다중 항목 데이터 스토어의 경우).

    항목이 여러 개인 서드 파티 데이터 스토어 (예: Jira 또는 Salesforce)의 경우 Gemini Enterprise는 커넥터 인스턴스를 나타내는 전용 컬렉션을 만듭니다. collections 목록 엔드포인트를 호출하여 프로젝트의 컬렉션 ID를 가져옵니다.

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION/collections"

    다음을 바꿉니다.

    • PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
    • ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
      • 미국 멀티 리전의 경우 us
      • EU 멀티 리전의 경우 eu
      • 전역 위치의 경우 global
      자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
    • LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).

    응답에는 컬렉션 목록이 포함됩니다.

    {
  "collections": [
    {
      "name": "projects/123456789/locations/global/collections/DataConnector3",
      "displayName": "Jira Production Data Store"
    }
  ]
}

    이 예에서 컬렉션 ID는 DataConnector3입니다. 커넥터 인스턴스의 컬렉션 수준 액세스 제어를 구성할 때 이 ID를 사용합니다.

  2. default_collection 아래에 엔티티 및 독립형 데이터 스토어 ID를 나열합니다.

    Gemini Enterprise에서 독립형 데이터 스토어와 다중 항목 커넥터의 하위 항목을 비롯한 모든 데이터 스토어 리소스는 default_collection에 있습니다. 다중 항목 데이터 스토어에는 전용 컬렉션 ID (예: DataConnector3)가 있지만 하위 항목 데이터 스토어는 default_collection 아래에 등록되고 커넥터 ID가 앞에 붙습니다.

    default_collection에서 dataStores 목록 엔드포인트를 호출하여 데이터 스토어 및 항목 ID를 찾습니다.

    curl -X GET \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/collections/default_collection/dataStores"

    다음을 바꿉니다.

    • PROJECT_ID:Google Cloud 프로젝트의 ID입니다.
    • ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
      • 미국 멀티 리전의 경우 us
      • EU 멀티 리전의 경우 eu
      • 전역 위치의 경우 global
      자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
    • LOCATION: 데이터 스토어의 멀티 리전입니다(global, us 또는 eu).

    응답에는 데이터 스토어 목록이 포함됩니다.

    {
  "dataStores": [
    {
      "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityA",
      "displayName": "Jira Issues Entity"
    },
    {
      "name": "projects/123456789/locations/global/collections/default_collection/dataStores/DataConnector3_entityB",
      "displayName": "Jira Projects Entity"
    }
  ]
}

    이 예에서 엔티티 데이터 스토어 ID는 DataConnector3_entityA 및 DataConnector3_entityB입니다. REST API를 사용하여 다중 항목 데이터 스토어의 모든 기본 항목 데이터 스토어에 대한 액세스 제어를 구성할 때 이러한 ID를 사용합니다.

다음 단계