Google Chat 데이터 스토어 설정

이 페이지에서는 데이터 스토어를 만들고 Google Chat을 Gemini Enterprise에 연결하는 방법을 설명합니다.

시작하기 전에

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

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

Google Chat 데이터 스토어 만들기

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

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

    Gemini Enterprise

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

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

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

  5. 소스 에서 Google Chat 을 검색하고 선택 을 클릭합니다.

  6. 데이터 섹션에서 필터를 구성하여 색인된 채팅 데이터의 양, 관련성, 개인 정보 보호를 관리합니다. Google Cloud 콘솔 또는 API를 사용하여 데이터 스토어에 필터를 추가할 수 있습니다.

    콘솔

    1. 메시지 최근 방문일 필터 필드에 검색 결과에 색인을 생성할 채팅 기록의 일수를 입력합니다. 예를 들어 90을 입력하면 지난 90일 동안의 메시지만 검색할 수 있으며 오래되고 관련성이 낮은 데이터는 필터링됩니다.
    2. 검색 결과에서 모든 비공개 1:1 채팅 메시지를 제외하려면 채팅 메시지 제외 체크박스를 선택합니다. 사용 설정하면 Google Chat 커넥터는 다중 사용자 스페이스 및 그룹 채팅만 색인합니다.

    REST

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

    

    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_chat",
          "params":{
            "admin_filter":{
              "MessageRecency":RECENCY_DAYS,
              "ExcludeDirectMessages":EXCLUDE_DMS
              }
            },
          "entities":[
            {
              "entityName":"google_chat"
            }],
            "connectorModes":[
              "FEDERATED"
              ]
        }
      }'

    다음을 바꿉니다.

    • PROJECT_ID: 프로젝트의 ID입니다.
    • ENDPOINT_LOCATION: API 요청의 멀티 리전입니다. 다음 값 중 하나를 지정합니다.
      • 미국 멀티 리전의 경우 us
      • EU 멀티 리전의 경우 eu
      • 전역 위치의 경우 global
      자세한 내용은 데이터 스토어의 멀티 리전 지정 을 참조하세요.
    • LOCATION: 데이터 스토어의 멀티 리전입니다: global, us, 또는 eu
    • COLLECTION_ID: 데이터 스토어의 고유 ID입니다.
    • COLLECTION_DISPLAY_NAME: 데이터 스토어의 표시 이름입니다.
    • EXCLUDE_DMS: 불리언 값 (true 또는 false)입니다.
    • RECENCY_DAYS: 메시지 연령 제한을 나타내는 정수입니다. 예를 들어 90입니다.

    필터 유형 및 필터 추가에 대한 자세한 내용은 Google Chat 데이터 스토어에 필터 추가를 참고하세요.

  7. 계속 을 클릭합니다.

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

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

  9. 계속을 클릭합니다.

  10. 결제 섹션에서 일반 가격 또는 구성 가능한 가격을 선택합니다. 자세한 내용은 프로젝트의 결제 상태 확인 및 라이선스를 참조하세요.

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

데이터 스토어 페이지에서 데이터 스토어 이름을 클릭하여 상태를 확인합니다. 데이터 스토어 상태가 생성 중에서 활성으로 변경되면 Google Chat 커넥터를 사용할 수 있습니다.

데이터 스토어를 만든 후 새로 만든 데이터 스토어를 기존 앱에 연결하거나 새 앱을 만들고 새 앱에 연결한 다음 쿼리를 실행하기 전에 Gemini Enterprise가 Google Chat에 액세스하도록 승인합니다.

쿼리 실행

이 섹션에서는 Gemini Enterprise가 쿼리를 관리하는 방법과 제휴 데이터 스토어 사용의 개인 정보 보호 영향을 설명합니다.

Google Chat을 승인하고 Gemini Enterprise에 검색어를 전송하면 다음과 같은 결과가 표시됩니다.

  • Gemini Enterprise는 검색어를 Google Chat API로 직접 전송합니다.
  • Gemini Enterprise는 결과를 연결된 다른 데이터 소스의 결과와 혼합하여 종합적인 검색 결과를 표시합니다.

오류 메시지 및 문제 해결

다음 표에서는 Google Chat 커넥터로 작업할 때 발생할 수 있는 일반적인 오류 메시지를 설명하고 가능한 HTTP 오류 코드와 문제 해결 추천 단계를 포함하고 있습니다.

오류 코드 오류 메시지 설명 문제 해결
403 (Permission Denied) Google Workspace 데이터 스토어에서는 서비스 계정 사용자 인증 정보를 사용한 검색이 지원되지 않습니다. 검색된 엔진에 Google Workspace 데이터 스토어가 있고 전달된 사용자 인증 정보가 서비스 계정의 사용자 인증 정보입니다. Google Workspace 데이터 스토어에서 서비스 계정 사용자 인증 정보를 사용한 검색은 지원되지 않습니다. 사용자 인증 정보를 사용하여 검색을 호출하거나 엔진에서 Google Workspace 데이터 스토어를 삭제합니다.
403 (Permission Denied) Google Workspace 데이터 스토어에서는 일반 계정이 지원되지 않습니다. Google Workspace 데이터 스토어에서 지원되지 않는 일반 계정(@gmail.com) 사용자 인증 정보를 통해 검색이 호출됩니다. 엔진에서 Google Workspace 데이터 스토어를 삭제하거나 관리 Google 계정을 사용합니다.
403 (Permission Denied) 데이터 스토어의 고객 ID가 일치하지 않습니다. 검색은 Google Workspace 데이터 스토어와 동일한 조직에 속한 사용자에게만 허용됩니다. 사용자와 Google Workspace 데이터 스토어가 서로 다른 조직에 있어야 하는 경우에는 엔진에서 Google Workspace 데이터 스토어를 삭제하거나 지원팀에 문의하세요.
403 (Permission Denied) 조직 관리자가 Agent Space의 Workspace 액세스를 사용 중지했습니다. Google Workspace 관리자가 Gemini Enterprise의 Google Workspace 데이터에 대한 액세스를 사용 중지했습니다. Google Workspace 관리자에게 문의하여 액세스를 사용 설정하세요.

다음 단계