Định cấu hình các kênh phát hành Gemini Code Assist

Tài liệu này mô tả cách định cấu hình các kênh phát hành Gemini Code Assist cho một dự án bằng cách sử dụng Bảng điều khiển API của Google hoặc một API.

Chúng tôi phát hành các tính năng của Gemini Code Assist trong nhiều kênh phát hành. Bạn có thể đặt từng dự án trên Google Cloud thành một kênh phát hành duy nhất, tuỳ thuộc vào sự cân bằng mà bạn chọn giữa tính ổn định và khả năng cung cấp tính năng. Những người dùng trong tổ chức của bạn sử dụng Gemini Code Assist trong IDE cục bộ có thể dùng các tính năng và mô hình dựa trên kênh phát hành được định cấu hình cho dự án.

Các kênh phát hành sau đây hiện có:

• Phát hành rộng rãi. Kênh phát hành mặc định. Cho phép bạn sử dụng các mô hình và tính năng thường có. Xin lưu ý rằng bạn có thể truy cập một số tính năng xem trước nhất định mà không cần chọn sử dụng kênh Xem trước, bằng cách sử dụng các cơ chế đăng ký Xem trước thay thế. Bạn có thể sử dụng các tính năng này trong kênh GA nhưng vẫn phải tuân theo Điều khoản về Sản phẩm trước giai đoạn phát hành rộng rãi.

• Xem trước. Cho phép bạn truy cập vào một số tính năng dùng thử của Gemini Code Assist và tuỳ ý cung cấp ý kiến phản hồi cũng như dữ liệu sử dụng để giúp Google cải thiện các bản phát hành trong tương lai. Xin lưu ý rằng hiện tại, không có tính năng riêng biệt nào trong kênh phát hành Preview.

  Khi bật kênh phát hành Xem trước cho một dự án, bạn thay mặt khách hàng đồng ý rằng tất cả hoạt động sử dụng Gemini Code Assist trong dự án đó đều phải tuân theo Điều khoản dành cho sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi của Điều khoản dành riêng cho dịch vụ của Google Cloud Platform. Đừng sử dụng kênh này cho những dự án và tài nguyên không phù hợp để sử dụng với các sản phẩm/dịch vụ ở giai đoạn trước khi phát hành rộng rãi.

Các phần sau đây trình bày các bước cần thiết để thiết lập hoặc thay đổi kênh phát hành Gemini Code Assist.

Trước khi bắt đầu

• Xác minh rằng dự án của bạn trên Google Cloud được liên kết với một tài khoản thanh toán. Để biết thêm thông tin, hãy xem bài viết Xác minh trạng thái thanh toán của dự án.

Vai trò bắt buộc

Để có các quyền cần thiết để tạo chế độ cài đặt và mối liên kết kiểm soát kênh phát hành, hãy yêu cầu quản trị viên cấp cho bạn vai trò Quản trị viên chế độ cài đặt Gemini cho Google Cloud (roles/cloudaicompanion.settingsAdmin) trên dự án.

Để xem chính xác các quyền bắt buộc, hãy mở rộng phần Các quyền bắt buộc:

Các quyền bắt buộc

• cloudaicompanion.releaseChannelSettings.create
• cloudaicompanion.releaseChannelSettings.delete
• cloudaicompanion.releaseChannelSettings.get
• cloudaicompanion.releaseChannelSettings.list
• cloudaicompanion.releaseChannelSettings.update
• cloudaicompanion.dataSharingWithGoogleSettings.create
• Định cấu hình kênh phát hành bằng API:
• cloudaicompanion.settingBindings.releaseChannelSettingsCreate
• cloudaicompanion.settingBindings.releaseChannelSettingsDelete
• cloudaicompanion.settingBindings.releaseChannelSettingsGet
• cloudaicompanion.settingBindings.releaseChannelSettingsList
• cloudaicompanion.settingBindings.releaseChannelSettingsUpdate
• cloudaicompanion.settingBindings.releaseChannelSettingsUse
• Định cấu hình tính năng chia sẻ câu lệnh và câu trả lời bằng API:
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsCreate
• cloudaicompanion.settingBindings.dataSharingWithGoogleSettingsUse
• Xem chế độ cài đặt của quản trị viên Gemini cho Google Cloud:
• cloudaicompanion.instances.queryEffectiveSetting
• cloudaicompanion.instances.queryEffectiveSettingBindings

