Thiết lập Gemini Code Assist Standard và Enterprise

Trước khi bạn có thể sử dụng Gemini Code Assist Standard hoặc Enterprise, 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:

  1. Mua gói thuê bao Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp.

  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 Gemini for Google Cloud API 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 một 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 Tiêu chuẩn hoặc Doanh nghiệp trong một IDE. Người dùng Gemini CLI hoặc người dùng Gemini trong Android Studio không bắt buộc phải thực hiện bước này.

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 những khách hàng mới sử dụng Gemini Code Assist có tài khoản thanh toán chưa từng đăng ký Gemini Code Assist, chúng tôi sẽ tự động áp dụng khoản tín dụng tương đương tối đa 50 giấy phép miễn phí cho 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 phân bổ các khoản tín dụng miễn phí ban đầu. Ngoài ra, bạn không thể thay đổi phiên bản Gemini Code Assist trong tháng đầu tiên.

Nếu bạn có hợp đồng hiện tại 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. Chuyển đến trang Quản trị Gemini.

    Chuyển đến trang Quản trị viên cho Gemini

    Trang Quản trị viên cho Gemini sẽ mở ra.

  2. Chọn Nhận Gemini Code Assist.

    Xin lưu ý rằng nếu bạn không có quyền consumerprocurement.orders.place cần thiết, thì nút này sẽ bị tắt. Nếu đã có gói thuê bao Gemini Code Assist cho tài khoản thanh toán được liên kết với dự án, thì nút này sẽ hiển thị dưới dạng Quản lý Gemini Code Assist và cho phép bạn chỉnh sửa gói thuê bao.

    Trang Đăng ký gói thuê bao Gemini Code Assist sẽ mở ra.

  3. Trong phần Chọn phiên bản gói 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 Gemini Code Assist để 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 điền thông tin vào các trường để định cấu hình gói thuê bao, bao gồm cả những thông tin sau:

    • 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.
    • Kỳ hạn của gói thuê bao (hằng tháng hoặc hằng năm). Với gói thuê bao hằng năm, bạn sẽ được hưởng mức giá chiết khấu và trả phí hằng tháng thay vì thanh toán một lần.

  5. Để xác nhận đăng ký, 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 đăng ký.

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

Giờ đây, bạn có thể mua gói thuê bao Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp. Giờ đây, bạn cần quản lý việc chỉ định giấy phép Gemini trong tổ chức của mình.

Cấp giấy phép

Trước khi sử dụng Gemini Code Assist, bạn phải cấp giấy phép cho từng người dùng riêng lẻ cần được cấp quyền truy cập trong tổ chức.

Đối với những khách hàng mới sử dụng Gemini Code Assist có tài khoản thanh toán chưa từng đăng ký Gemini Code Assist, chúng tôi sẽ tự động áp dụng khoản tín dụng tương đương tối đa 50 giấy phép miễn phí cho 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 phân bổ các khoản tín dụng miễn phí ban đầu. Ngoài ra, bạn không thể thay đổi phiên bản Gemini Code Assist trong tháng đầu tiên.

Theo mặc định, các gói thuê bao mới yêu cầu bạn phải cấp giấy phép theo cách thủ công. Sau khi thiết lập, bạn có thể chọn cấp giấy phép theo cách thủ công hoặc tự động.

Giao diện dòng lệnh

Để chỉ định giấy phép Gemini cho từng người dùng trong Bảng điều khiển API, bạn phải có các quyền sau đối với tài khoản thanh toán:

  • billing.accounts.get
  • billing.accounts.list
  • consumerprocurement.orders.get
  • consumerprocurement.orders.list
  • consumerprocurement.orders.modify
  • consumerprocurement.orders.place
  • consumerprocurement.licensePools.enumerateLicensedUsers
  • consumerprocurement.licensePools.get
  • consumerprocurement.licensePools.update
  • consumerprocurement.licensePools.assign
  • consumerprocurement.licensePools.unassign

  1. Chuyển đến trang Quản trị Gemini.

    Chuyển đến Gemini cho Google Cloud

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

  3. Đối với tài khoản thanh toán này, hãy xác minh rằng bạn đã đặt Chỉ định giấy phép thành Chỉ định giấy phép theo cách thủ công. Nếu tài khoản thanh toán được đặt thành Tự động cấp giấy phép, thì bạn không thể quản lý từng giấy phép. Việc chuyển tài khoản thanh toán này sang chế độ Chỉ định giấy phép theo cách thủ công sẽ tắt chế độ tự động chỉ định giấy phép sau khi thay đổi, nhưng các chỉ định giấy phép hiện có sẽ không bị ảnh hưởng.

  4. 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 người dùng cụ thể, hãy nhập tên của họ vào hộp tìm kiếm.

  5. 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.

  6. Chọn các dịch vụ Gemini mà bạn muốn cấp giấy phép.

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

