Thiết lập tính năng Gemini Code Assist (Standard và Enterprise)

Lưu ý: Đối với khách hàng mới của Gemini Code Assist có tài khoản thanh toán chưa từng đăng ký gói thuê bao Gemini Code Assist, chúng tôi sẽ tự động áp dụng khoản tín dụng tương đương với tối đa 50 giấy phép miễn phí trong tháng đầu tiên, bất kể phiên bản Gemini Code Assist. Ngoài ra, bạn có thể sử dụng Gemini Code Assist Enterprise với giá 19 USD/người dùng/tháng theo cam kết 12 tháng cho đến hết ngày 31 tháng 3 năm 2025. Hãy liên hệ với nhóm bán hàng của chúng tôi để tận dụng ưu đãi khuyến mãi này.

Trước khi có thể sử dụng tính năng Hỗ trợ mã Gemini, nhóm của bạn cần thực hiện các bước thiết lập được mô tả trong tài liệu này:

Lưu ý: Quản trị viên thường thực hiện các bước 1-4.

1. Mua gói thuê bao Gemini Code Assist.

2. Cấp giấy phép cho từng người dùng trong tổ chức của bạn.

3. Bật API Gemini cho Google Cloud trong một dự án Google Cloud.

4. Cấp vai trò Quản lý danh tính và quyền truy cập trong dự án trên Google Cloud.

5. Người dùng trong tổ chức của bạn cài đặt trình bổ trợ Gemini Code Assist để sử dụng Gemini Code Assist trong một IDE.

Mua gói thuê bao Gemini Code Assist

Để biết danh sách các tính năng có trong từng phiên bản, hãy xem phần Các tính năng được hỗ trợ.

Đối với khách hàng mới của Gemini Code Assist có tài khoản thanh toán chưa từng đăng ký gói thuê bao Gemini Code Assist, chúng tôi sẽ tự động áp dụng khoản tín dụng tương đương với tối đa 50 giấy phép miễn phí trong tháng đầu tiên, bất kể phiên bản Gemini Code Assist. Xin lưu ý rằng bạn không thể tăng số lượng tín dụng miễn phí sau khi các khoản tín dụng miễn phí cho giấy phép ban đầu được phân bổ. Ngoài ra, bạn không thể thay đổi phiên bản Gemini Code Assist trong tháng đầu tiên.

Gemini Code Assist Enterprise có giá 19 USD/người dùng/tháng theo cam kết 12 tháng cho đến hết ngày 31 tháng 3 năm 2025. Hãy liên hệ với nhóm bán hàng của chúng tôi để tận dụng ưu đãi khuyến mãi này.

Nếu bạn đang có hợp đồng với Google Cloud, hãy liên hệ với nhóm bán hàng của chúng tôi trước khi mua gói thuê bao.

1. Truy cập vào trang Gemini cho Google Cloud.

   Chuyển đến Gemini cho Google Cloud

   Trang Gemini cho Google Cloud sẽ mở ra.

2. Chọn Nhận Gemini Code Assist. Xin lưu ý rằng nếu tài khoản thanh toán của bạn chưa mua gói thuê bao Gemini Code Assist, thì một thông báo sẽ hiển thị cho biết Đủ điều kiện dùng thử 30 ngày cho tối đa 50 giấy phép mà không tốn phí. Nếu dự án của bạn đã có tính năng Gemini Code Assist, thì văn bản này sẽ hiển thị Quản lý Gemini Code Assist.

   Trang Mua gói thuê bao Gemini Code Assist sẽ mở ra.

3. Trong phần Chọn phiên bản thuê bao Gemini Code Assist, hãy chọn một phiên bản Gemini Code Assist. Chọn So sánh các phiên bản hỗ trợ mã Gemini để xem danh sách chi tiết về các tính năng có trong từng phiên bản.

   Sau đó, hãy chọn Tiếp tục.