Định cấu hình các kênh phát hành Gemini Code Assist

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

Giao diện dòng lệnh

1. Trong API Console, hãy chuyển đến trang Quản trị viên cho Gemini.

   Chuyển đến Gemini cho Google Cloud

   Trang Gemini cho Google Cloud sẽ tải.

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

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

3. Trong phần Kênh phát hành cho Gemini Code Assist trong các IDE cục bộ, hãy chọn kênh phát hành phù hợp nhất với nhu cầu của bạn:

   Xem trước

   1. Chọn Xem thử.
   2. Xem thông tin chi tiết về kênh phát hành Thử nghiệm sớm và các điều khoản của chương trình Kiểm thử viên tin cậy, sau đó nhấp vào Lưu thay đổi.

   Phát hành rộng rãi

   1. Chọn GA.
   2. Nhấp vào Lưu thay đổi.

API

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

   1. Lấy mã thông báo xác thực. Bạn phải được xác thực bằng tính năng xác thực gcloud để lấy khoá này:

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

   2. Tạo chế độ cài đặt. Các hướng dẫn này sử dụng cURL để gọi các phương thức API:

        curl -H "Authorization: Bearer $TOKEN" -H 'Content-Type: application/json' -d '{
            "release_channel": "RELEASE_CHANNEL",
          } ' -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings?release_channel_setting_id=RC_SETTING_ID"
      

      Thay thế nội dung sau:

      • RELEASE_CHANNEL: kênh phát hành, có thể là EXPERIMENTAL cho bản Xem trước hoặc STABLE cho bản Phát hành công khai.
      • CONTAINER_PROJECT_NAME: mã dự án của dự án nơi lưu trữ tài nguyên liên kết. Đây là dự án mẹ của liên kết.
      • RC_SETTING_ID: một tên chế độ cài đặt duy nhất, ví dụ: rc1 cho Release Channel.

      Kết quả cho thấy releaseChannel được đặt thành RELEASE_CHANNEL:

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/releaseChannelSettings/RC_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "releaseChannel": RELEASE_CHANNEL
      }
      

   3. Tạo mối liên kết chế độ cài đặt kênh phát hành:

        curl \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
            "target": "projects/TARGET_PROJECT_NAME",
            "product": "GEMINI_CODE_ASSIST"
          }' \
        -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings?setting_binding_id=RC_BINDING_ID"
      

      Thay thế nội dung sau:

      • TARGET_PROJECT_NAME: dự án đích mà liên kết sẽ được liên kết. Điều này thường giống với dự án vùng chứa. Tuy nhiên, bạn có thể liên kết một chế độ cài đặt với nhiều dự án để không phải sao chép tài nguyên chế độ cài đặt.
      • CONTAINER_PROJECT_NAME: mã dự án của dự án nơi lưu trữ tài nguyên liên kết. Đây là dự án mẹ của liên kết.
      • RC_SETTING_ID: chính là RC_SETTING_ID mà bạn đã dùng khi tạo chế độ cài đặt, nhưng được thêm b1 vào. Ví dụ: sử dụng rc1b1 cho Release Channel.
      • RC_BINDING_ID: tên duy nhất cho liên kết chế độ cài đặt – ví dụ: rc_binding.

      Đầu ra bao gồm siêu dữ liệu của thao tác ở định dạng sau:

      {
        "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID",
        "metadata": {
          "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
          "createTime": "2025-01-23T15:27:50.076075570Z",
          "target": "projects/TARGET_PROJECT_NAME/locations/global/releaseChannelSettings/RC_SETTING_ID/settingBindings/RC_BINDING_ID",
          "verb": "create",
          "requestedCancellation": false,
          "apiVersion": "v1"
        },
        "done": false
      }
      

   4. Không bắt buộc: Kiểm tra trạng thái của việc tạo chế độ liên kết chế độ cài đặt kênh phát hành:

      curl -H "Authorization: Bearer $TOKEN" \
      https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-RC_BINDING_OPERATION_ID
      

      Thay thế nội dung sau:

      • CONTAINER_PROJECT_NAME: mã dự án của dự án nơi lưu trữ tài nguyên liên kết. Đây là dự án mẹ của liên kết.
      • RC_BINDING_OPERATION_ID: mã thao tác tạo chế độ cài đặt kênh phát hành được cung cấp trong phản hồi ở bước trước.