API

Để chỉ định giấy phép Gemini bằng API, hãy sử dụng phương thức billingAccounts.orders.licensePool.assign.

  1. Đảm bảo rằng bạn có quyền consumerprocurement.licensePools.assignQuản lý danh tính và quyền truy cập đối với tài khoản thanh toán có chứa nhóm giấy phép mà bạn dự định chỉ định giấy phép.

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

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Trong đó, USER_EMAILS là danh sách tài khoản người dùng được phân tách bằng dấu phẩy và được chỉ định giấy phép. Ví dụ: "dana@example.com", "lee@example.com".

  3. Sử dụng cURL để gọi phương thức:

    curl -X POST --data-binary @JSON_FILE_NAME \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "X-Goog-User-Project: PROJECT_ID" \
  -H "Content-Type: application/json" \
  "https://cloudcommerceconsumerprocurement.googleapis.com/v1/billingAccounts/BILLING_ACCOUNT_ID/orders/ORDER_ID/licensePool:assign/"

    Thay thế nội dung sau:

    • JSON_FILE_NAME: đường dẫn đến tệp JSON mà bạn đã tạo ở Bước 2.
    • PROJECT_ID: mã nhận dạng của một dự án. Mức sử dụng hạn mức và các khoản phí liên quan đến yêu cầu API sẽ được áp dụng cho dự án này.
    • BILLING_ACCOUNT_ID: mã nhận dạng của tài khoản thanh toán được liên kết với nhóm giấy phép.
    • ORDER_ID: mã đơn đặt hàng. Nếu không biết mã đơn đặt hàng, bạn có thể truy xuất mã này bằng cách liệt kê các đơn đặt hàng được liên kết với tài khoản thanh toán của bạn.

Nếu thành công, phản hồi sẽ tương tự như sau:

  {}

Giờ đây, bạn cần bật Gemini for Google Cloud API 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 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 Gemini cho Google Cloud API trong một dự án trên 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 Cloud.

Giao diện dòng lệnh

  1. Để bật Gemini cho Google Cloud API, hãy chuyển đến 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 này sẽ cập nhật và cho biết trạng thái Đã bật. Gemini hiện có trong dự án Cloud đã chọn cho tất cả người dùng có vai trò IAM bắt buộc.

gcloud

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

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

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

    gcloud services enable cloudaicompanion.googleapis.com

    Nếu bạn muốn bật Gemini cho Google Cloud API trong một dự án Cloud 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 Cloud của bạn.

    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 cung cấp trong dự án Cloud được chỉ định cho tất cả người dùng có các vai trò IAM bắt buộc.

Định cấu hình tường lửa cho lưu lượng truy cập API giữa IDE và Google

Ngoài việc bật Gemini cho Google Cloud, người dùng sử dụng tường lửa cũng cần cho phép lưu lượng truy cập đi qua các API sau:

  • oauth2.googleapis.com: được 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: điểm cuối chính của Gemini cho Google Cloud API.
  • 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 các IDE cho bộ chọn dự án. Bạn không cần dùng Resource Manager API 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à danh bạ.
  • firebaselogging-pa.googleapis.com: một API nội bộ dùng để gửi thông tin đo từ xa về sản phẩm, bao gồm cả các sự kiện về việc người dùng có chấp nhận đề xuất hay không.
  • feedback-pa.googleapis.com: một API nội bộ được dùng để gửi ý kiến phản hồi trong IDE.
  • apihub.googleapis.com: được dùng bởi tính năng Trình duyệt API Cloud Code.
  • lh3.googleusercontent.com và lh5.googleusercontent.com: dùng để lấy ảnh của người dùng.

Xác định địa chỉ IP cho các miền mặc định của Google Cloud

Để cho phép kết nối từ IDE đến các API của Google Cloud, tường lửa của bạn phải cho phép lưu lượng truy cập TCP đi ra đến dải địa chỉ IP được Google công khai ghi lại. Google quản lý các dải địa chỉ này một cách linh hoạt.

