Google Cloud를 위한 Gemini 관리자 구성

이 문서에서는Google Cloud 관리자 설정을 위한 Gemini에 액세스하고 사용하여 프로젝트의 모든 사용자에 대한 변경사항을 구성하는 방법을 설명합니다. Google Cloud 콘솔이나 API를 사용하여 프로젝트의 관리자 설정을 관리할 수 있습니다.

시작하기 전에

  • Google Cloud 프로젝트가 결제 계정에 연결되어 있는지 확인합니다.

폴더의 프로젝트 설정 구성

폴더의 모든 API에 Gemini Cloud Assist를 사용 설정하면 모든 Gemini Cloud Assist 설정이 기본적으로 사용 중지됩니다. 폴더의 각 프로젝트에 대한 설정을 수정해야 합니다.

(선택사항) 설정 및 대상에 권한 바인딩

Google Cloud 콘솔에서 Google Cloud관리자 설정을 위한 Gemini를 구성하는 경우 이 섹션을 건너뛸 수 있습니다.

Gemini for Google Cloud API를 사용하여 Google Cloud 관리자 설정을 위한 Gemini를 구성하려면 먼저 설정을 만든 후 특정 제품(예: Gemini Cloud Assist 또는 Gemini Code Assist)의 설정과 대상(예: 인스턴스, 주제 또는 프로젝트)을 '바인딩'하는 바인딩을 만들어야 합니다.

설정을 만들고 업데이트할 수 있는 모든 권한은 프로젝트 수준입니다.

프롬프트 및 응답을 Google과 공유하도록 Gemini Cloud Assist 구성

다음 섹션에서는 제품 향상을 위해 조직의 프롬프트와 응답을 Google과 공유하도록 Gemini Cloud Assist를 구성하는 데 필요한 단계를 설명합니다. 이 설정은 Google에 제품 향상을 위해 프로젝트의 모든 Gemini Cloud Assist 사용자의 프롬프트와 응답을 처리하도록 지시합니다. 이는 Google이 Gemini Cloud Assist를 향상시키는 데 도움이 됩니다.

기본적으로 Google은 사용자가 입력하여 Gemini Cloud Assist로 전송하는 프롬프트나 다시 전송되는 응답을 로깅하거나 검사할 수 없습니다. 이렇게 하면 Google에서 조직에 중요한 주제와 Google의 응답이 얼마나 효과적인지 더 잘 이해하여 Gemini Cloud Assist를 향상시키는 데 제약이 발생합니다. 프로젝트에 프롬프트 및 응답 공유를 사용 설정하면 Google은 프로젝트에서 제출된 익명 처리된 프롬프트와 응답을 최대 180일 동안 저장합니다. 조직의 프롬프트와 응답은 LLM 모델을 학습하거나 미세 조정하는 데 결코 사용되지 않습니다.

Google과 프롬프트 및 응답 공유를 사용 설정한 경우 언제든지 Google Cloud 콘솔의 Gemini 관리자 페이지로 이동하여 사용 중지할 수 있습니다.

Gemini Cloud Assist의 프롬프트 및 응답 공유 사용 설정

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

콘솔

  1. 구독을 소유한 프로젝트에 다음 Identity and Access Management(IAM) 권한이 있는지 확인합니다.

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. Google Cloud 콘솔에서 Gemini 관리자 페이지로 이동합니다.

    Google Cloud를 위한 Gemini로 이동

    Google Cloud를 위한 Gemini 페이지가 로드됩니다.

  3. 왼쪽 탐색 메뉴에서 설정을 클릭합니다.

    설정 페이지가 로드됩니다.

  4. 데이터 공유 사용 설정을 클릭하여 프로젝트에 있는 모든 Gemini Cloud Assist 사용자의 프롬프트와 응답을 Google과 공유합니다.

Google의 이 데이터 사용에는 Google Cloud 계약(Google Cloud 서비스별 약관의 GA 이전 서비스 약관이 포함되며 Google Cloud 를 위한 Gemini 신뢰할 수 있는 테스터 프로그램의 약관에 의해 보완됨)의 규제를 받습니다.

API