4. Trong phần Định cấu hình gói thuê bao, hãy hoàn tất các trường để định cấu hình gói thuê bao, bao gồm:

   • Tên gói thuê bao.
   • Số lượng giấy phép trong gói thuê bao. Xin lưu ý rằng nếu mua phiên bản Enterprise, bạn phải mua ít nhất 10 giấy phép.
   • Thời hạn thuê bao (theo tháng hoặc theo năm). Khi đăng ký gói thuê bao hằng năm, bạn sẽ được tính phí theo mức chiết khấu hằng tháng thay vì thanh toán một lần.
   • Tự động gia hạn gói thuê bao sau khi thời hạn cam kết (hàng tháng hoặc hằng năm) kết thúc. Tính năng tự động gia hạn sẽ giúp gói thuê bao và giấy phép của bạn luôn hoạt động. Nếu không tự động gia hạn, gói thuê bao sẽ kết thúc khi thời hạn hiện tại kết thúc. Bạn cần thực hiện lại quy trình mua và chỉ định lại giấy phép.

5. Để xác nhận gói thuê bao, hãy chọn Tiếp tục.

6. Nếu bạn đồng ý với các điều khoản, hãy chọn Tôi đồng ý với các điều khoản của giao dịch mua này, sau đó chọn Xác nhận gói thuê bao.

7. Chọn Tiếp theo: Quản lý việc chỉ định giấy phép Gemini.

Giờ đây, bạn đã mua gói thuê bao cho Gemini Code Assist. Bây giờ, bạn cần quản lý việc chỉ định giấy phép Gemini trong tổ chức của mình.

Chỉ định giấy phép

Trước khi sử dụng tính năng Trợ giúp mã của Gemini, mỗi người dùng trong tổ chức của bạn cần có giấy phép.

Đối với khách hàng mới của Gemini Code Assist có tài khoản thanh toán chưa từng đăng ký gói thuê bao Gemini Code Assist, chúng tôi sẽ tự động áp dụng khoản tín dụng tương đương với tối đa 50 giấy phép miễn phí trong tháng đầu tiên, bất kể phiên bản Gemini Code Assist. Xin lưu ý rằng bạn không thể tăng số lượng tín dụng miễn phí sau khi các khoản tín dụng miễn phí cho giấy phép ban đầu được phân bổ. Ngoài ra, bạn không thể thay đổi phiên bản Gemini Code Assist trong tháng đầu tiên.

Giao diện dòng lệnh API

Để chỉ định giấy phép Gemini cho từng người dùng trong Google Cloud Console, bạn phải có các quyền sau:

• billing.accounts.get
• consumerprocurement.orders.get
• consumerprocurement.licensePools.get
• consumerprocurement.licensePools.enumerateLicensedUsers
• consumerprocurement.licensePools.assign

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

   Chuyển đến Gemini cho Google Cloud

2. Chọn gói thuê bao mà bạn muốn thay đổi, sau đó nhấp vào Sửa đổi gói thuê bao.

3. Nhấp vào Cấp giấy phép. Hộp thoại lựa chọn người dùng sẽ xuất hiện. Để tìm kiếm các người dùng cụ thể, hãy nhập tên của họ vào hộp tìm kiếm.

4. Chọn một hoặc nhiều người dùng trong danh sách, rồi nhấp vào Tiếp theo.

5. Chọn những dịch vụ Gemini mà bạn muốn chỉ định giấy phép.

6. Nhấp vào Cấp giấy phép.

Để chỉ định giấy phép Gemini bằng API, bạn phải có quyền consumerprocurement.licensePools.assign.

Phương thức HTTP: POST

URL: https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/

Thay thế nội dung sau:

• BILLING_ACCOUNT_ID: mã tài khoản thanh toán
• ORDER_ID: chính sách IAM

Nội dung yêu cầu:

    {
        "usernames": [
                  "[e-mail]",
                  "[e-mail]"
        ]
    }

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

{}

Nội dung phản hồi sẽ trống nếu bạn chỉ định giấy phép thành công.

Bây giờ, bạn cần bật API Gemini cho Google Cloud trong một hoặc nhiều dự án được liên kết với tài khoản thanh toán này. Người dùng sẽ không thấy tính năng Gemini Code Assist cho đến khi bạn kích hoạt tính năng này trong ít nhất một dự án.

Bật API Gemini cho Google Cloud trong một dự án trên Google Cloud

