为 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 Settings Admin (roles/cloudaicompanion.settingsAdmin) IAM 预定义角色，该角色包含所有 Gemini for Google Cloud 管理员设置所需的所有权限。

配置 Gemini Cloud Assist 提示与回答共享功能

以下部分介绍了配置 Gemini Cloud Assist 以与 Google 分享贵组织的提示和回答以改进产品所需的步骤。此设置会指示 Google 处理项目中所有 Gemini Cloud Assist 用户的提示和回答，以便改进产品，这有助于 Google 改进 Gemini Cloud Assist。

默认情况下，Google 不会检查用户输入并发送到 Gemini Cloud Assist 的提示，也不会检查发回的回答。这会限制 Google 改进 Gemini Cloud Assist 的能力，因为我们无法更好地了解哪些主题对贵组织很重要，以及我们的回答效果如何。如果您为某个项目启用了提示和回答共享，Google 会将从该项目提交的匿名提示和回答最多存储两年。贵组织的提示和回答绝不会被用于训练或微调任何 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：输入唯一的设置名称，例如输入 dswg1 作为 Data Sharing with Google 的名称。

      如果命令成功，则会返回一个回答正文，其中显示 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：输入现有设置名称，例如输入 dswg1 作为 Data Sharing with Google 的名称。

      如果命令成功，则会返回一个回答正文，其中显示 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
}

后续步骤