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

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

이 설정을 사용 설정하면 Google은 제품 개선을 위해 프로젝트의 모든 Gemini Cloud Assist 사용자의 프롬프트와 대답을 처리합니다. 이는 Google이 Gemini Cloud Assist를 개선하는 데 도움이 됩니다. Google은 프로젝트에서 제출된 익명 처리된 프롬프트와 응답을 최대 2년 동안 저장합니다. 조직의 프롬프트와 응답은 LLM 모델을 학습하거나 미세 조정하는 데 결코 사용되지 않습니다.

이 설정은 언제든지 변경할 수 있습니다.

시작하기 전에

Gemini Cloud Assist의 프롬프트 및 응답 공유를 구성하는 데 필요한 권한을 얻으려면 관리자에게 Gemini Cloud Assist 관리자 설정 보기 및 수정에 필요한 모든 필수 권한이 포함된 Gemini Cloud Assist 관리자 (roles/geminicloudassist.admin) Identity and Access Management (IAM) 사전 정의된 역할을 부여해 달라고 요청하세요.

필요한 정확한 권한을 보려면 필수 권한 섹션을 확장하세요.

필수 권한

  • cloudaicompanion.dataSharingWithGoogleSettings.create
  • cloudaicompanion.dataSharingWithGoogleSettings.update
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
    • 직접 API 요청을 사용하는 경우 이 권한은 특히 TARGET_PROJECT에 필요합니다.

Google Cloud 콘솔을 사용하는 경우 필요한 추가 권한은 다음과 같습니다.

  • cloudaicompanion.instance.queryEffectiveSetting
  • cloudaicompanion.instance.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • settingBindings.dataSharingWithGoogleSettingsUpdate
  • settingBindings.dataSharingWithGoogleSettingsDelete

다른 사전 정의된 역할이나 커스텀 역할을 사용하여 이러한 권한을 부여받을 수도 있습니다.

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

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

콘솔

  1. Google Cloud 콘솔을 엽니다.

    Google Cloud 콘솔로 이동

  2. Google Cloud 콘솔의 페이지에서 spark Gemini Cloud Assist 채팅 열기 또는 닫기를 클릭합니다.

    Cloud Assist 패널이 열립니다.

  3. 작업 더보기 ()를 클릭한 다음 드롭다운 메뉴에서 Cloud Assist 설정을 클릭합니다.

    Gemini Cloud Assist 관리 설정 패널이 열립니다.

  4. Gemini Cloud Assist 데이터 공유 섹션에서 프롬프트와 대답을 공유하여 Google이 Gemini Cloud Assist를 개선할 수 있도록 도와주세요가 선택되어 있는지 확인합니다.

  5. 저장을 클릭합니다.

API

Gemini Cloud Assist의 데이터 공유를 사용 설정하려면 dataSharingWithGoogleSettings.create 메서드로 설정을 만들고 연결된 settingBindings.create 메서드를 사용하여 설정을 적용합니다.

  1. 설정 및 설정별 값을 만듭니다.

    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 사용을 위한 인증을 참조하세요.

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

      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. Google Cloud 콘솔을 엽니다.

    Google Cloud 콘솔로 이동

  2. Google Cloud 콘솔의 페이지에서 spark Gemini Cloud Assist 채팅 열기 또는 닫기를 클릭합니다.

    Cloud Assist 패널이 열립니다.

  3. 작업 더보기 ()를 클릭한 다음 드롭다운 메뉴에서 Cloud Assist 설정을 클릭합니다.

    Gemini Cloud Assist 관리 설정 패널이 열립니다.

  4. Gemini Cloud Assist를 위한 데이터 공유 섹션에서 프롬프트와 대답을 공유하여 Google이 Gemini Cloud Assist를 개선할 수 있도록 도와주세요가 선택되어 있지 않은지 확인합니다.

  5. 저장을 클릭합니다.

API

Gemini Cloud Assist의 프롬프트 및 응답 공유를 사용 중지하려면 dataSharingWithGoogleSettings.patch 메서드를 사용합니다.

  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
}

다음 단계