Google Drive 데이터 스토어 설정

이 페이지에서는 데이터 스토어를 만들고 Google Drive를 Gemini Enterprise에 연결하는 방법을 설명합니다. 이 연결을 통해 Gemini Enterprise는 Google Drive에서 정보를 직접 가져올 수 있습니다. 데이터가 Gemini Enterprise 색인에 복사되지 않으므로 데이터 스토리지를 관리할 필요가 없습니다.

시작하기 전에

데이터 스토어를 만들기 전에 Google Drive 환경을 준비하려면 다음을 수행합니다.

  • 연결하려는 Google Drive 인스턴스에 사용하는 계정과 동일한 계정으로 Google Cloud 콘솔에 로그인해야 합니다. Gemini Enterprise는 Google Workspace 고객 ID를 사용하여 Google Drive에 연결합니다. 개인 Google 계정(@gmail.com로 끝나는 일반 사용자 계정)에는 고객 ID가 없으며 지원되지 않습니다.

  • 데이터 소스 액세스 제어를 적용하고 Gemini Enterprise에서 데이터를 보호하려면 ID 프로바이더를 구성해야 합니다.

  • 도메인이 소유한 공유 드라이브에 문서를 배치하거나 도메인의 사용자에게 소유권을 할당하여 모든 문서에 액세스할 수 있는지 확인합니다.

  • Google Workspace에서 Gemini Enterprise 액세스 사용 설정:Google 관리 콘솔에서 사용자 및 Google Drive 데이터가 있는 조직의 Google Workspace 관리자가 Gemini Enterprise가 Google Workspace 데이터에 액세스하도록 허용을 사용 설정해야 합니다. 이 설정이 사용 중지되면 Google Drive 검색에서 Gemini Enterprise 웹 앱에 결과가 반환되지 않으며 API에서 403 Permission Denied: Workspace access for Agentspace disabled by organization admin. 오류가 반환될 수 있습니다. 자세한 내용은 Google Workspace 데이터에 대한 Gemini Enterprise 액세스 제어를 참고하세요.

  • 스마트 기능 사용 설정: Google Workspace 계정에서 Google Workspace의 스마트 기능과 다른Google 제품의 스마트 기능을 모두 사용 설정합니다. 자세한 내용은 Google Workspace 스마트 기능 사용 설정 또는 사용 중지를 참조하세요.

  • 허용 목록에 OAuth 앱 추가: Google Drive 데이터 스토어는 Google관리 OAuth 앱을 사용하여 데이터에 액세스합니다. 조직에서 OAuth 앱 액세스를 제한하는 경우 Google Workspace 관리자가 이 앱을 조직의 허용 목록에 추가해야 합니다. 자세한 내용은 Google관리 OAuth 앱 허용 목록에 추가를 참고하세요.

  • 교차 조직 액세스 구성(해당하는 경우): 기본적으로 Gemini Enterprise는 사용자의 Google Workspace 고객 ID가 Google Drive 데이터 스토어 및 Google Cloud 프로젝트의 조직과 일치하는 경우에만 사용자가 Google Drive 데이터 스토어를 검색하도록 허용합니다. 사용자 또는 Google Drive 데이터가 다른 Google Workspace 조직에 속한 경우(예: Google Cloud 프로젝트가 한 도메인에 있고 사용자가 하나 이상의 별도 Google Workspace 도메인 또는 테스트 테넌트에서 로그인하는 경우) 다음 단계를 완료합니다.

    1. Cloud Customer Care에 문의하여 각 사용자 Google Workspace 조직의 고객 ID(예: C01234567)를 Google Cloud 프로젝트의 허용 목록에 추가합니다.
    2. 각 Google Workspace 조직의 Google Workspace 관리자가 해당 조직의 Google 관리 콘솔에서 Gemini Enterprise가 Google Workspace 데이터에 액세스하도록 허용을 사용 설정하도록 합니다. Google Cloud 프로젝트의 조직에서만 이 설정을 사용 설정하는 것으로는 충분하지 않습니다. 자세한 내용은 Google Workspace 데이터에 대한 Gemini Enterprise 액세스 제어를 참고하세요.

    또한 사용자가 자신의 조직 외부에서 소유한 문서를 찾아야 하는 경우 앱에 교차 도메인 문서 포함을 사용 설정합니다. 앱을 만들 때 이 옵션을 선택하거나 나중에 웹 앱 기능 관리에서 사용 설정할 수 있습니다.

Google Drive 데이터 스토어 만들기