Phần này mô tả các bước cần thiết để bật Gemini cho API Google Cloud trong một dự án trên Google Cloud.

Giao diện dòng lệnh gcloud

1. Để bật API Gemini cho Google Cloud, hãy truy cập vào trang Gemini cho Google Cloud.

   Chuyển đến Gemini cho Google Cloud

2. Trong bộ chọn dự án, hãy chọn một dự án.

3. Nhấp vào Bật.

   Trang sẽ cập nhật và hiển thị trạng thái Đã bật. Gemini hiện đã có trong dự án trên Google Cloud mà bạn đã chọn cho tất cả người dùng có vai trò IAM bắt buộc.

Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi chạy CLI gcloud.

1. Trong trình đơn bộ chọn dự án, hãy chọn một dự án.

2. Bật Gemini cho API Google Cloud cho Gemini bằng cách sử dụng lệnh gcloud services enable:

   gcloud services enable cloudaicompanion.googleapis.com
   

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

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

   Thay PROJECT_ID bằng mã dự án trên Google Cloud.

   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.
   

Gemini cho Google Cloud hiện đã có trong dự án trên Google Cloud được chỉ định cho tất cả người dùng có vai trò IAM bắt buộc.

API bắt buộc đối với người dùng phía sau tường lửa

Ngoài việc bật Gemini cho Google Cloud, người dùng phía sau tường lửa cũng có thể cần bật các API sau:

• oauth2.googleapis.com: dùng để đăng nhập vào Google Cloud.
• serviceusage.googleapis.com: dùng để kiểm tra xem dự án Gemini Code Assist của người dùng có được định cấu hình đúng cách hay không.
• cloudaicompanion.googleapis.com: Gemini chính cho điểm cuối API Google Cloud.
• cloudcode-pa.googleapis.com: một API nội bộ cung cấp các tính năng liên quan đến IDE.
• cloudresourcemanager.googleapis.com: được dùng trong IDE cho bộ chọn dự án. Bạn có thể không cần API Trình quản lý tài nguyên nếu các dự án được định cấu hình rõ ràng trong tệp settings.json.
• people.googleapis.com: cung cấp quyền truy cập vào thông tin về hồ sơ và địa chỉ liên hệ.
• firebaselogging-pa.googleapis.com: một API nội bộ dùng để gửi dữ liệu đo từ xa của sản phẩm, bao gồm cả các sự kiện về việc liệu đề xuất có được chấp nhận hay không.
• feedback-pa.googleapis.com: một API nội bộ dùng để gửi phản hồi trong IDE.
• apihub.googleapis.com: được tính năng Trình duyệt API mã trên đám mây sử dụng.

Không bắt buộc: Định cấu hình VPC Service Controls

Nếu tổ chức của bạn có phạm vi dịch vụ, thì bạn phải thêm các tài nguyên sau vào phạm vi đó:

• Gemini cho API Google Cloud
• Gemini Code Assist API

Nếu đang sử dụng tính năng Hỗ trợ mã Gemini từ bên ngoài phạm vi dịch vụ, thì bạn cũng cần sửa đổi chính sách truy cập để cho phép truy cập vào các dịch vụ đó.

Để biết thêm thông tin, hãy xem phần Định cấu hình VPC Service Controls cho Gemini.

Cấp vai trò IAM trong dự án Google Cloud

Phần này mô tả các bước cần thiết để cấp cho người dùng vai trò Người dùng Gemini cho Google Cloud và Người dùng dịch vụ sử dụng IAM.

Giao diện dòng lệnh gcloud

