Gemini Cloud Assist의 프롬프트 및 응답 공유 구성

이 문서에서는 Google Cloud 콘솔 또는 API를 사용하여 프로젝트의 Gemini Cloud Assist 프롬프트 및 응답 공유를 구성하는 방법을 설명합니다.

시작하기 전에

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

(선택사항) IAM 권한 부여

Gemini Cloud Assist의 프롬프트 및 응답 공유를 구성하려면 다음 섹션에 자세히 설명된 특정 Identity and Access Management(IAM) 권한이 있어야 합니다. 이러한 권한이 커스텀 IAM 역할에 추가되었는지 확인합니다.

또는 Gemini for Google Cloud 설정 관리자(roles/cloudaicompanion.settingsAdmin) IAM 사전 정의된 역할을 부여할 수 있습니다. 이 역할에는 Gemini for Google Cloud 의 모든 관리자 설정에 필요한 필수 권한이 모두 포함되어 있습니다.

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은 프로젝트에서 제출된 익명 처리된 프롬프트와 응답을 최대 2년 동안 저장합니다. 조직의 프롬프트와 응답은 LLM 모델을 학습하거나 미세 조정하는 데 결코 사용되지 않습니다.

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

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

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

콘솔

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

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Google Cloud 콘솔에서 Gemini 관리자 페이지로 이동합니다.

    Gemini for Google Cloud로 이동

    Gemini for Google Cloud 페이지가 로드됩니다.

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

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

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

API

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

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

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • 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. 다음 명령어를 실행하여 설정을 만듭니다.

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enablePreviewDataSharing": true
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

      다음을 바꿉니다.

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

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

      {
  "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
}

      인증에 대한 자세한 내용은 REST 사용을 위한 인증을 참고하세요.

  3. 설정 바인딩을 만듭니다.

      curl -X POST \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Content-Type: application/json' \
    -d '{
      "target": "projects/TARGET_PROJECT_NAME",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=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
}

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

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

콘솔

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

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Google Cloud 콘솔에서 Gemini 관리자 페이지로 이동합니다.

    Gemini for Google Cloud로 이동

    Gemini for Google Cloud 페이지가 로드됩니다.

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

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

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

API

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

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

    • instance.queryEffectiveSetting
    • instance.queryEffectiveSettingBindings
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. 지정된 설정의 프롬프트 및 응답 공유를 사용 중지합니다.

    1. 토큰을 가져옵니다.

      TOKEN=$(gcloud auth print-access-token)

    2. 다음 명령어를 실행하여 설정을 사용 중지합니다.

      curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enablePreviewDataSharing": false
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

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

      다음을 바꿉니다.

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

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

      {
  "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
}

다음 단계