Gemini Cloud Assist의 데이터 공유를 사용 설정하려면 CreateDataSharingWithGoogleSetting 메서드를 사용합니다.

  1. 구독을 소유한 프로젝트에 다음 Identity and Access Management(IAM) 권한이 있는지 확인합니다.

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. 설정 및 설정별 값을 만듭니다.

    1. 토큰을 가져옵니다.

      TOKEN=$(gcloud auth print-access-token)
      
    2. 리전별 API를 설정합니다.

      REGIONAL_API="cloudaicompanion.googleapis.com"
      
    3. 다음 명령어를 실행하여 설정을 만듭니다.

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
          "enable_customer_data_sharing": true,
        } ' -X POST "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"
      

      다음을 바꿉니다.

      • CONTAINER_PROJECT_NAME: 상위 프로젝트 ID를 입력합니다.
      • SETTING_ID: 고유한 설정 이름을 입력합니다(예: Data Sharing with Google의 경우 dswg1).

      명령어가 성공하면 enablePreviewDataSharingtrue로 설정된 응답 본문이 반환됩니다.

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/dataSharingWithGoogleSettings/SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "enablePreviewDataSharing": true
      }
      
  3. 설정 바인딩을 만듭니다.

      curl \
      -H "Authorization: Bearer $TOKEN" \
      -H 'Content-Type: application/json' \
      -d '{
          "target": "projects/TARGET_PROJECT_NAME",
          "product": "GEMINI_CLOUD_ASSIST"
        }' \
      -X POST \ "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?setting_binding_id=BINDING_ID"
    

    다음을 바꿉니다.

    • TARGET_PROJECT_NAME: 설정을 적용할 대상 프로젝트를 입력합니다.
    • SETTING_ID: 설정을 만들 때 같은 SETTING_ID를 사용하지만 b1를 추가합니다. 예를 들면 Data Sharing with Google의 경우 dswg1b1을 사용합니다.

    명령어가 성공하면 다음 형식의 작업 메타데이터가 반환됩니다.

    {
    "name": "projects/<var>CONTAINER_PROJECT_NAME</var>/locations/global/operations/operation-1737646069712-62c6140bb04bb-49261230-43701daf",
    "metadata": {
      "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
      "createTime": "2025-01-23T15:27:50.076075570Z",
      "target": "projects/<var>TARGET_PROJECT_NAME</var>/locations/global/dataSharingWithGoogleSettings/<var>SETTING_ID</var>/settingBindings/<var>BINDING_ID</var>",
      "verb": "create",
      "requestedCancellation": false,
      "apiVersion": "v1"
    },
    "done": false
    }
    

Google의 이 데이터 사용에는 Google Cloud 계약(Google Cloud 서비스별 약관의 GA 이전 서비스 약관이 포함되며 Google Cloud 를 위한 Gemini 신뢰할 수 있는 테스터 프로그램의 약관에 의해 보완됨)의 규제를 받습니다.

Gemini Cloud Assist의 프롬프트 및 응답 공유 사용 중지

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

콘솔

  1. 설정을 수정하려는 프로젝트에 대한 다음 Identity and Access Management(IAM) 권한이 있는지 확인합니다.

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. Google Cloud 콘솔에서 Gemini 관리자 페이지로 이동합니다.

    Google Cloud를 위한 Gemini로 이동

    Google Cloud를 위한 Gemini 페이지가 로드됩니다.

  3. 왼쪽 탐색 메뉴에서 설정을 클릭합니다.

    설정 페이지가 로드됩니다.

  4. 데이터 공유 사용 중지를 클릭하여 프로젝트에 있는 모든 Gemini Cloud Assist 사용자의 프롬프트와 응답을 Google과 공유하는 것을 중지합니다.

API

Gemini Cloud Assist의 데이터 공유를 사용 중지하려면 DeleteDataSharingWithGoogleSetting 메서드를 사용합니다.

  1. 설정을 수정하려는 프로젝트에 대한 다음 Identity and Access Management(IAM) 권한이 있는지 확인합니다.

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. 지정된 설정의 프롬프트 및 응답 공유를 사용 중지합니다.

    1. 토큰을 가져옵니다.

      TOKEN=$(gcloud auth print-access-token)
      
    2. 리전별 API를 설정합니다.

      REGIONAL_API="cloudaicompanion.googleapis.com"
      
    3. 다음 명령어를 실행하여 설정을 사용 중지합니다.

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
          "enable_customer_data_sharing": false,
        } ' -X PATCH "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"
      

      PATCH 명령어는 설정 리소스가 프롬프트 및 응답 공유를 사용 설정한 시점부터 이미 있는 경우에만 성공합니다.

      다음을 바꿉니다.

      • CONTAINER_PROJECT_NAME: 상위 프로젝트 ID를 입력합니다.
      • SETTING_ID: 기존 설정 이름을 입력합니다(예: Data Sharing with Google의 경우 dswg1).

      명령어가 성공하면 enablePreviewDataSharingfalse로 설정된 응답 본문이 반환됩니다.

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/dataSharingWithGoogleSettings/SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "enablePreviewDataSharing": false
      }
      

다음 단계