Thiết lập tính năng Trợ giúp trên đám mây của Gemini

Bảng điều khiển

1. Chuyển đến trang Quản trị viên của Gemini.

   Chuyển đến Gemini cho Google Cloud

2. Trong bộ chọn dự án ở đầu trang, hãy chọn tài nguyên dự án của bạn.

3. Chọn Nhận tính năng Hỗ trợ trên đám mây của Gemini.

4. Trong hộp thoại Get Gemini Cloud Assist (Nhận tính năng hỗ trợ trên đám mây của Gemini), hãy làm như sau:

   1. Chọn mũi tên mở rộng expand_more trong phần API bắt buộc và nên dùng.

   2. Đảm bảo bạn đã bật các API bắt buộc sau: API hỗ trợ trên đám mây Gemini và API Gemini cho Google Cloud.

   3. Trong danh sách API được đề xuất, hãy chọn các API bạn muốn bật.

   4. Không bắt buộc: Chọn Giúp Google cải thiện tính năng Trợ lý trên đám mây bằng cách chia sẻ câu lệnh và câu trả lời của bạn.

   5. Chọn Bật tính năng Hỗ trợ trên đám mây của Gemini mà không mất phí.

5. Nhấp vào Lưu.

6. Cấp các vai trò IAM cần thiết để sử dụng tính năng Trợ lý trên đám mây của Gemini.

   1. Chuyển đến trang Quản trị và quản lý danh tính và quyền truy cập (IAM).

      Chuyển đến phần Quản trị và IAM

   2. Trong cột Chủ sở hữu, hãy tìm một chủ sở hữu mà bạn muốn cấp quyền truy cập vào Gemini Cloud Assist, sau đó nhấp vào edit Chỉnh sửa chủ sở hữu trong hàng đó.

   3. Trong ngăn Chỉnh sửa quyền truy cập, hãy nhấp vào biểu tượng add Thêm vai trò khác.

   4. Trong phần Chọn vai trò, hãy chọn Người dùng hỗ trợ trên đám mây của Gemini.

   5. Nhấp vào Thêm vai trò khác rồi chọn Người xem đề xuất.

   Nếu người dùng chính muốn được hỗ trợ về các sản phẩm mà họ chưa có quyền truy cập, thì bạn có thể cần cấp cho họ các vai trò IAM bổ sung. Hãy xem bài viết Yêu cầu về IAM để sử dụng tính năng Trợ giúp trên đám mây của Gemini để biết bảng các vai trò IAM giúp bạn có trải nghiệm tối ưu với tính năng Trợ giúp trên đám mây của Gemini cho nhiều sản phẩm.

gcloud

1. In the Google Cloud console, activate Cloud Shell.

   Activate Cloud Shell

2. Bật Gemini Cloud Assist API bằng lệnh gcloud services enable:

   gcloud services enable geminicloudassist.googleapis.com
   

   Bước này cũng bật API Gemini cho Google Cloud. API này cũng là yêu cầu để sử dụng tính năng Trợ lý trên đám mây của Gemini.

   Nếu bạn muốn bật Gemini Cloud Assist API trong một dự ánGoogle Cloud khác, hãy thêm tham số --project:

   gcloud services enable geminicloudassist.googleapis.com --project PROJECT_ID
   

   Kết quả sẽ tương tự như sau:

   Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
   Operation finished successfully.
   