Google Drive 데이터 스토어를 만들려면 다음 단계를 따르세요.

  1. Google Google Cloud 콘솔에서 Gemini Enterprise 페이지로 이동합니다.

    Gemini Enterprise

  2. Google Cloud 프로젝트를 선택하거나 만듭니다.

  3. 탐색 메뉴에서 데이터 스토어를 클릭합니다.

  4. 데이터 스토어 만들기를 클릭합니다.

  5. 소스 섹션에서 Google Drive를 검색하고 선택을 클릭합니다.

  6. 선택사항: 데이터 섹션에서 데이터 스토어가 검색하는 Google Drive 콘텐츠의 범위를 지정하는 필터를 구성합니다. Google Cloud 콘솔 또는 REST API를 사용하여 필터를 구성하려면 다음 옵션 중 하나를 선택합니다.

    콘솔

    1. 공유 드라이브 ID 필드, 폴더 ID 필드 또는 둘 다에 필터링할 ID를 입력합니다.
    2. 각 필드에서 포함을 선택하여 지정된 ID만 검색하거나 제외를 선택하여 검색에서 생략합니다. 각 필드에 포함 모드 또는 제외 모드 중 하나를 구성합니다.
    3. 폴더 ID 또는 공유 드라이브 ID를 찾으려면 Google Drive에서 폴더 또는 공유 드라이브를 열고 URL에서 ID를 복사합니다. URL은 https://drive.google.com/drive/folders/ID 형식을 따릅니다. 예를 들면 https://drive.google.com/drive/folders/123456789012345678901입니다.

    REST API

    필터가 있는 데이터 스토어를 만들려면 setUpDataConnector 메서드를 호출합니다.

    포함 목록은 admin_filter 아래에 설정되고 제외 목록은 admin_exclusion_filter 아래에 설정됩니다. 각 필터 유형에 대해 admin_filter 또는 admin_exclusion_filter 아래의 목록을 채우되 둘 다 채우지는 않습니다.

       curl -X POST \
       -H "Authorization: Bearer $(gcloud auth print-access-token)" \
       -H "Content-Type: application/json" \
       -H "X-Goog-User-Project: PROJECT_ID" \
       "https://ENDPOINT_LOCATION-discoveryengine.googleapis.com/v1alpha/projects/PROJECT_ID/locations/LOCATION:setUpDataConnector" \
       -d '{
           "collectionId": "COLLECTION_ID",
           "collectionDisplayName": "COLLECTION_DISPLAY_NAME",
           "dataConnector": {
             "dataSource": "google_drive",
             "params": {
               "FILTER_TYPE": {
                 "FILTER_KEY": [
                   "FILTER_VALUE_1",
                   "FILTER_VALUE_2"
                 ]
               }
             },
             "entities": [
               {
                 "entityName": "google_drive"
               }
             ],
             "connectorModes": [
               "FEDERATED"
             ]
           }
       }'
       

    다음을 바꿉니다.

    • PROJECT_ID: 프로젝트의 ID입니다.
    • ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
      • 미국 멀티 리전의 경우 us
      • EU 멀티 리전의 경우 eu
      • 전역 위치의 경우 global
      자세한 내용은 데이터 스토어의 멀티 리전 지정을 참조하세요.
    • LOCATION: 데이터 스토어의 멀티 리전(global 또는 us)
    • COLLECTION_ID: 데이터 스토어의 고유 ID입니다.
    • COLLECTION_DISPLAY_NAME: 데이터 스토어의 표시 이름입니다.
    • FILTER_TYPE: 필터 유형. 포함의 경우 admin_filter, 제외의 경우 admin_exclusion_filter입니다. admin_filter 또는 admin_exclusion_filter 아래에 목록을 채웁니다. 둘 다 채우면 안 됩니다.
    • FILTER_KEY: 필터링할 Drive 항목(SharedDriveIds 또는 FolderIds)입니다.
    • FILTER_VALUE_1, FILTER_VALUE_2: 필터링할 공유 드라이브 ID 또는 폴더 ID입니다.
  7. 작업 섹션의 목록에서 작업을 선택하여 Google Drive 커넥터에 사용 설정합니다.

    작업 목록을 관리하려면 작업 관리를 참고하세요.

  8. 계속을 클릭합니다.

  9. 구성 섹션에서 다음을 수행합니다.

    1. 멀티 리전 목록에서 데이터 커넥터의 위치를 선택합니다.
    2. 데이터 커넥터 이름 필드에 커넥터 이름을 입력합니다.
    3. us 또는 eu를 위치로 선택한 경우 다음과 같이 암호화 설정을 구성합니다.
      • Google관리 암호화 키 또는 Cloud KMS 키를 선택합니다.
      • Cloud KMS 키를 선택한 경우 다음 단계를 따르세요.
        • 키 관리 유형 목록에서 적절한 유형을 선택합니다.
        • Cloud KMS 키 목록에서 키를 선택합니다.
      자세한 내용은 고객 관리 암호화 키를 참조하세요.

  10. 선택사항: 태그 필드에 데이터 스토어의 안정적인 식별자를 입력합니다. 이 식별자는 여러 버전의 커넥터에서 사용되며 데이터 스토어가 생성된 후에는 변경할 수 없으므로 나중에 변경할 필요가 없는 값을 선택하세요.

  11. 선택사항: Sensitive Data Protection 정책 섹션에서 기존 Sensitive Data Protection 콘텐츠 정책을 연결하여 Gemini Enterprise가 이 데이터 스토어를 통해 검색하는 민감한 정보를 검사하고 차단합니다. 자세한 내용은 소스의 민감한 정보 보호를 참조하세요. 조직에 Sensitive Data Protection 콘텐츠 정책이 필요하지 않으면 이 단계를 건너뛰어도 됩니다.

  12. 만들기를 클릭합니다. Gemini Enterprise는 데이터 스토어를 만들고 데이터 스토어 페이지에 데이터 스토어를 표시합니다.

