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 관리자** (roles/geminicloudassist.admin) Identity and Access Management (IAM) 사전 정의된 역할에는 Gemini Cloud Assist 관리자 설정을 보고 수정하는 데 필요한 모든 필수 권한이 포함되어 있습니다.

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

필수 권한

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

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

  • cloudaicompanion.instances.queryEffectiveSetting
  • cloudaicompanion.instances.queryEffectiveSettingBindings
  • cloudaicompanion.dataSharingWithGoogleSettings.list
  • cloudaicompanion.dataSharingWithGoogleSettings.get
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsGet
  • cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUpdate
  • cloudaicompanion.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/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

      다음을 바꿉니다.

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

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

      {
  "name": "projects/CONTAINER_PROJECT/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",
      "product": "GEMINI_CLOUD_ASSIST"
      }' \
    "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings?settingBindingId=BINDING_ID"

    다음을 바꿉니다.

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

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

    {
  "name": "projects/CONTAINER_PROJECT/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/TARGET_PROJECT/locations/global/dataSharingWithGoogleSettings/SETTING_ID/settingBindings/BINDING_ID",
    "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/locations/global/dataSharingWithGoogleSettings?dataSharingWithGoogleSettingId=SETTING_ID"

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

    다음을 바꿉니다.

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

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

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

다음 단계