为 Google Cloud 管理员设置配置 Gemini

本文档介绍了如何访问和使用 Gemini forGoogle Cloud 管理员设置,为项目中的所有用户配置更改。您可以使用 Google Cloud 控制台或 API 管理管理员设置。

(可选)将权限绑定到设置和目标

如果您是在 Google Cloud 控制台中为 Google Cloud管理员设置配置 Gemini,则可以跳过此部分。

如需使用 Gemini for Google Cloud API 配置 Gemini Google Cloud 管理员设置,您必须先创建设置,然后创建绑定,以便将这些设置和目标(例如实例、主题或项目)“绑定”到特定产品(例如 Gemini Cloud Assist 或 Gemini Code Assist)。

创建和更新设置的所有权限均在项目级别。

配置 Gemini Cloud Assist 以与 Google 共享提示和回答

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

默认情况下,Google 无权记录或检查用户输入并发送给 Gemini Cloud Assist 的提示,也无法查看系统发回的回答。这会限制 Google 更好地了解对贵组织而言哪些主题很重要,以及我们的回答效果如何,进而改进 Gemini Cloud Assist。如果您为项目启用问题和回答共享功能,Google 最多会将从项目中提交的匿名问题和回答存储 180 天。贵组织的提示和回答绝不会用于训练或微调任何 LLM 模型。

如果您启用了与 Google 分享问题和回答的功能,则可以随时访问 Google Cloud 控制台中的 Gemini 管理页面,停用此功能

为 Gemini Cloud Assist 启用提示和回答共享

从下列选项中选择一项:

控制台

  1. 确保您对拥有订阅的结算账号拥有以下 Identity and Access Management (IAM) 权限:

    • 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 共享提示和回答。

Google 对此类数据的使用受 Google Cloud 协议(包括Google Cloud 服务专用条款的非正式版产品条款)的约束,以及 Gemini for Google Cloud 可信测试员计划的条款。

API

如需为 Gemini Cloud Assist 启用数据共享,请使用 CreateDataSharingWithGoogleSetting 方法。

  1. 确保您对拥有订阅的结算账号拥有以下 Identity and Access Management (IAM) 权限:

    • 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. 设置地区性 API:

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
          "enable_customer_data_sharing": true,
        } ' -X POST "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=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
      }
      
  3. 创建设置绑定:

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

Google 对此类数据的使用受 Google Cloud 协议(包括Google Cloud 服务专用条款的非正式版产品条款)的约束,以及 Gemini for Google Cloud 可信测试员计划的条款。

停用 Gemini Cloud Assist 的提示和回答共享功能

从下列选项中选择一项:

控制台

  1. 确保您在要修改设置的项目上拥有以下 Identity and Access Management (IAM) 权限:

    • 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. 确保您在要修改设置的项目上拥有以下 Identity and Access Management (IAM) 权限:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse
  2. 创建设置和设置专用值。

    1. 获取令牌:

      TOKEN=$(gcloud auth print-access-token)
      
    2. 设置地区性 API:

      REGIONAL_API="cloudaicompanion.googleapis.com"
      
    3. 运行以下命令以创建设置。

      curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
          "enable_customer_data_sharing": false,
        } ' -X POST "https://$REGIONAL_API/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"
      

      替换以下内容:

      • CONTAINER_PROJECT_NAME:输入父级项目 ID。
      • SETTING_ID:输入现有设置名称,例如 Data Sharing with Googledswg1

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