Định cấu hình tính năng chia sẻ câu lệnh và câu trả lời cho tính năng Trợ lý trên đám mây của Gemini

Tài liệu này mô tả cách định cấu hình lời nhắc và tính năng chia sẻ phản hồi của Gemini Cloud Assist cho một dự án bằng cách sử dụng bảng điều khiển Google Cloud hoặc API.

Trước khi bạn bắt đầu

  • Đảm bảo dự án Google Cloud của bạn được đính kèm với một tài khoản thanh toán.

(Không bắt buộc) Cấp quyền IAM

Để định cấu hình tính năng chia sẻ câu lệnh và câu trả lời cho tính năng Trợ lý trên đám mây của Gemini, bạn phải có các quyền Quản lý danh tính và quyền truy cập (IAM) cụ thể. Các quyền này được nêu chi tiết trong các phần sau. Hãy đảm bảo bạn thêm các quyền này vào vai trò IAM tuỳ chỉnh.

Ngoài ra, bạn có thể cấp vai trò IAM được xác định trước Quản trị viên chế độ cài đặt Gemini cho Google Cloud (roles/cloudaicompanion.settingsAdmin). Vai trò này bao gồm tất cả các quyền cần thiết cho tất cả chế độ cài đặt của quản trị viên Gemini cho Google Cloud .

(Không bắt buộc) Liên kết quyền với chế độ cài đặt và mục tiêu

Nếu đang định cấu hình Gemini cho Google Cloud chế độ cài đặt quản trị viên trong bảng điều khiển Google Cloud , thì bạn có thể bỏ qua phần này.

Để định cấu hình Gemini cho Google Cloud chế độ cài đặt quản trị viên bằng Gemini cho API Google Cloud, trước tiên, bạn phải tạo chế độ cài đặt, sau đó tạo liên kết để "liên kết" các chế độ cài đặt và mục tiêu đó (chẳng hạn như phiên bản, chủ đề hoặc dự án) cho các sản phẩm cụ thể (chẳng hạn như Trợ lý trên đám mây Gemini hoặc Trợ lý mã Gemini).

Tất cả quyền tạo và cập nhật chế độ cài đặt đều ở cấp dự án.

Định cấu hình tính năng chia sẻ câu lệnh và câu trả lời của Trợ lý trên đám mây Gemini

Các phần sau đây trình bày các bước cần thiết để định cấu hình Gemini Cloud Assist nhằm chia sẻ câu lệnh và câu trả lời của tổ chức với Google để cải thiện sản phẩm. Chế độ cài đặt này hướng dẫn Google xử lý các câu lệnh và câu trả lời của tất cả người dùng Gemini Cloud Assist trong dự án cho mục đích cải thiện sản phẩm, giúp Google cải thiện Gemini Cloud Assist.

Theo mặc định, Google không có quyền ghi nhật ký hoặc kiểm tra các câu lệnh mà người dùng nhập và gửi đến Trợ lý trên đám mây của Gemini, cũng như các câu trả lời được gửi lại. Điều này hạn chế khả năng của Google trong việc cải thiện Gemini Cloud Assist bằng cách hiểu rõ hơn về những chủ đề quan trọng đối với tổ chức của bạn và mức độ hiệu quả của câu trả lời của chúng tôi. Nếu bạn bật tính năng chia sẻ câu lệnh và câu trả lời cho một dự án, Google sẽ lưu trữ các câu lệnh và câu trả lời được ẩn danh mà dự án gửi trong tối đa 180 ngày. Chúng tôi tuyệt đối không dùng câu lệnh và câu trả lời của tổ chức bạn để huấn luyện hoặc tinh chỉnh bất kỳ mô hình LLM nào.

Nếu bật tính năng chia sẻ câu lệnh và câu trả lời với Google, bạn có thể tắt tính năng này bất cứ lúc nào bằng cách truy cập vào trang Quản trị viên cho Gemini trong bảng điều khiển Google Cloud .

Bật tính năng chia sẻ câu lệnh và câu trả lời cho tính năng Trợ giúp trên đám mây của Gemini

Chọn một trong các tùy chọn sau:

Bảng điều khiển

  1. Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (IAM) sau đây trên dự án sở hữu gói thuê bao:

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Trong bảng điều khiển Google Cloud , hãy chuyển đến trang Quản trị viên cho Gemini.

    Chuyển đến Gemini để Google Cloud

    Trang Gemini cho Google Cloud sẽ tải.

  3. Nhấp vào Cài đặt trong trình đơn điều hướng bên trái.

    Trang Cài đặt sẽ tải.

  4. Nhấp vào Bật tính năng chia sẻ dữ liệu để chia sẻ câu lệnh và câu trả lời với Google cho tất cả người dùng tính năng Trợ lý trên đám mây của Gemini trong dự án.

Việc Google sử dụng dữ liệu này chịu sự điều chỉnh của Google Cloud Thoả thuận, bao gồm cả Điều khoản cung cấp trước khi phát hành công khai của Google Cloud Điều khoản dịch vụ cụ thể, được bổ sung bằng các điều khoản của Chương trình Gemini dành cho Google Cloud Người kiểm tra đáng tin cậy.