1. Để cấp các vai trò IAM cần thiết để sử dụng Gemini, hãy chuyển đến trang IAM & Admin (Quản trị viên và 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, sau đó nhấp vào 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 Thêm vai trò khác.

4. Trong phần Chọn vai trò, hãy chọn Người dùng Google Cloud sử dụng Gemini.

5. Nhấp vào Thêm vai trò khác rồi chọn Người dùng sử dụng dịch vụ.

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

Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi chạy CLI gcloud.

1. Trong trình đơn bộ chọn dự án, hãy chọn một dự án.

2. Cấp vai trò Người dùng Gemini cho Google Cloud:

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

   Thay thế PRINCIPAL bằng giá trị nhận dạng cho đối tượng chính. Giá trị nhận dạng có dạng user|group|serviceAccount:email hoặc domain:domain, ví dụ: user:[e-mail], group:[e-mail], serviceAccount:[e-mail] hoặc domain:example.domain.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/cloudaicompanion.user
   

3. Cấp vai trò Người dùng sử dụng dịch vụ:

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

   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/serviceusage.serviceUsageConsumer
   

Để 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.

Tất cả người dùng đã được cấp các vai trò này đều có thể truy cập vào các tính năng của Gemini cho Google Cloud trong bảng điều khiển Google Cloud trong dự án đã chỉ định. Để biết thêm thông tin, hãy xem bài viết Tổng quan về Gemini cho Google Cloud.

Cài đặt trình bổ trợ Gemini Code Assist trong IDE

Người dùng trong tổ chức của bạn cài đặt tính năng Trợ lý mã Gemini trong IDE mà họ ưu tiên. Để biết thêm thông tin, hãy xem phần dưới đây:

• VS Code: Lập trình bằng tính năng Hỗ trợ mã Gemini
• IntelliJ và các IDE JetBrains khác: Mã bằng tính năng Hỗ trợ mã Gemini

Theo mặc định, Gemini Code Assist được đưa vào các IDE sau:

• Máy trạm trên đám mây: Lập trình bằng tính năng Hỗ trợ mã Gemini
• Trình soạn thảo Cloud Shell: Mã bằng tính năng Trợ giúp mã Gemini

Các nhiệm vụ thiết lập nâng cao

Thay vì sử dụng Google Cloud Console hoặc gcloud để cấp các vai trò IAM được xác định trước, bạn có thể làm bất kỳ việc nào sau đây:

• Sử dụng API IAM REST hoặc thư viện ứng dụng IAM để cấp vai trò.

  Nếu bạn sử dụng các giao diện này, hãy sử dụng tên vai trò đủ điều kiện:

  • roles/cloudaicompanion.user
  • roles/serviceusage.serviceUsageConsumer

  Để biết thêm thông tin về cách cấp vai trò, hãy xem bài viết Quản lý quyền truy cập vào dự án, thư mục và tổ chức.

• Tạo và cấp vai trò tuỳ chỉnh.

  Mọi vai trò tuỳ chỉnh mà bạn tạo đều cần có các quyền sau để bạn có thể truy cập vào tính năng Trợ giúp mã của Gemini:

  • cloudaicompanion.companions.generateChat
  • cloudaicompanion.companions.generateCode
  • cloudaicompanion.instances.completeCode
  • cloudaicompanion.instances.completeTask
  • cloudaicompanion.instances.generateCode
  • cloudaicompanion.instances.generateText
  • serviceusage.services.enable

• Chỉ định và quản lý giấy phép.

  Mọi vai trò tuỳ chỉnh mà bạn tạo đều cần có các quyền sau để bạn có thể truy cập vào tính năng Trợ giúp mã của Gemini:

  • consumerprocurement.orders.get
  • consumerprocurement.orders.licensePools..*
  • consumerprocurement.orders.licensePools.update
  • consumerprocurement.orders.licensePools.get
  • consumerprocurement.orders.licensePools.assign
  • consumerprocurement.orders.licensePools.unassign
  • consumerprocurement.orders.licensePools.enumerateLicensedUsers

Ngoài ra, xin lưu ý rằng để bất kỳ quyền nào ở trên hoạt động, bạn cần bật Gemini cho API Google Cloud trong chính dự án Google Cloud mà bạn đã chỉ định từng quyền.

Bước tiếp theo

• Tìm hiểu thêm về các loại trợ lý AI tạo sinh có trong Gemini cho Google Cloud.
• Tìm hiểu cách Gemini cho Google Cloud sử dụng dữ liệu của bạn.
• Tìm hiểu cách truy cập và quản lý các chế độ kiểm soát dành cho quản trị viên của tính năng Trợ giúp lập trình của Gemini.
• Tìm hiểu cách định cấu hình tuỳ chỉnh mã cho Gemini Code Assist Enterprise.
• Định cấu hình VPC Service Controls cho Gemini.