設定 Gemini Cloud Assist 的提示和回覆共用功能

本文說明如何使用 Google Cloud 控制台或 API，為專案設定 Gemini Cloud Assist 提示和回覆共用功能。

事前準備

  • 確認 Google Cloud 專案已連結至帳單帳戶。

驗證 IAM 權限

如要設定 Gemini Cloud Assist 的提示和回覆分享功能，您可以授予「Gemini for Google Cloud 設定管理員」 (roles/cloudaicompanion.settingsAdmin) Identity and Access Management (IAM) 預先定義角色，其中包含所有 Gemini for Google Cloud 管理員設定所需的權限。

或者，您也可以使用特定 IAM 權限更新任何自訂 IAM 角色，詳情請參閱下列章節。

設定 Gemini Cloud Assist 提示詞和回覆分享功能

以下各節說明如何設定 Gemini Cloud Assist，讓 Google 根據貴機構的提示和回覆內容改善產品。這項設定會指示 Google 處理專案中所有 Gemini Cloud Assist 使用者的提示詞和回覆，以改善產品，進而提升 Gemini Cloud Assist 的品質。

根據預設，Google 不會檢查使用者輸入並傳送給 Gemini Cloud Assist 的提示，也不會檢查系統傳回的回覆。這樣一來，Google 就無法深入瞭解貴機構重視的主題，以及回覆的品質，進而改進 Gemini Cloud Assist。如果為專案啟用提示和回覆共用功能，Google 最多會儲存專案提交的匿名提示和回覆兩年。我們絕不會使用貴機構的提示和回覆，訓練或微調任何 LLM 模型。

如果啟用與 Google 分享提示和回覆，隨時可以前往 Google Cloud 控制台的「Gemini 管理」頁面停用這項功能。

啟用 Gemini Cloud Assist 的提示和回覆共用功能

選取下列選項之一：

主控台

  1. 確認您在擁有訂閱項目的專案中，具備下列身分與存取權管理 (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. 確認您在擁有訂閱項目的專案中，具備下列身分與存取權管理 (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。例如，使用 dswg1b1 代表 Data Sharing with Google。

    如果指令成功執行，則會傳回下列格式的作業中繼資料：

    {
  "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. 請確認您在要修改設定的專案中，具備下列身分與存取權管理 (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. 按一下「停用資料共用功能」，停止與 Google 分享專案中所有 Gemini Cloud Assist 使用者的提示詞和回覆。

API

如要停用 Gemini Cloud Assist 的資料共用功能，請使用 DeleteDataSharingWithGoogleSetting 方法。

  1. 請確認您在要修改設定的專案中，具備下列身分與存取權管理 (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
}

後續步驟