Để duy trì danh sách dải IP để truy cập vào các miền của Google Cloud, bạn có một số lựa chọn sau:

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

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

  • Gemini for Google Cloud API
  • Gemini Code Assist API

Nếu đang sử dụng Gemini Code Assist Standard hoặc Enterprise bên ngoài chu 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 bài viết Định cấu hình VPC Service Controls cho Gemini.

Cấp vai trò IAM trong một dự án trên Google Cloud

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

Giao diện dòng lệnh

  1. Để cấp các vai trò IAM cần thiết để sử dụng Gemini, hãy chuyển đến trang IAM & Admin (IAM và Quản trị viên).

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

  2. Trong cột Chủ thể, hãy tìm một chủ thể 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ủ thể 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 Gemini cho Google Cloud.

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

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

gcloud

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

  1. Trong trình đơn 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ế nội dung sau:

    • PROJECT_ID: mã dự án trên Đám mây của bạn,ví dụ: 1234567890.
    • PRINCIPAL: giá trị nhận dạng cho người dùng chính – ví dụ: user:cloudysanfrancisco@gmail.com.

    Đầu ra là danh sách các liên kết chính sách, bao gồm những thông tin sau:

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

  3. Lặp lại bước trước cho vai trò roles/serviceusage.serviceUsageConsumer.

Để biết thêm thông tin, hãy xem phần Cấp một vai trò duy nhất 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 API 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

Người dùng trong tổ chức của bạn cài đặt trình bổ trợ Gemini Code Assist trong IDE được hỗ trợ mà họ muốn dùng. Người dùng các IDE được hỗ trợ của JetBrains nên làm theo hướng dẫn về IntelliJ.

VS Code

  1. Để mở chế độ xem Tiện ích trong VS Code, hãy nhấp vào Biểu tượng tiện ích Tiện ích hoặc nhấn Ctrl/Cmd+Shift+X.

  2. Tìm kiếm Gemini Code Assist

  3. Nhấp vào Install (Cài đặt).

  4. Nếu được nhắc, hãy khởi động lại VS Code.

    Sau khi cài đặt thành công, Gemini Code Assist sẽ xuất hiện trong thanh hoạt động và sẵn sàng sử dụng. Bạn có thể định cấu hình thêm chế độ cài đặt Gemini Code Assist bằng cách chỉ định các lựa chọn ưu tiên của mình bằng thanh tác vụ ứng dụng cấp cao nhất: chuyển đến Code (Mã) > Settings (Cài đặt) > Settings (Cài đặt) > Extensions (Tiện ích) rồi tìm Gemini Code Assist.

IntelliJ

  1. Nhấp vào settings IDE và Cài đặt dự án > Trình bổ trợ.
  2. Trong thẻ Marketplace (Trang web thương mại), hãy tìm Gemini Code Assist.
  3. Nhấp vào Cài đặt để cài đặt trình bổ trợ.
  4. Khi quá trình cài đặt hoàn tất, hãy nhấp vào Restart IDE (Khởi động lại IDE).

  5. Khi IDE khởi động lại, Gemini Code Assist sẽ xuất hiện trong thanh hoạt động.

    Biểu tượng Gemini Code Assist xuất hiện trong thanh hoạt động.

Giờ đây, người dùng đã sẵn sàng sử dụng Gemini Code Assist Tiêu chuẩn hoặc Enterprise trong IDE của họ. Tìm hiểu thêm về các tính năng được hỗ trợ:

Hãy bắt đầu bằng các hướng dẫn sau:

Danh sách các thư mục nơi Gemini Code Assist lưu thông tin vào bộ nhớ đệm

Bảng sau đây cung cấp danh sách các thư mục nơi Gemini Code Assist lưu trữ thông tin về tiện ích, chẳng hạn như mã thông báo uỷ quyền:

Windows

  • %LOCALAPPDATA%/cloud-code
  • %LOCALAPPDATA%/google-vscode-extension

macOS

  • ~/Library/Application Support/cloud-code
  • ~/Library/Application Support/google-vscode-extension

Linux

  • ~/.cache/cloud-code
  • ~/.cache/google-vscode-extension

Đăng nhập vào Google rồi chọn một dự án trên Google Cloud

Sau khi cài đặt Gemini Code Assist trong IDE, người dùng cần đăng nhập vào Tài khoản Google của mình. Nếu đây là lần đầu tiên họ sử dụng Gemini Code Assist Standard hoặc Enterprise trong IDE, họ sẽ chọn một dự án Google Cloud.