데이터 스토어의 상태를 확인하려면 다음 단계를 따르세요.

  1. 데이터 스토어 목록에서 커넥터로 이동하고 상태가 활성으로 변경될 때까지 모니터링합니다.
  2. 데이터 스토어 상태가 생성 중에서 활성으로 변경되면 Google Drive 커넥터를 사용할 수 있습니다.

데이터 스토어를 만든 후 쿼리를 실행하기 전에 앱을 만들고 Google Drive 데이터 스토어에 연결합니다.

쿼리 실행

Google Drive를 승인한 후 검색어를 입력하면 다음과 같은 결과가 표시됩니다.

  1. Gemini Enterprise는 검색어를 Google Drive API로 전송합니다.

  2. Gemini Enterprise는 결과를 다른 소스의 결과와 혼합하여 표시합니다.

오류 메시지 및 문제 해결

다음 표에서는 이 Google 데이터 소스를 사용할 때 발생할 수 있는 오류 메시지(HTTP 오류 코드 및 권장되는 문제 해결 단계 포함)를 설명합니다.

오류 코드 오류 메시지 설명 문제 해결
403 권한 거부됨 Google Workspace 데이터 스토어에서는 서비스 계정 사용자 인증 정보를 사용한 검색이 지원되지 않습니다. 검색된 엔진에 Google Workspace 데이터 스토어가 있고 전달된 사용자 인증 정보가 서비스 계정의 사용자 인증 정보입니다. Google Workspace 데이터 스토어에서 서비스 계정 사용자 인증 정보를 사용한 검색은 지원되지 않습니다. 사용자 인증 정보를 사용하여 검색을 호출하거나 엔진에서 Google Workspace 데이터 스토어를 삭제합니다.
403 권한 거부됨 Google Workspace 데이터 스토어에서는 일반 계정이 지원되지 않습니다. Google Workspace 데이터 스토어에서 지원되지 않는 일반 계정(@gmail.com) 사용자 인증 정보를 통해 검색이 호출됩니다. 엔진에서 Google Workspace 데이터 스토어를 삭제하거나 관리형 Google 계정을 사용합니다.
403 권한 거부됨 데이터 스토어의 고객 ID가 일치하지 않습니다. 검색은 Google Workspace 고객 ID가 Google Workspace 데이터 스토어 및 Google Cloud 프로젝트의 조직과 일치하는 사용자에게만 허용됩니다. 단, 사용자의 Google Workspace 고객 ID가 프로젝트의 허용 목록에 있는 경우는 예외입니다. 불일치가 의도하지 않은 경우 Google Workspace 사용자와 동일한 조직에 속한 Google Cloud 프로젝트에서 데이터 스토어를 다시 만들거나 앱에서 Google Workspace 데이터 스토어를 삭제합니다. 사용자와 Google Workspace 데이터 스토어가 서로 다른 조직에 있어야 하는 경우 Cloud Customer Care에 문의하여 각 사용자 Google Workspace 고객 ID를 Google Cloud 프로젝트의 허용 목록에 추가하고 각 사용자 조직의 Google Workspace 관리자가 Google Workspace 데이터에 대한 Gemini Enterprise 액세스를 사용 설정하도록 합니다. 또한 사용자가 자신의 조직 외부에서 소유한 문서를 찾아야 하는 경우 웹 앱 기능 관리에서 교차 도메인 문서 포함을 사용 설정합니다.
403 권한 거부됨 조직 관리자가 Agentspace의 Workspace 액세스를 사용 중지했습니다. 사용자의 Google Workspace 조직에 있는 Google Workspace 관리자가 Gemini Enterprise의 Google Workspace 데이터에 대한 액세스를 사용 중지했습니다. Gemini Enterprise 웹 앱에서는 이 오류가 직접 표시되지 않을 수 있으며, 대신 쿼리에서 일치하는 Google Drive 파일을 반환하지 않습니다. 사용자의 Google Workspace 조직의 Google Workspace 관리자에게 문의하여 액세스를 사용 설정하세요. 조직 간 설정에서는 사용자가 Google Drive를 쿼리하는 각 Google Workspace 조직의 Google 관리 콘솔에서 이 설정을 사용 설정해야 합니다.
400 잘못된 인수 요청에 잘못된 인수가 포함되어 있습니다. 이 오류는 요청의 데이터 커넥터 이름이 이름 지정 요구사항을 충족하지 않는 경우에 발생합니다. 데이터 커넥터 이름이 1~63자(영문 기준)이고, 소문자로 시작하고, 소문자 또는 숫자로 끝나며, 소문자, 숫자, 하이픈, 밑줄만 포함하는지 확인합니다. 예를 들어 123456789-cymbal-collection 대신 cymbal-collection-123456789과 같은 이름을 사용합니다.

Google Drive 데이터를 쿼리할 때 발생하는 일반적인 검색 문제는 일반적인 검색 문제를 참고하세요.

다음 단계