Giao diện lập trình ứng dụng (API)

Để bật tính năng chia sẻ dữ liệu cho tính năng Trợ lý trên đám mây của Gemini, hãy sử dụng phương thức CreateDataSharingWithGoogleSetting.

  1. Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (IAM) sau đây trên dự án sở hữu gói thuê bao:

    • dataSharingWithGoogleSettings.create
    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • dataSharingWithGoogleSettings.update
    • settingBindings.dataSharingWithGoogleSettingsCreate
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Tạo chế độ cài đặt và giá trị dành riêng cho chế độ cài đặt:

    1. Lấy mã thông báo xác thực:

      TOKEN=$(gcloud auth print-access-token)

    2. Chạy lệnh sau để tạo chế độ cài đặt:

      curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enable_customer_data_sharing": true
    }' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"

      Thay thế nội dung sau:

      • CONTAINER_PROJECT_NAME: Nhập mã dự án mẹ.
      • SETTING_ID: Nhập một tên chế độ cài đặt riêng biệt, chẳng hạn như dswg1 cho Data Sharing with Google.

      Nếu thành công, lệnh này sẽ trả về một nội dung phản hồi cho biết enablePreviewDataSharing được đặt thành 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
}

      Để biết thêm thông tin về việc xác thực, hãy xem phần Xác thực để sử dụng REST.

  3. Tạo liên kết cài đặt:

      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?setting_binding_id=BINDING_ID"

    Thay thế nội dung sau:

    • TARGET_PROJECT_NAME: Nhập dự án mục tiêu mà bạn muốn áp dụng chế độ cài đặt.
    • SETTING_ID: Sử dụng cùng một SETTING_ID khi bạn tạo chế độ cài đặt, nhưng thêm b1 vào. Ví dụ: sử dụng dswg1b1 cho Data Sharing with Google.

    Nếu thành công, lệnh này sẽ trả về siêu dữ liệu thao tác ở định dạng sau:

    {
  "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
}

Việc Google sử dụng dữ liệu này chịu sự điều chỉnh của Google Cloud Thoả thuận, bao gồm cả Điều khoản cung cấp trước khi phát hành công khai của Google Cloud Điều khoản dịch vụ cụ thể, được bổ sung bằng các điều khoản của Chương trình Gemini dành cho Google Cloud Người kiểm tra đáng tin cậy.

Tắt tính năng chia sẻ câu lệnh và câu trả lời cho tính năng Trợ giúp trên đám mây của Gemini

Chọn một trong các tùy chọn sau:

Bảng điều khiển

  1. Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (IAM) sau đây trên dự án mà bạn muốn sửa đổi chế độ cài đặt:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsDelete
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Trong bảng điều khiển Google Cloud , hãy chuyển đến trang Quản trị viên cho Gemini.

    Chuyển đến Gemini để Google Cloud

    Trang Gemini cho Google Cloud sẽ tải.

  3. Nhấp vào Cài đặt trong trình đơn điều hướng bên trái.

    Trang Cài đặt sẽ tải.

  4. Nhấp vào Tắt tính năng chia sẻ dữ liệu để ngừng chia sẻ câu lệnh và câu trả lời với Google cho tất cả người dùng Gemini Cloud Assist trong dự án.

Giao diện lập trình ứng dụng (API)

Để tắt tính năng chia sẻ dữ liệu cho tính năng Trợ lý trên đám mây của Gemini, hãy sử dụng phương thức DeleteDataSharingWithGoogleSetting.

  1. Đảm bảo rằng bạn có các quyền Quản lý danh tính và quyền truy cập (IAM) sau đây trên dự án mà bạn muốn sửa đổi chế độ cài đặt:

    • dataSharingWithGoogleSettings.list
    • dataSharingWithGoogleSettings.delete
    • dataSharingWithGoogleSettings.get
    • settingBindings.dataSharingWithGoogleSettingsGet
    • settingBindings.dataSharingWithGoogleSettingsUpdate
    • settingBindings.dataSharingWithGoogleSettingsUse

  2. Tắt tính năng chia sẻ câu lệnh và câu trả lời cho chế độ cài đặt đã chỉ định:

    1. Lấy mã thông báo:

      TOKEN=$(gcloud auth print-access-token)

    2. Chạy lệnh sau để tắt chế độ cài đặt:

      curl -X PATCH \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "enable_customer_data_sharing": false
    } ' \
  "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings?data_sharing_with_google_setting_id=SETTING_ID"

      Lệnh PATCH này chỉ thành công nếu tài nguyên cài đặt đã tồn tại từ khi bạn bật tính năng chia sẻ câu lệnh và câu trả lời.

      Thay thế nội dung sau:

      • CONTAINER_PROJECT_NAME: Nhập mã dự án mẹ.
      • SETTING_ID: Nhập tên chế độ cài đặt hiện có, chẳng hạn như dswg1 cho Data Sharing with Google.

      Nếu thành công, lệnh này sẽ trả về một nội dung phản hồi cho biết enablePreviewDataSharing được đặt thành 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
}

Bước tiếp theo