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

Trước khi bạn có thể sử dụng phiên bản Gemini Code Assist Tiêu chuẩn hoặc Phiên bản doanh nghiệp, 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 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 của tổ chức 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.

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 sử dụng 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.

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. Chuyển đến trang Quản trị viên của Gemini.

    Chuyển đến phần Quản trị cho Gemini

    Trang Quản trị 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 tài khoản thanh toán liên kết với dự án đã có gói thuê bao Gemini Code Assist, thì nút này sẽ hiển thị là Quản lý Gemini Code Assist và cho phép bạn chỉnh sửa gói thuê bao.

    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.

  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.

Gói thuê bao này hiện được mua cho Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp. 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 Gemini Code Assist, bạn phải chỉ định giấy phép cho từng người dùng cá nhân được cấp quyền truy cập trong tổ chức.

Đối với 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ý 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

Để 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 trên 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ị 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 một số 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.

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 Quản lý danh tính và quyền truy cập consumerprocurement.licensePools.assign trên tài khoản thanh toán 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 những thông tin sau:

    {
  "usernames": [
    USER_EMAILS
  ]
}

    Trong đó, USER_EMAILS là danh sách được phân tách bằng dấu phẩy gồm các tài khoản người dùng đang đượ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 cho 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 cho 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ã đó 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:

  {}

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

  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 đã 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 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 thế 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 Cloud được chỉ định cho tất cả người dùng 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 phía sau 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: 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 về 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.
  • 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

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

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

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 Gemini Code Assist Standard hoặc Enterprise 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

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

gcloud

Để 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ế nội dung sau:

    • PROJECT_ID: mã nhận dạng của dự án trên Google 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/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ò 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 của tổ chức cài đặt trình bổ trợ Gemini Code Assist trong IDE được hỗ trợ mà họ muốn

VS Code

  1. Để mở chế độ xem Extensions (Tiện ích) trong VS Code, hãy nhấp vào biểu tượng Biểu tượng tiện ích Extensions (Tiện ích) hoặc nhấn tổ hợp phím 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 tiện ích, 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 quá trình cài đặt Gemini Code Assist bằng cách chỉ định các tuỳ chọn ưu tiên 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 and Project Settings (IDE và Cài đặt dự án) > Plugins (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 Install (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 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 Gemini Code Assist 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 thư mục mà 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 mà Gemini Code Assist lưu trữ thông tin về tiện ích, chẳng hạn như mã thông báo xác thực:

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 và chọn một dự án trên Google Cloud

Sau khi cài đặt tính năng Trợ giúp mã Gemini trong IDE, người dùng cần đăng nhập vào Tài khoản Google của họ. Nếu đây là lần đầu tiên họ sử dụng tính năng Trợ giúp mã Gemini phiên bản 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 API Google Cloud, bạn sẽ nhận được thông báo cho phép bật API từ 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 phần Thiết lập Gemini Code Assist Tiêu chuẩn và Enterprise cho một dự án.

Nếu bạn muốn làm theo hướng dẫn Mã bằng Gemini Code Assist ngay trong IDE, hãy nhấp vào Launch VS Code (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 (Hỗ trợ mã Gemini).

  3. Trong ngăn trò chuyện Gemini Code Assist (Trợ giúp lập trình của Gemini), hãy nhấp vào Đăng nhập vào Google Cloud.

  4. Khi bạn được nhắc cho phép Gemini Code Assist mở trang web bên ngoài, hãy nhấp vào 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 đã tải Gemini Code Assist xuống từ Google hay chưa, 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 Google Cloud đã bật API Gemini cho Google Cloud, hãy làm theo các bước sau:

  7. Trong thanh trạng thái Gemini Code Assist (Trợ giúp lập trình Gemini), hãy nhấp vào Gemini Code Assist (Trợ giúp lập trình Gemini).

    Có thanh trạng thái Gemini.

  8. Trong trình đơn Gemini Code Assist (Hỗ trợ mã Gemini), hãy chọn Select Gemini Code Project (Chọn dự án Gemini Code).

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

    Bạn có thể sử dụng Gemini Code Assist Tiêu chuẩn hoặc Doanh nghiệp.

    Biểu tượng Gemini trong thanh trạng thái được đặt thành bình thường.

IntelliJ

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

  1. Trong thanh hoạt động, hãy nhấp vào biểu tượng spark Trợ giúp mã Gemini.

  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 cấp quyền 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 tính năng Hỗ trợ mã Gemini phiên bản Tiêu chuẩn hoặc Doanh nghiệp trong IDE, bạn phải chọn một dự á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 (Trợ lý mã Gemini), nếu bạn đồng ý cho phép Google thay mặt bạn bật các API cần thiết để sử dụng Gemini Code Assist cho dự án bạn đã chọn, hãy nhấp vào Select a GCP project (Chọn 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, sau đó nhấp vào OK.

  7. Nhấp vào FINISH (Hoàn tất).

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

Các nhiệm vụ 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ể 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 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 ở 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