VS Code

Nếu chọn một dự án Google Cloud chưa bật Gemini cho Google Cloud API, bạn sẽ nhận được một thông báo cho phép bạn bật API này trong IDE. Chọn Bật API trong cửa sổ thông báo để bật API cho dự án của bạn. Để biết thêm thông tin, hãy xem bài viết Thiết lập Gemini Code Assist Standard và Enterprise cho một dự án.

Nếu bạn muốn làm theo hướng dẫn Lập trình bằng Gemini Code Assist ngay trong IDE, hãy nhấp vào Chạy VS Code rồi làm theo các bước trong hướng dẫn để kết nối với Google Cloud và kích hoạt Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp.

Khởi chạy VS Code

Nếu không, hãy làm theo các bước sau:

  1. Khởi chạy IDE.

  2. Trong thanh hoạt động, hãy nhấp vào Gemini Code Assist.

  3. Trong ngăn trò chuyện Gemini Code Assist, hãy nhấp vào Đăng nhập vào Google Cloud.

  4. Khi được nhắc cho phép Gemini Code Assist mở trang web bên ngoài, hãy nhấp vào Open (Mở).

  5. Làm theo lời nhắc để đăng nhập vào Tài khoản Google của bạn.

  6. Khi được hỏi liệu bạn có tải Gemini Code Assist xuống từ Google hay không, hãy nhấp vào Đăng nhập.

    Bạn hiện đã kết nối với Google Cloud.

    Tiếp theo, để chọn một dự án trên Google Cloud đã bật Gemini cho Google Cloud API, hãy làm theo các bước sau:

  7. Trong thanh trạng thái Gemini Code Assist, hãy nhấp vào Gemini Code Assist.

    Thanh trạng thái của Gemini hiện đã hoạt động.

  8. Trong trình đơn Gemini Code Assist, hãy chọn Chọn dự án Gemini Code.

  9. Chọn một dự án trên Google Cloud đã bật Gemini cho Google Cloud API.

    Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp đã sẵn sàng để sử dụng.

    Biểu tượng Gemini trên thanh trạng thái được đặt ở chế độ bình thường.

IntelliJ

Để đăng nhập vào Tài khoản Google, hãy làm theo các bước sau:

  1. Trong thanh hoạt động, hãy nhấp vào spark Gemini Code Assist.

  2. Nhấp vào Đăng nhập vào Google.

  3. Trên trang mở ra trong trình duyệt web, hãy chọn Tài khoản Google của bạn.

  4. Trên màn hình yêu cầu bạn đảm bảo rằng bạn đã tải ứng dụng này xuống từ Google, hãy nhấp vào Đăng nhập.

    Gemini Code Assist hiện được phép truy cập vào tài khoản của bạn.

    Tiếp theo, nếu đây là lần đầu tiên bạn sử dụng Gemini Code Assist Standard hoặc Enterprise trong IDE, bạn phải chọn một dự án trên Google Cloud bằng cách làm theo các bước sau:

  5. Quay lại IDE. Trong cửa sổ công cụ Gemini Code Assist, nếu bạn đồng ý cho phép Google bật các API cần thiết để sử dụng Gemini Code Assist thay cho bạn cho dự án bạn đã chọn, hãy nhấp vào Chọn một dự án GCP để tiếp tục.

  6. Trong hộp thoại Select Google Cloud Project (Chọn dự án trên Google Cloud), hãy tìm và chọn dự án trên Google Cloud của bạn, rồi nhấp vào OK.

  7. Nhấp vào HOÀN TẤT.

Dự án Google Cloud của bạn được chọn và đã bật Gemini Code Assist API. Bạn đã sẵn sàng sử dụng Gemini Code Assist Standard hoặc Enterprise trong IDE của mình!

Các việc cần làm để thiết lập nâng cao

Thay vì sử dụng API Console hoặc gcloud để cấp các vai trò IAM được xác định trước, bạn có thể thực hiện một trong những thao tác sau:

  • Sử dụng API REST của IAM 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 Gemini Code Assist Standard và Enterprise:

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

  • Cấp 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ể chỉ định và quản lý giấy phép Gemini Code Assist:

    • 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 trong số các quyền nêu trên hoạt động, bạn cần bật Gemini cho Google Cloud API trong cùng một dự án trên Google Cloud mà bạn đã chỉ định từng quyền.

Bước tiếp theo