2. Không bắt buộc: Tạo chế độ cài đặt chia sẻ câu lệnh và câu trả lời, đồng thời tạo một giá trị dành riêng cho chế độ cài đặt:

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

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

   2. Tạo chế độ cài đặt:

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

      Thay thế nội dung sau:

      • CONTAINER_PROJECT_NAME: mã dự án mẹ
      • DSWG_SETTING_ID: một tên chế độ cài đặt duy nhất – ví dụ: dswg1 cho Data Sharing with Google

      Kết quả cho thấy enablePreviewDataSharing được đặt thành true:

      {
        "name": "projects/CONTAINER_PROJECT_NAME
      /locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID",
        "createTime": "2025-01-23T15:22:49.717166932Z",
        "updateTime": "2025-01-23T15:22:49.717166932Z",
        "enablePreviewDataSharing": true
      }
      

   3. Tạo liên kết cài đặt câu lệnh và câu trả lời:

        curl \
        -H "Authorization: Bearer $TOKEN" \
        -H 'Content-Type: application/json' \
        -d '{
            "target": "projects/TARGET_PROJECT_NAME",
            "product": "GEMINI_CODE_ASSIST"
          }' \
        -X POST "https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings?setting_binding_id=DSWG_BINDING_ID"
      

      Thay thế nội dung sau:

      • TARGET_PROJECT_NAME: dự án đích mà bạn nên áp dụng chế độ cài đặt.
      • CONTAINER_PROJECT_NAME: mã dự án mẹ.
      • DSWG_SETTING_ID: chính là DSWG_SETTING_ID mà bạn đã dùng khi tạo chế độ cài đặt, nhưng được thêm b1 vào. Ví dụ: sử dụng dswg1b1 cho Data Sharing with Google.
      • DSWG_BINDING_ID: tên duy nhất cho liên kết chế độ cài đặt – ví dụ: dswg_binding.

      Đầu ra bao gồm siêu dữ liệu của thao tác ở định dạng sau:

      {
      "name": "projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID",
      "metadata": {
        "@type": "type.googleapis.com/google.cloud.cloudaicompanion.v1.OperationMetadata",
        "createTime": "2025-01-23T15:27:50.076075570Z",
        "target": "projects/TARGET_PROJECT_NAME/locations/global/dataSharingWithGoogleSettings/DSWG_SETTING_ID/settingBindings/DSWG_BINDING_ID",
        "verb": "create",
        "requestedCancellation": false,
        "apiVersion": "v1"
      },
      "done": false
      }
      

   4. Không bắt buộc: Kiểm tra trạng thái của việc tạo chế độ liên kết chế độ cài đặt câu lệnh và câu trả lời:

      curl -H "Authorization: Bearer $TOKEN" \
      https://cloudaicompanion.googleapis.com/v1/projects/CONTAINER_PROJECT_NAME/locations/global/operations/operation-DSWG_BINDING_OPERATION_ID
      

      Thay thế nội dung sau:

      • CONTAINER_PROJECT_NAME: mã dự án của dự án nơi lưu trữ tài nguyên liên kết. Đây là dự án mẹ của liên kết.
      • DSWG_BINDING_OPERATION_ID: mã thao tác tạo liên kết chế độ cài đặt lời nhắc và phản hồi được cung cấp trong phản hồi ở bước trước.