3. Cấp vai trò IAM trong một dự án Google Cloud . Để biết thêm thông tin, hãy xem phần Cấp một vai trò và gcloud projects add-iam-policy-binding.

   1. Cấp vai trò roles/geminicloudassist.user:

      gcloud projects add-iam-policy-binding PROJECT_ID \
        --member=PRINCIPAL --role=roles/geminicloudassist.user
      

      Thay thế nội dung sau:

      • PROJECT_ID: mã nhận dạng của dự ánGoogle Cloud ,ví dụ: 1234567890.
      • PRINCIPAL: giá trị nhận dạng cho tài khoản chính, ví dụ: user:cloudysanfrancisco@gmail.com.

      Kết quả là danh sách các liên kết chính sách bao gồm:

      - members:
        - user:PRINCIPAL
        role: roles/geminicloudassist.user
      

   2. Lặp lại bước trước đó cho vai trò roles/recommender.viewer.

   Nếu người dùng chính muốn được hỗ trợ về các sản phẩm mà họ chưa có quyền truy cập, thì bạn có thể cần cấp cho họ các vai trò IAM bổ sung. Hãy xem bài viết Yêu cầu về IAM để sử dụng tính năng Trợ giúp trên đám mây của Gemini để biết bảng các vai trò IAM giúp bạn có trải nghiệm tối ưu với tính năng Trợ giúp trên đám mây của Gemini cho nhiều sản phẩm.

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

Các hướng dẫn này sử dụng cURL để gọi các phương thức API.

1. Bật Gemini Cloud Assist API bằng cách sử dụng phương thức services.enable:

   curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/geminicloudassist.googleapis.com:enable"
   

   Thay thế PROJECT_ID bằng mã của dự án mà bạn đang bật tính năng Hỗ trợ trên đám mây của Gemini.

   Nếu thành công, lệnh này sẽ trả về một long-running operation, bao gồm một trường name. Bạn có thể sử dụng giá trị trong trường name để kiểm tra trạng thái của thao tác.

2. Cấp vai trò IAM cho dự án Google Cloud được liên kết.

   1. Tạo một tệp JSON chứa những thông tin sau:

        {
          "options": {
            "requestedPolicyVersion": 3
          }
        }
      

   2. Truy xuất chính sách IAM hiện có cho dự án bằng cách sử dụng phương thức projects.getIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json" \
          "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:getIamPolicy"
      

      Thay thế nội dung sau:

      • JSON_FILE_NAME: đường dẫn đến tệp JSON mà bạn đã tạo ở bước trước.

      • PROJECT_ID: mã nhận dạng cho dự án.

      Nếu thành công, phản hồi sẽ trả về chính sách IAM của dự án.

   3. Sao chép chính sách IAM của dự án vào một tệp JSON trống và thêm thông tin sau vào nội dung hiện có:

        {
          "role": "roles/geminicloudassist.user",
          "members": [
            "PRINCIPAL"
          ]
        },
        {
          "role": "roles/recommender.viewer",
          "members": [
            "PRINCIPAL"
          ]
        }
      

      Thay thế PRINCIPAL bằng giá trị nhận dạng cho đối tượng chính mà bạn đang cấp quyền truy cập vào Gemini Cloud Assist.

   4. Áp dụng chính sách IAM đã cập nhật cho dự án bằng cách sử dụng phương thức projects.setIamPolicy:

        curl -X POST --data-binary @JSON_FILE_NAME \
          -H "Authorization: Bearer $(gcloud auth print-access-token)" \
          -H "Content-Type: application/json" \
          "https://cloudresourcemanager.googleapis.com/v1/projects/PROJECT_ID:setIamPolicy"
      

      Thay thế nội dung sau:

      • JSON_FILE_NAME: đường dẫn đến tệp JSON mà bạn đã tạo ở bước trước.

      • PROJECT_ID: mã nhận dạng cho dự án.

      Nếu thành công, phản hồi sẽ trả về chính sách IAM đã cập nhật của dự án.

   Nếu người dùng chính muốn được hỗ trợ về các sản phẩm mà họ chưa có quyền truy cập, thì bạn có thể cần cấp cho họ các vai trò IAM bổ sung. Hãy xem bài viết Yêu cầu về IAM để sử dụng tính năng Trợ giúp trên đám mây của Gemini để biết bảng các vai trò IAM giúp bạn có trải nghiệm tối ưu với tính năng Trợ giúp trên đám mây của Gemini cho nhiều sản phẩm.